Esta guía cubre los comandos de consola del headless, la gestión de sesiones, la configuración del cargador de mods y la resolución de problemas para tu servidor de Resonite. Para la configuración inicial, consulta Guía de configuración del servidor headless de Resonite.
1. Comandos de consola del headless
El servidor headless de Resonite acepta comandos a través de la consola de GPanel. El servidor responde al comando shutdown para un apagado controlado.
| Comando | Descripción |
|---|---|
worlds |
Listar todas las sesiones de mundo activas. |
focus <world_index> |
Enfocar un mundo específico para ejecutar comandos. |
status |
Mostrar el estado del mundo enfocado. |
users |
Listar usuarios en el mundo enfocado. |
kick <username> |
Expulsar a un usuario del mundo enfocado. |
ban <username> |
Prohibir a un usuario del mundo enfocado. |
silence <username> |
Silenciar a un usuario en el mundo enfocado. |
unsilence <username> |
Quitar el silencio a un usuario. |
respawn <username> |
Reaparecer a un usuario en el origen del mundo. |
role <username> <role> |
Establecer el rol de un usuario (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Renombrar la sesión enfocada. |
accessLevel <level> |
Cambiar quién puede unirse (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Cambiar el número máximo de usuarios del mundo enfocado. |
save |
Guardar el mundo enfocado. |
close |
Cerrar el mundo enfocado. |
restart |
Reiniciar el mundo enfocado. |
invite <username> |
Invitar a un usuario al mundo enfocado. |
message <text> |
Enviar un mensaje al mundo enfocado. |
shutdown |
Apagar controladamente todo el servidor headless. |
2. Niveles de acceso
Controla quién puede unirse a tus sesiones de mundo con el ajuste accessLevel:
| Nivel | Descripción |
|---|---|
| Anyone | Abierto a todos los usuarios de Resonite. |
| RegisteredUsers | Solo cuentas registradas de Resonite. |
| Contacts | Solo usuarios en la lista de contactos de la cuenta headless. |
| ContactsPlus | Contactos y contactos de contactos. |
| Private | Solo por invitación. |
3. Roles de usuario
Asigna roles para controlar lo que los usuarios pueden hacer en tu mundo:
| Rol | Descripción |
|---|---|
| Admin | Control total sobre el mundo. |
| Builder | Puede construir y modificar objetos. |
| Moderator | Puede expulsar/prohibir usuarios y moderar el chat. |
| Guest | Acceso estándar de usuario. |
| Spectator | Puede observar pero no interactuar. |
Establece roles predeterminados en Config.json usando defaultUserRoles o asígnalos por usuario con el comando de consola role.
4. Múltiples mundos
El servidor headless puede alojar múltiples mundos simultáneamente. Añade entradas adicionales al array startWorlds en Headless/Config/Config.json:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]Usa focus 0 y focus 1 en la consola para cambiar entre mundos.
5. Cargador de mods
Resonite soporta mods a través de ResoniteModLoader. Para habilitarlo:
- Establece
ENABLE_MODLOADERentrueen la pestaña Startup. - Reinstala o reinicia el servidor -- los DLLs del cargador de mods se descargarán automáticamente.
- Coloca los DLLs de mods en el directorio
rml_mods/a través de SFTP. - Reinicia el servidor para cargar los mods.
Archivos del cargador de mods:
Libraries/ResoniteModLoader.dll-- El cargador de mods principal.rml_libs/0Harmony.dll-- Dependencia requerida.rml_mods/-- Coloca tus DLLs de mods aquí.
6. Resolución de problemas
- El servidor no inicia: Verifica que las credenciales de inicio de sesión en
Config.jsonsean correctas. El headless debe autenticarse con una cuenta válida de Resonite. - El mundo no aparece en el navegador: Verifica que
hideFromPublicListingno esté establecido entrue. Asegúrate de que elaccessLevelpermita a los usuarios que buscan. - "World running..." no aparece: Revisa los errores en la consola. El nombre del mundo predefinido puede ser incorrecto.
- Los mods no cargan: Verifica que
ENABLE_MODLOADERseatruey que los DLLs de mods estén enrml_mods/. Revisa la consola para errores del cargador de mods. - Alto uso de recursos: Reduce
tickRateenConfig.jsono disminuyemaxConcurrentAssetTransfers. El contenido complejo creado por usuarios puede consumir muchos recursos.
Artículos relacionados
- Guía de configuración del servidor headless de Resonite
- Cómo encontrar la IP y el puerto de tu servidor
- Cómo subir archivos a través de SFTP
¿Necesitas ayuda?
Si necesitas más asistencia, abre un ticket de soporte con los detalles de tu servidor y cualquier mensaje de error de la consola de GPanel.
