Esta guía cubre los comandos de la consola headless, gestión de mundos, roles de usuario, el NeosModLoader y resolución de problemas para tu servidor dedicado de NeosVR. NeosVR es un metaverso social de VR con potentes herramientas de creación. Para la configuración inicial, configuración de Config.json e instrucciones de conexión, consulta la Guía de Configuración del Servidor de NeosVR.
1. Acceder a la Consola
Gestiona tu servidor headless de NeosVR a través de la pestaña Console en GPanel. Todos los comandos se escriben directamente en la consola.
2. Comandos de la Consola Headless
Gestión de Mundos
| Comando | Descripción |
|---|---|
worlds | Listar todos los mundos en ejecución con sus índices. |
focus <world_index> | Cambiar el enfoque a un mundo específico por índice. |
startWorldURL <record_url> | Iniciar un nuevo mundo desde una URL de registro de Neos. |
startWorldTemplate <template> | Iniciar un mundo desde una plantilla integrada (ej. SpaceWorld). |
save | Guardar el mundo actualmente enfocado. |
close | Cerrar el mundo actualmente enfocado. |
restart | Reiniciar el mundo actualmente enfocado. |
Gestión de Sesiones
| Comando | Descripción |
|---|---|
sessionURL | Mostrar la URL de sesión del mundo enfocado. |
sessionID | Mostrar el ID de sesión del mundo enfocado. |
name <new_name> | Cambiar el nombre de sesión del mundo enfocado. |
accessLevel <level> | Cambiar el nivel de acceso: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Establecer el número máximo de usuarios para la sesión. |
hideFromListing <true/false> | Activar o desactivar la visibilidad en el navegador público de sesiones. |
description <text> | Establecer la descripción de la sesión. |
Gestión de Usuarios
| Comando | Descripción |
|---|---|
users | Listar todos los usuarios en el mundo enfocado. |
kick <username> | Expulsar a un usuario del mundo. |
ban <username> | Banear a un usuario del mundo. |
silence <username> | Silenciar a un usuario (mutar su voz). |
unsilence <username> | Quitar el silencio a un usuario previamente muteado. |
respawn <username> | Reaparecer a un usuario en el punto de aparición del mundo. |
role <username> <role> | Asignar un rol a un usuario (ver Sección 3). |
Control del Servidor
| Comando | Descripción |
|---|---|
status | Mostrar el estado del servidor y el uso de recursos. |
shutdown | Apagar el servidor headless de forma segura. |
gc | Forzar la recolección de basura para liberar memoria. |
tickRate <rate> | Cambiar la tasa de ticks del servidor en tiempo de ejecución. |
3. Roles de Usuario
NeosVR utiliza una jerarquía de roles para los permisos del mundo:
| Rol | Descripción |
|---|---|
Admin | Control total del mundo. Puede modificar cualquier cosa, gestionar usuarios y cambiar configuraciones del mundo. |
Builder | Puede crear y editar objetos en el mundo. |
Moderator | Puede expulsar/banear usuarios y gestionar configuraciones de sesión. |
Guest | Acceso básico. Puede interactuar con objetos existentes pero no puede construir. |
Spectator | Acceso de solo visualización. No puede interactuar con el mundo. |
Asigna roles a través de la consola: role <username> Admin
También puedes establecer roles predeterminados en Config.json usando la configuración defaultUserRoles.
4. NeosModLoader
NeosModLoader permite cargar mods creados por la comunidad en el servidor headless.
- Establece ENABLE_MODLOADER en
trueen las variables de Startup de GPanel. - Descarga mods desde el GitHub de NeosModLoader.
- Sube los archivos
.dllde los mods al directorionml_mods/vía SFTP. - Reinicia el servidor para cargar los mods.
5. Resolución de Problemas
El Servidor No Inicia
- Verifica que tu STEAM_USER y STEAM_PASS sean correctos.
- Asegúrate de que el SRCDS_BETAPASS (contraseña beta del headless) esté actualizado desde el Discord de Patreon de Neos.
- Si usas Steam Guard 2FA, proporciona el código en STEAM_AUTH y reinicia rápidamente.
El Mundo No Carga
- Verifica que
Config.jsonsea JSON válido (sin comas finales, corchetes correctos). - Verifica que
loginCredentialyloginPasswordestén configurados correctamente enConfig/Config.json. - Asegúrate de que la URL del mundo o el nombre del preset sea válido.
Los Usuarios No Pueden Unirse
- Verifica que el
accessLevelno esté configurado enPrivatea menos que sea intencional. - Verifica que no se haya alcanzado el
maxUsers. - Asegúrate de que el headless haya iniciado sesión (verifica la salida de la consola para la confirmación de inicio de sesión).
Artículos Relacionados
- Guía de Configuración del Servidor de NeosVR
- Cómo Encontrar la IP y el Puerto de tu Servidor
- Cómo Subir Archivos vía SFTP
¿Necesitas Ayuda?
Si encuentras problemas con tu servidor de NeosVR que no están cubiertos aquí, abre un ticket de soporte e incluye la IP de tu servidor, una descripción del problema y cualquier mensaje de error relevante de la consola de GPanel.
