Panel Web

El panel web proporciona una interfaz completa para administrar múltiples servidores de Hytale desde un único dashboard.

Dashboard Multi-Servidor

El dashboard principal muestra todos tus servidores con su estado actual.

Tarjetas de Servidor

Cada servidor muestra:

• Nombre - Nombre personalizado del servidor
• Estado - En Línea (verde) o Desconectado (rojo)
• Acciones:
  • Entrar - Acceder a la gestión del servidor
  • Eliminar - Eliminar servidor y datos

Crear un Servidor

1. Haz clic en el botón "Crear Servidor"
2. Completa la configuración:
   • Nombre del Servidor - Un nombre amigable
   • Puerto - Puerto UDP (asignado automáticamente si no se especifica)
   • RAM Mín / RAM Máx - Tamaño del heap de Java (ej: 4G, 8G)
   • Linux Nativo - Habilitar para hosts Linux, deshabilitar para CasaOS/Windows
3. Haz clic en "Crear"

El servidor se crea con su propio:

• Contenedor Docker
• Directorio de datos
• Archivos de configuración

Gestión del Servidor

Después de entrar a un servidor, tienes acceso a varias pestañas:

Consola

• Logs del servidor en tiempo real via WebSocket
• Salida con colores para diferentes niveles de log
• Auto-scroll con opción de pausa
• Entrada de comandos para enviar al servidor

TIP

Los comandos están deshabilitados cuando el servidor está offline.

Pestaña Setup

Gestiona la descarga de archivos del juego y autenticación:

• Estado de Descarga - Muestra si los archivos del juego están presentes
• Botón de Descarga - Descarga HytaleServer.jar y Assets.zip (~2GB)
• Autenticación - Flujo OAuth de dispositivo para autenticación de Hytale

Pestaña Files

Gestor de archivos completo para el directorio de datos del servidor:

• Navegar - Navegar carpetas
• Subir - Arrastrar y soltar o clic para subir archivos (máx 500MB)
• Editar - Editor de texto integrado para configs
• Eliminar - Eliminar archivos y carpetas
• Descargar - Descargar archivos como .tar

WARNING

Las operaciones de archivos requieren que el servidor esté corriendo.

Pestaña Mods

Gestiona mods del servidor con integración de Modtale:

• Explorar - Buscar en el catálogo de Modtale
• Instalar - Instalación de mods con un clic
• Local - Ver mods instalados
• Habilitar/Deshabilitar - Alternar mods sin eliminarlos
• Actualizaciones - Verificar actualizaciones de mods

Requiere la variable de entorno MODTALE_API_KEY.

Pestaña Commands

Referencia rápida y botones para comandos comunes:

/help              - Mostrar todos los comandos
/list              - Listar jugadores conectados
/auth login device - Iniciar autenticación OAuth
/auth status       - Verificar estado de auth
/stop              - Detener el servidor

Pestaña Control

Gestión del ciclo de vida del servidor:

Botón	Acción
INICIAR	Iniciar el contenedor del servidor
REINICIAR	Reiniciar el servidor
DETENER	Detener el servidor graciosamente
BORRAR DATOS	Eliminar todos los datos del servidor (requiere confirmación)

Pestaña Config

Edita la configuración del servidor sin tocar archivos YAML:

Configuración	Descripción
Puerto	Puerto UDP del juego (1024-65535)
RAM Mín	Heap mínimo de Java (ej: 2G, 4G)
RAM Máx	Heap máximo de Java (ej: 4G, 8G)
Dirección de Enlace	Interfaz de red (por defecto: 0.0.0.0)
Argumentos Extra	Args adicionales (ej: --world-seed 123)
Auto-descarga	Habilitar descarga automática de archivos
G1GC	Usar recolector de basura G1 (recomendado)
Linux Nativo	Montar volúmenes machine-id (solo Linux)

WARNING

La configuración solo puede editarse cuando el servidor está detenido. Reinicia el servidor para aplicar cambios.

Autenticación

El panel usa JWT (JSON Web Tokens) para autenticación.

• Los tokens expiran después de 24 horas
• Se almacenan en localStorage del navegador

Cambiar Credenciales

Edita tu archivo .env:

PANEL_USER=tu_usuario
PANEL_PASS=tu_contraseña_segura

Luego reinicia el panel:

docker compose restart

Soporte Multi-idioma

El panel soporta múltiples idiomas:

• 🇺🇸 Inglés
• 🇪🇸 Español
• 🇺🇦 Ucraniano

El idioma se detecta automáticamente desde la configuración de tu navegador.

Estructura de Datos

Los datos de cada servidor se almacenan independientemente:

data/panel/
├── servers.json          # Registro y configs de servidores
└── servers/
    └── {server-id}/
        ├── docker-compose.yml  # Auto-generado
        └── server/
            ├── HytaleServer.jar
            ├── Assets.zip
            ├── universe/       # Datos del mundo
            ├── mods/           # Mods del servidor
            └── logs/           # Logs del servidor

Atajos de Teclado

Atajo	Acción
Enter	Enviar comando
↑ / ↓	Navegar historial de comandos

Consideraciones de Seguridad

DANGER

Nunca expongas el panel a internet sin medidas de seguridad:

1. Usa un proxy reverso (nginx, Traefik) con HTTPS
2. Configura reglas de firewall
3. Usa contraseñas fuertes
4. Considera VPN para acceso remoto

Ejemplo: Proxy Reverso con Nginx

server {
    listen 443 ssl;
    server_name hytale.tudominio.com;

    ssl_certificate /ruta/a/cert.pem;
    ssl_certificate_key /ruta/a/key.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Solución de Problemas

"No space left on device" en Windows/Docker Desktop

Este es un bug conocido de Docker Desktop. Solución:

1. Ejecuta wsl --shutdown en PowerShell
2. Reinicia Docker Desktop
3. Intenta de nuevo

El servidor no inicia

Revisa los logs del servidor para errores. Problemas comunes:

• Puerto en uso - cambia el puerto en la pestaña Config
• Archivos del juego faltantes - usa la pestaña Setup para descargar
• RAM insuficiente - aumenta RAM Máx en la pestaña Config

La pestaña Files muestra vacío

La pestaña Files requiere que el servidor esté corriendo. Inicia el servidor primero.