Esta guía cubre cómo configurar tu servidor headless de Resonite alojado con Legion Hosting. Resonite es una plataforma social de VR donde los usuarios pueden construir, crear y socializar en mundos generados por usuarios. Para la gestión de sesiones y comandos de administración, consulta Guía de administración del servidor de Resonite.
1. Acceder a tu servidor
- Inicia sesión en GPanel.
- Selecciona tu servidor de Resonite de la lista de servidores.
- Tu servidor se gestiona a través de la pestaña Console en GPanel y la configuración del headless de Resonite.
Nota: Los puertos se asignan aleatoriamente a menos que tengas una IP privada. Los servidores headless de Resonite utilizan principalmente un archivo de configuración JSON y el navegador de sesiones para las conexiones, pero el puerto asignado se sigue utilizando para la comunicación de red.
2. Variables de inicio
Configura estos ajustes desde la pestaña Startup en GPanel:
| Variable | Nombre de entorno | Predeterminado | Descripción |
|---|---|---|---|
| Habilitar cargador de mods | ENABLE_MODLOADER |
false | Habilitar ResoniteModLoader para mods personalizados (true/false). |
| Actualización automática | AUTO_UPDATE |
1 | Actualizar automáticamente el servidor al iniciar (1=sí, 0=no). |
Importante: El headless de Resonite requiere una suscripción a Patreon con acceso headless. Se requiere una contraseña beta (obtenida enviando un mensaje al bot de Resonite en el juego con
/headlessCode) para la instalación. Esto es configurado por el proveedor de hosting.
3. Archivo de configuración
El archivo de configuración principal es Headless/Config/Config.json. Edítalo a través de SFTP. Ajustes principales:
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. Referencia de ajustes de Config.json
| Ajuste | Predeterminado | Descripción |
|---|---|---|
tickRate | 60.0 | Tasa de tick de simulación del servidor. |
maxConcurrentAssetTransfers | 4 | Máximo de descargas simultáneas de assets. |
loginCredential | (vacío) | Nombre de usuario de la cuenta de Resonite para el headless. |
loginPassword | (vacío) | Contraseña de la cuenta de Resonite. |
5. Configuración de mundos
Cada entrada en el array startWorlds define una sesión de mundo. Ajustes principales del mundo:
| Ajuste | Predeterminado | Descripción |
|---|---|---|
isEnabled | true | Si este mundo debe iniciarse. |
sessionName | null | Nombre visible de la sesión. |
maxUsers | 32 | Máximo de usuarios en el mundo. |
accessLevel | Anyone | Quién puede unirse: Anyone, RegisteredUsers, Contacts, ContactsPlus, Private. |
loadWorldPresetName | SpaceWorld | Mundo predefinido a cargar (ej. SpaceWorld, Grid, BasicEmpty). |
loadWorldURL | null | URL de un mundo personalizado para cargar en lugar de un predefinido. |
autoRecover | true | Recuperar automáticamente el mundo después de un fallo. |
autoSleep | true | Poner el mundo en suspensión cuando no haya usuarios presentes. |
saveOnExit | false | Guardar el estado del mundo cuando el servidor se apague. |
autosaveInterval | -1.0 | Intervalo de autoguardado en segundos (-1 = deshabilitado). |
hideFromPublicListing | null | Ocultar esta sesión de la lista pública. |
awayKickMinutes | -1.0 | Minutos antes de expulsar a usuarios inactivos (-1 = deshabilitado). |
idleRestartInterval | -1.0 | Reiniciar el mundo después de esta cantidad de segundos vacío (-1 = deshabilitado). |
forcedRestartInterval | -1.0 | Forzar reinicio después de esta cantidad de segundos sin importar los usuarios (-1 = deshabilitado). |
6. Conectarse a tu servidor
- Inicia Resonite en tu PC o visor de VR.
- Abre el Navegador de sesiones (Dash Menu > Worlds).
- Busca tu servidor por el nombre de sesión.
- Haz clic en Join para entrar al mundo.
Para sesiones privadas, la cuenta headless debe invitar a los usuarios o usar autoInviteUsernames en la configuración.
7. Lista de verificación de primera configuración
- Edita
Headless/Config/Config.jsonpara establecerloginCredentialyloginPasswordde tu cuenta de Resonite. - Establece un
sessionNamepara tu mundo. - Elige un
loadWorldPresetNameo proporciona unloadWorldURLpara un mundo personalizado. - Establece el
accessLevelpara controlar quién puede unirse. - Inicia el servidor y verifica que muestre
World running...en la consola.
Artículos relacionados
- Guía de administración del servidor 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 tienes problemas con tu servidor de Resonite, abre un ticket de soporte e incluye los detalles de tu servidor, una descripción del problema y cualquier mensaje de error de la consola de GPanel.
