Esta guía cubre la configuración de administrador, comandos de administrador dentro del juego, configuración de RCON y comandos de gestión del servidor para tu servidor dedicado de Soulmask en Legion Hosting. Para la configuración del servidor, consulta la Guía de Configuración del Servidor de Soulmask.
Configuración de Privilegios de Administrador
Soulmask utiliza un sistema de administrador basado en contraseña. Para convertirte en administrador, necesitas establecer una contraseña de administrador en la configuración de inicio del servidor y luego autenticarte dentro del juego.
Paso 1: Establecer la Contraseña de Administrador
- En GPanel, selecciona tu servidor de Soulmask.
- Haz clic en la pestaña Startup.
- Establece la variable
ADMIN_PASSWORDcon una contraseña fuerte y única. Esto corresponde al parámetro de línea de comandos-adminpsw. - Reinicia el servidor para que el cambio surta efecto.
Paso 2: Autenticarse Dentro del Juego
- Únete a tu servidor de Soulmask como jugador.
- Abre la consola del juego presionando la tecla ` (acento grave/tilde) o Numpad - (menos del teclado numérico).
- Escribe el siguiente comando y presiona Enter:
gm key YOUR_ADMIN_PASSWORD - Si la contraseña es correcta, verás un mensaje de confirmación y obtendrás privilegios de administrador GM (Game Master).
- También puedes hacer clic en el botón "Become the admin" que aparece en la interfaz del panel GM.
gm key cada vez que inicies sesión.
Comandos de Administrador Dentro del Juego
Una vez autenticado como administrador, abre la consola (` o Numpad -) e ingresa los comandos. Todos los comandos de administrador comienzan con el prefijo gm.
Gestión de Jugadores
| Comando | Descripción |
|---|---|
gm AddExp [value] |
Añadir puntos de experiencia general a tu personaje. |
gm Addmjexp [value] |
Añadir experiencia de máscara a tu personaje (sube de nivel la máscara). |
gm Addshoulieexp [value] |
Añadir experiencia de caza a tu personaje. |
gm XiDian |
Restablecer todos los puntos de habilidad de tu personaje, permitiendo redistribuirlos. |
gm FuHuo |
Revivir tu personaje (usar cuando estés muerto). |
gm ZiSha 1 |
Matar a tu propio personaje (comando de suicidio). |
gm shanhao |
Eliminar tu cuenta/personaje del servidor. Usar con extrema precaución -- esto es irreversible. |
gm ShowInfo 1 |
Mostrar información detallada sobre tu propio personaje (estadísticas, IDs, posición). |
gm ShowInfo 0 |
Mostrar información detallada sobre el personaje o NPC actualmente seleccionado. |
gm ChongZhiRenWu |
Restablecer todos los tutoriales y misiones guía de tu personaje. |
Navegación y Visibilidad
| Comando | Descripción |
|---|---|
gm Go [x] [y] [z] |
Teletransportarse a coordenadas específicas del mundo. Usa GPS para encontrar tus coordenadas actuales primero. |
GPS |
Mostrar tus coordenadas actuales del mundo (X, Y, Z). Útil para objetivos de teletransportación. |
gm SetAttr YinShen 1 |
Activar invisibilidad. Los monstruos y NPCs no pueden detectarte. |
gm SetAttr YinShen 0 |
Desactivar invisibilidad. Volver a la visibilidad normal. |
gm ShowMap |
Revelar el mapa completo, desbloqueando toda la niebla de guerra para tu personaje. |
Control de NPCs y del Mundo
| Comando | Descripción |
|---|---|
gm ZhaoMu |
Reclutar instantáneamente al NPC seleccionado a tu tribu. |
gm ClearAllNpc |
Eliminar todos los NPCs no jugadores del servidor. Usar con precaución -- afecta a todos los NPCs en todo el servidor. |
gm ClearSelect |
Eliminar la entidad actualmente seleccionada (NPC, criatura u objeto). |
gm ShuaXinZhiBei |
Refrescar y regenerar toda la vegetación y plantas recolectables cercanas. |
gm KeJiShu |
Desbloquear todos los nodos del árbol de tecnología para tu personaje. |
Gestión de Invasiones y Calor
| Comando | Descripción |
|---|---|
gm ShowReDu |
Mostrar el gráfico actual de calor de invasión, mostrando los niveles de amenaza en diferentes áreas. |
gm ClearAllReDu |
Limpiar todo el calor de invasión en el mapa, restableciendo los niveles de amenaza a cero. |
gm AddReDu [value] |
Aumentar manualmente el calor de invasión en la cantidad especificada. Un calor más alto atrae más invasiones. |
Servidor y Depuración
| Comando | Descripción |
|---|---|
gm exit |
Apagar el servidor de forma segura con guardado. Esta es la forma más segura de detener el servidor desde dentro del juego. |
Debuginfo 1 |
Activar la superposición de monitoreo de rendimiento del servidor, mostrando la tasa de ticks, conteo de entidades y uso de recursos. |
Debuginfo 0 |
Desactivar la superposición de monitoreo de rendimiento del servidor. |
Comandos de Gestión del Servidor
Estos comandos se usan para la gestión a nivel de servidor y pueden ejecutarse tanto dentro del juego (mediante consola) como de forma remota (mediante RCON/Telnet).
Control del Servidor
| Comando | Descripción |
|---|---|
SaveWorld |
Forzar un guardado inmediato del mundo en memoria (y opcionalmente en disco). Usar antes de realizar operaciones arriesgadas. |
SaveAndExit [seconds] |
Guardar el mundo y apagar el servidor después del número especificado de segundos. Los jugadores reciben una cuenta regresiva de advertencia. |
StopCloseServer |
Cancelar un apagado pendiente que fue iniciado con SaveAndExit. |
shutdown [seconds] |
Iniciar un apagado seguro del servidor con la cuenta regresiva especificada en segundos. |
broadcast [message] |
Enviar un mensaje global a todos los jugadores conectados. Útil para anuncios y advertencias. |
Administración de Jugadores (Remota)
| Comando | Descripción |
|---|---|
List_AllPlayers |
Listar todas las cuentas de jugadores registradas en el servidor (en línea y fuera de línea). |
List_OnlinePlayers |
Listar todos los jugadores actualmente conectados con sus Steam IDs y nombres de personaje. |
List_Guilds |
Listar todas las tribus (gremios) en el servidor con el conteo de miembros. |
kick [PlayerName] |
Expulsar a un jugador del servidor por nombre de personaje. |
ban [PlayerName] |
Banear a un jugador del servidor. No podrá volver a conectarse. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Añadir objetos directamente al inventario de un jugador específico por Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teletransportar a un jugador específico a coordenadas del mundo. |
FlyMode [SteamID] [0/1] |
Activar (1) o desactivar (0) el modo fantasma/vuelo para un jugador. |
Información del Servidor
| Comando | Descripción |
|---|---|
ServerFPS |
Mostrar la tasa de ticks actual del servidor (FPS). Los servidores saludables deben mantener 30+ FPS. |
Show_Coefficient_Settings |
Listar todos los ajustes actuales de coeficientes de juego de GameXishu.json. |
Set_Coefficient [key] [value] |
Modificar un coeficiente de juego en tiempo de ejecución sin editar archivos. Los cambios surten efecto inmediatamente. |
List_AllTalent [level] |
Ver todos los dones naturales (talentos) disponibles en el nivel especificado. |
Depuración y Avanzado
| Comando | Descripción |
|---|---|
Dump_AllActorPositions |
Exportar todas las posiciones de actores a un archivo de datos para depurar el estado del mundo. |
DrawActorImage |
Generar una visualización de las posiciones de actores en el mapa. |
ExecScriptCommands [filename] |
Ejecutar un archivo por lotes de comandos. Útil para ejecutar múltiples comandos a la vez. |
Acceso RCON
RCON (Consola Remota) te permite ejecutar comandos del servidor de forma remota sin estar conectado al juego. Soulmask soporta tanto RCON como Telnet para administración remota.
Habilitar RCON
RCON está deshabilitado por defecto y debe habilitarse mediante parámetros de inicio:
- En GPanel, ve a la pestaña Startup.
- Añade los siguientes parámetros (a través de parámetros de inicio adicionales o contactando al soporte para que los añadan):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Reinicia el servidor.
Conectarse mediante RCON
Una vez habilitado RCON, puedes conectarte usando cualquier cliente RCON estándar:
- Descarga un cliente RCON como rcon-cli o una herramienta con interfaz gráfica como mcrcon.
- Conéctate a tu servidor usando:
- Host: La dirección IP de tu servidor
- Port: El puerto RCON (por defecto
19000) - Password: La contraseña RCON que estableciste con
-rconpsw
- Una vez conectado, escribe
helppara ver una lista de comandos disponibles.
Acceso Telnet
Soulmask también soporta administración basada en Telnet en el Echo Port (por defecto 18888). Telnet está restringido solo a conexiones locales por defecto y no requiere redirección de puertos adicional. Esto se usa principalmente para administración por scripts en la propia máquina del servidor.
Ejemplo de Sesión RCON
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServer
Apagado Correcto del Servidor
Hay varios métodos seguros para apagar un servidor de Soulmask. Siempre usa uno de estos para prevenir la pérdida de datos:
- Botón Stop de GPanel: El método más sencillo. Haz clic en Stop en la pestaña Console de GPanel.
- Comando dentro del juego: Autentícate como administrador y ejecuta
gm exitpara guardar y apagar. - RCON/Telnet: Ejecuta
shutdown [seconds]oSaveAndExit [seconds]para un apagado con cuenta regresiva que da tiempo a los jugadores para prepararse.
Consejos para Administradores de Servidor
- Configura copias de seguridad automáticas. Usa
-initbackupy-backupinterval=30para crear instantáneas de respaldo regulares. - Monitorea los FPS del servidor. Usa el comando
ServerFPSregularmente. Si la tasa de ticks cae por debajo de 15-20 FPS, el servidor está teniendo dificultades y puede necesitar optimización o un reinicio. - Usa
Set_Coefficientpara ajustes en vivo. Puedes ajustar la configuración del juego en tiempo de ejecución sin reiniciar el servidor. EjecutaShow_Coefficient_Settingsprimero para ver los valores actuales. - Programa reinicios regulares. Reinicia el servidor diariamente para limpiar fugas de memoria y aplicar cualquier actualización pendiente.
- Anuncia antes del mantenimiento. Siempre usa el comando
broadcastpara avisar a los jugadores antes de reinicios o ventanas de mantenimiento del servidor. - Usa
SaveWorldantes de operaciones arriesgadas. Fuerza un guardado antes de realizar cambios significativos como limpiar NPCs o modificar coeficientes.
Artículos Relacionados
- Guía de Configuración del Servidor de Soulmask
- Cómo Encontrar la IP y el Puerto de tu Servidor
- Cómo Subir Archivos mediante SFTP
- Primeros Pasos con tu Nuevo Servidor
¿Necesitas Ayuda?
Si necesitas más asistencia con los comandos de administrador de Soulmask o la gestión del servidor, por favor abre un ticket de soporte y nuestro equipo estará encantado de ayudarte.