Gestión de servidores
El flujo de trabajo diario para operar servidores de juego con Saba-chan: desde añadir, iniciar y supervisar servidores hasta copias de seguridad, programaciones, invitar a tus amigos e integrar Discord.
Gestión de servidores
Este documento explica cómo usar Saba-chan desde el punto de vista del usuario. Aunque no toques el código de los módulos ni escribas tus propias extensiones, esta página basta para mantener uno o dos servidores de juego para tus amigos.
La instalación se explica en Primeros pasos y el emparejamiento del bot en Bot de Discord y retransmisión en la nube. Aquí damos por hecho que ya has terminado la instalación y nos centramos en qué pulsar y qué mirar mientras la GUI está abierta.
1. Visión general: la GUI es un mando a distancia, el demonio ejecuta los servidores
Ten esto presente primero: cerrar la ventana de la GUI no apaga tus servidores de juego.
saba-chan-gui(ventana): el mando a distancia que envía comandos al demonio y dibuja la pantalla. La CLI (saba-chan-cli) cumple la misma función.saba-core(demonio): el proceso central que se ejecuta en segundo plano, lanzando y supervisando los servidores de juego. La ejecución de los servidores, las copias de seguridad, las tareas programadas y la conexión con Discord las gestiona el demonio.- Procesos de los servidores de juego: los servidores reales que lanza el demonio (
java,PalServer.exe, etc.).
Así que tu rutina diaria es más o menos esta:
- Abre la GUI y el demonio se inicia con ella (si ya está en marcha, la GUI se conecta a él).
- Cuando tus amigos estén a punto de conectarse, pulsa Iniciar en la pantalla del servidor.
- Mientras jugáis, puedes minimizar o cerrar la ventana. Al cerrarla, eliges entre Solo cerrar interfaz (el demonio sigue en marcha) y Salir Todo (el demonio también se detiene). Para mantener los servidores en marcha, elige Solo cerrar interfaz.
- Cuando terminéis, vuelve a abrir la GUI y pulsa Detener.
Apagar el PC también apaga tus servidores de juego. El demonio solo se ejecuta en tu propio PC. Si quieres disponibilidad 24/7, usa un alojamiento dedicado.
2. Crear tu primer servidor (resumen rápido)
Consulta Primeros pasos para el recorrido completo. En resumen:
- En la pantalla Servidores, haz clic en Añadir servidor.
- Elige Agregar como nuevo servidor. Si ya tienes una carpeta de servidor, Migración de servidor existente la vincula en su lugar (los archivos se quedan donde están).
- Elige un juego (Minecraft / Palworld / Project Zomboid / Terraria, etc.) y define el nombre del servidor y un preajuste recomendado.
- Si el juego tiene condiciones que aceptar, las aceptas aquí. Por ejemplo, Minecraft exige aceptar el EULA de Minecraft antes de que el servidor pueda arrancar (§3.7).
- Haz clic en Agregar Servidor. Los archivos del servidor se descargan automáticamente y el progreso se muestra en la pantalla del servidor.
- Cuando termina la instalación, el servidor aparece en la lista.
Puedes ponerle a tu servidor el nombre que quieras: «Minecraft con amigos», «Zomboid de fin de semana», etc. En los comandos de Discord puedes referirte a un servidor por su nombre o por el nombre de su juego (alias). Puedes renombrar un servidor detenido con el botón del lápiz junto a su nombre.
3. Flujo de trabajo diario
Al seleccionar un servidor se abre su pantalla a la derecha. Arriba están el botón Iniciar/Detener y el estado; debajo, las pestañas. Las pestañas que aparecen dependen del juego.
| Pestaña | Contenido |
|---|---|
| Consola | Salida del servidor y entrada de comandos (solo en juegos con consola) |
| Comandos | Los comandos que define el juego (p. ej., anuncios y lista de jugadores de Palworld) |
| Ajustes | Ajustes del juego (puerto, máximo de jugadores, contraseña, etc.) |
| Saba-chan | Ajustes con los que Saba-chan maneja el servidor: reinicio automático, límite de memoria, tiempo de espera de parada, vista previa de argumentos de inicio, reenvío del chat del juego |
| Copias | Crear y restaurar copias de seguridad, tareas programadas |
| Discord | Las palabras con que se llama a este servidor y sus comandos desde Discord |
| Registro | Quién inició, detuvo o envió comandos, y cuándo |
| Info | Puerto, versión, tiempo en marcha, salidas recientes, revisión del servidor, abrir la carpeta del servidor, eliminar el servidor |
3.1 Iniciar / Detener / Reiniciar
- Iniciar: el demonio comprueba primero la aceptación de las condiciones y ejecuta las comprobaciones del módulo, y luego lanza el servidor. Si la comprobación detecta un problema crítico, el servidor no se inicia y se muestra el motivo.
- Detener: envía el comando de parada ordenada del juego (p. ej.,
stopen Minecraft,quiten Zomboid) y espera. Si el servidor no ha terminado en 30 segundos por defecto (puede variar según el juego), se fuerza su cierre. - Reiniciar: hace parada → inicio en un solo paso. Los jugadores conectados se desconectan brevemente.
3.2 Ver la consola / enviar comandos
- La pestaña Consola muestra la salida del servidor de juego en tiempo real.
- Escribe un comando y pulsa Intro para enviarlo a la consola del servidor (stdin). Ejemplos para Minecraft:
say hi!,op FriendNick. Usa ↑ para recuperar comandos anteriores. - Los comandos siguen el orden stdin → REST → RCON. Los juegos sin consola (como Palworld, que solo se controla mediante su API REST) se manejan con los comandos predefinidos de la pestaña Comandos. RCON solo se usa para un juego sin otra vía, solo por loopback (127.0.0.1) con un puerto y una contraseña aleatoria por instancia asignados por el demonio.
- La consola puede separarse en una ventana aparte y, en Windows, Abrir en terminal abre una consola de la CLI.
- Para cada servidor, el demonio guarda en memoria las líneas de consola más recientes (hasta 10 000) y también las escribe en archivos dentro de
logs/en la carpeta del servidor.
3.3 Ejecutar varios servidores a la vez
- Puedes crear varios servidores del mismo juego (p. ej., «MC Vanilla» y «MC Modpack») o ejecutar juegos distintos a la vez.
- Los puertos (los números que usa un juego para aceptar jugadores) de cada servidor no deben coincidir. Al crear un servidor nuevo, Saba-chan desplaza el puerto predeterminado para que no choque con tus otros servidores, y aparece un aviso en la pantalla del servidor si los puertos coinciden. Puedes cambiar el puerto en la pestaña Ajustes.
- Cada servidor adicional usa más memoria y CPU del PC. Revisa las especificaciones de tu PC antes de añadir más.
3.4 Detección de fallos y reinicio automático
- Cuando un servidor termina, el demonio determina el motivo: Detenido por ti, Detenido en el juego, Fallo o Desconocido. El veredicto se registra en Salidas recientes en la pestaña Info.
- Si se considera un Fallo, el servidor se reinicia automáticamente por defecto. El primer reinicio se produce a los 5 segundos y la espera se duplica en cada reinicio. Si hay más de 3 reinicios en 10 minutos, deja de reiniciarlo y tienes que iniciar el servidor tú mismo.
- Puedes cambiarlo en Reinicio automático dentro de la pestaña Saba-chan.
- Reiniciar tras un fallo: cuando terminó claramente por un error (activado por defecto).
- Reiniciar también en salidas desconocidas: cubre también los casos que no se pueden juzgar, como cerrarlo desde el Administrador de tareas (desactivado por defecto).
- Los servidores que detuviste tú mismo, desde Saba-chan o dentro del juego, no se reinician.
3.5 Límite de memoria (Windows)
- En Límite de memoria dentro de la pestaña Saba-chan puedes limitar la memoria (MB) que pueden usar en conjunto el servidor y sus procesos hijo. Si se supera el límite, el servidor se detiene.
- Déjalo vacío para no poner límite. En servidores Java, ponlo entre 1 y 2 GB por encima de
-Xmx. - Solo en Windows; se aplica tras reiniciar el servidor.
3.6 Vista previa de argumentos de inicio
- En los juegos que usan argumentos de inicio, Vista previa de argumentos de inicio en la pestaña Saba-chan muestra la línea de comandos con la que se lanzaría el servidor con los ajustes actuales, sin iniciarlo.
- Los argumentos que pongas en Argumentos adicionales y que no estén en la pantalla de ajustes (p. ej.,
-players=16 -useperfthreads) se pasan tal cual al iniciar. Los valores mal formados se señalan directamente en la vista previa. - Los valores como las contraseñas se ocultan como
***.
3.7 Aceptar condiciones (EULA de Minecraft, etc.)
- Si un servidor de juego tiene condiciones que requieren consentimiento, aparece el diálogo Se requiere aceptación al crear el servidor o al iniciarlo por primera vez. Lee el texto original, marca la casilla y haz clic en Aceptar e iniciar.
- El consentimiento solo puede darse desde la GUI o la CLI de este PC. Si alguien intenta iniciar el servidor desde Discord antes de que se acepten las condiciones, acéptalas primero en el PC.
4. Copias de seguridad y tareas programadas
Están en la pestaña Copias, que solo aparece en los juegos que admiten copias de seguridad.
4.1 Copias de seguridad
- Copiar ahora comprime el mundo y los archivos de guardado. El módulo del juego decide qué se guarda (en Minecraft, las carpetas de los mundos). Si el servidor está en marcha, primero se envía al juego un comando de guardado (
save-allen Minecraft, etc.). - La lista de copias muestra el tipo de cada una: Manual, Programada, Antes de actualizar, Antes de restaurar.
- Restaurar solo está disponible con el servidor detenido. Antes de restaurar se hace una copia más del estado actual, así que incluso una copia elegida por error se puede deshacer.
- Las copias manuales quedan fuera de la limpieza automática. Las demás (programadas, antes de actualizar, antes de restaurar) se conservan hasta el número de Copias programadas a conservar (10 por defecto), eliminando primero las más antiguas.
- Los archivos de copia se guardan dentro de la carpeta del servidor (instancia). Eliminar el servidor elimina también sus copias, así que copia en otro sitio las copias importantes.
4.2 Tareas programadas
Usa Añadir tarea para ejecutar automáticamente lo siguiente a intervalos fijos (cada N minutos) o a una hora concreta cada día (HH:MM, en la zona horaria del PC).
| Tarea | Qué hace |
|---|---|
| Copia | Hace una copia de seguridad mientras el servidor está en marcha |
| Reiniciar | Reinicia el servidor si está en marcha |
| Aviso | Envía un mensaje dentro del juego si el servidor está en marcha |
| Actualizar | Comprueba si hay una actualización del servidor de juego y la aplica si la hay (reinicia el servidor si estaba en marcha) |
- Las tareas de reinicio y actualización pueden avisar a los jugadores dentro del juego con antelación (p. ej.,
10, 5, 1minutos antes). Los anuncios y avisos solo están disponibles si el juego admite un comando de anuncio. - Cuando el demonio se reinicia, las tareas por intervalo vuelven a contar desde ese momento. Las tareas cuya hora pasó mientras el demonio estaba apagado no se ejecutan después de golpe.
5. Que tus amigos puedan conectarse
Si has montado el servidor de juego pero tus amigos no pueden entrar, casi siempre se trata de uno de estos tres casos.
5.1 Amigos en la misma Wi-Fi (LAN)
No hace falta configurar nada más. Basta con conectarse usando la IP privada del PC servidor (p. ej., 192.168.0.10) y el puerto.
5.2 Amigos fuera: el router admite reenvío de puertos
El reenvío de puertos es un ajuste del router que pasa las conexiones externas al PC servidor.
- En la página de administración del router, reenvía el puerto del juego a la IP privada del PC servidor.
- Da a tus amigos la dirección
<IP pública>:<puerto>. Puedes averiguar tu IP pública en sitios como whatismyip.com. - En el Firewall de Windows, permite el tráfico entrante (conexiones que llegan desde fuera) en ese puerto.
5.3 Amigos fuera: el reenvío de puertos no es posible
El reenvío de puertos suele estar bloqueado en redes de centros educativos o de empresa, con CGNAT del proveedor y en Wi-Fi de invitados. Incluso ahí puedes iniciar y detener servidores desde Discord gracias al relay en la nube.
- En la pantalla Discord de la GUI, usa Conectar un servidor de Discord para obtener un código y luego introdúcelo con el slash command
/saba connecten tu servidor de Discord. - A partir de ahí, tus amigos pueden iniciar y detener servidores o consultar su estado desde Discord.
- Consulta Bot de Discord y retransmisión en la nube para ver el flujo detallado.
El relay en la nube solo transmite comandos de control (iniciar/detener/estado, etc.), no el tráfico del juego. Si tus amigos no pueden conectarse directamente al servidor de juego, puede que también necesites una solución adicional (p. ej., ZeroTier, Tailscale).
6. Usar el bot de Discord: resumen en una página
Una vez emparejado el bot, gran parte de la operación diaria puede hacerse desde Discord sin abrir la GUI. Los comandos por mensaje tienen la forma <prefijo> <servidor> <comando>, y el prefijo predeterminado es Saba-chan (puedes cambiarlo en los ajustes del bot). Para <servidor>, usa el nombre del servidor o el nombre del juego (alias).
| Situación | Qué escribes en Discord (prefijo predeterminado) |
|---|---|
| «Hoy encendemos el MC» | Saba-chan minecraft start |
| «¿Está el servidor encendido ahora?» | Saba-chan minecraft status |
| «Vamos a apagarlo» | Saba-chan minecraft stop |
| «¿Qué servidores hay?» | Saba-chan list |
| «¿Qué puedo escribir?» | Saba-chan help |
Cada servidor recibe además su propio slash command /<nombre del servidor>. La lista completa de comandos y cómo registrar alias se explican en Comandos.
Para la configuración, el emparejamiento y el funcionamiento del relay del propio bot, consulta Bot de Discord y retransmisión en la nube.
7. Actualizaciones y limpieza
7.1 Actualizar Saba-chan
- Saba-chan consulta periódicamente una lista de versiones firmada y muestra una notificación de Actualizaciones disponibles en la GUI cuando sale una versión nueva.
- En Ajustes → Saba Storage, la pestaña Componentes permite descargar y aplicar actualizaciones por componente (núcleo, módulos, extensiones, etc.). En los componentes cuyos archivos en ejecución deben sustituirse, como el núcleo, el instalador (
saba-chan-installer) detiene brevemente el demonio, cambia los archivos y vuelve a iniciar solo lo que ha cambiado. Si solo ha cambiado el demonio, la ventana de la app se deja como está y únicamente se reinicia el demonio. - Como el demonio se reinicia, aplica las actualizaciones cuando nadie esté jugando.
7.2 Actualizar un servidor de juego
- Cuando hay una versión nueva del servidor de juego, aparece un botón Actualizar en la pantalla del servidor. Se puede aplicar con el servidor detenido.
- Antes se crea automáticamente una copia Antes de actualizar (en los juegos que admiten copias de seguridad).
- También puedes aplicar actualizaciones automáticamente a una hora concreta con la tarea programada Actualizar (§4.2).
7.3 Eliminar un servidor
- Elimínalo con Eliminar servidor en la pestaña Info. Un servidor solo puede eliminarse cuando está detenido.
- En los servidores que Saba-chan descargó y creó, la carpeta del servidor (incluidos los archivos del servidor de juego y las copias de seguridad) se elimina por completo. Copia antes los mundos o las copias que necesites.
- En los servidores vinculados con Migración de servidor existente, los archivos del juego en la carpeta original se dejan donde están.
7.4 Desinstalar Saba-chan
- Desinstala Saba-chan desde Configuración → Aplicaciones → Aplicaciones instaladas de Windows.
- El desinstalador primero detiene con normalidad los servidores que estén en marcha y elimina la carpeta de instalación, la carpeta de datos (
%APPDATA%\saba-chan\) y los accesos directos. Los archivos y las copias de los servidores creados por Saba-chan también están por defecto en esta carpeta de datos, así que copia los mundos que quieras conservar antes de desinstalar. Si marcas Keep game servers, se conservan los archivos de los servidores, los mundos, las copias y los ajustes de cada servidor; si marcas Keep settings, se conservan los ajustes de la app y la conexión con Discord, y una reinstalación los retoma. Si otra instalación de Saba-chan sigue usando la carpeta de datos, no se borra.
8. Cuando algo va mal
- Si aparecen líneas rojas en la consola, empieza por buscar ese mensaje exacto. Saba-chan muestra la salida del propio servidor de juego sin modificarla.
- Revisar servidor y Diagnosticar registro en la pestaña Info buscan problemas de configuración y errores conocidos en los logs recientes.
- Si eso no ayuda, la página Resolución de problemas recoge los escenarios habituales y cómo resolverlos.
- Si te encuentras con un problema nuevo, abre una incidencia en GitHub Issues junto con la salida de la consola. Los logs de la GUI se guardan en
%APPDATA%\saba-chan\logs\, y puedes abrir esa carpeta con Abrir carpeta de registros en la ventana que aparece al hacer clic en el estado del demonio, arriba. Adjuntar esos archivos acelera mucho el diagnóstico.