Numdrassl: La guía completa del proxy de Hytale

Para los administradores de servidores Hytale que buscan crear redes interconectadas (configuraciones multi-servidor para distribuir la carga), Numdrassl – Hytale Proxy Server es la solución definitiva.

Este proxy de alto rendimiento te permite vincular múltiples servidores Hytale (lobby, supervivencia, minijuegos) detrás de una única dirección, ofreciendo una experiencia fluida inspirada en BungeeCord o Velocity.

Esta guía detalla la instalación, configuración de red y el dominio del sistema de permisos.

¿Qué es Numdrassl?

Numdrassl es un servidor proxy en Java que se sitúa entre el jugador y tus servidores backend. Maneja la autenticación y el enrutamiento de paquetes a través del protocolo nativo QUIC de Hytale.

Características Clave

Red Multi-Servidor: Navega entre servidores sin desconectarte.
Transferencia de Jugadores: Comandos nativos /server.
Seguridad: Autenticación centralizada y soporte para referencias firmadas.
Sistema de Permisos: Gestión granular por grupos y usuarios.

Requisitos Previos

Java 25 o superior.
Uno o más servidores Hytale.
Los archivos proxy-*.jar y bridge-*.jar (disponibles en CurseForge).

Instalación del Proxy

1. Inicio

Coloca el archivo proxy-*.jar en una carpeta dedicada.
Lanza el proxy: java -jar proxy-1.0-SNAPSHOT.jar
Autenticación: En el primer lanzamiento, escribe auth login en la consola y sigue las instrucciones para vincular tu cuenta de Hytale.

2. Configuración (`config/proxy.yml`)

Edita el archivo generado para definir tu red:

# Red
bindAddress: "0.0.0.0"
bindPort: 45585
publicAddress: "play.mi-servidor.com"
publicPort: 45585

# SEGURIDAD (Debe ser idéntico en el Bridge)
proxySecret: "tu-secreto-muy-seguro"

# Servidores Backend
backends:
  - name: "lobby"
    host: "127.0.0.1"
    port: 5520
    defaultServer: true
  - name: "survival"
    host: "127.0.0.1"
    port: 5521
    defaultServer: false

Configuración de Servidores Backend

Tus servidores de juego ya no deben autenticar a los jugadores por sí mismos.

1. Instalación del Bridge

Copia el archivo bridge-*.jar en la carpeta plugins/ de cada servidor backend de Hytale.

2. Argumentos de Lanzamiento

Inicia tus servidores con los siguientes argumentos (obligatorios para que el proxy funcione):

java -jar HytaleServer.jar --auth-mode insecure --transport QUIC

3. Configuración del Bridge (`plugins/Bridge/config.json`)

{
  "proxySecret": "tu-secreto-muy-seguro",
  "serverName": "lobby"
}

Notas Importantes:

serverName se usa para identificar este servidor en los logs y la red.
proxySecret debe coincidir exactamente con el de la configuración del proxy.

4. Seguridad del Firewall

Debes bloquear las conexiones directas a los puertos UDP de tus servidores backend para forzar que el tráfico pase a través del proxy.

Sistema de Permisos

Estructura de Carpetas

data/permissions/
├── players/
│   └── {uuid}.yml       # Permisos específicos de un jugador
├── groups/
│   ├── default.yml      # Grupo por defecto (todos los jugadores)
│   └── admin.yml        # Grupos personalizados
└── player-groups.yml    # Asignación de jugadores a grupos

Ejemplos de Configuración

Grupo (groups/admin.yml):

name: admin
default: false
permissions:
  - numdrassl.command.* # Comodín (Wildcard)
  - numdrassl.admin

Jugador (players/{uuid}.yml):

permissions:
  - numdrassl.command.server
  - numdrassl.command.help
  - -numdrassl.command.stop # Denegado (prefijo con -)

Comandos y Administración

Comandos de Permisos (`/numdrassl perm ...`)

Comando	Descripción
`/numdrassl perm user <jugador> info`	Muestra grupos y permisos de un jugador.
`/numdrassl perm user <jugador> add <perm>`	Añade un permiso a un jugador.
`/numdrassl perm user <jugador> remove <perm>`	Elimina un permiso de un jugador.
`/numdrassl perm user <jugador> addgroup <grupo>`	Añade un jugador a un grupo.
`/numdrassl perm user <jugador> removegroup <grupo>`	Elimina un jugador de un grupo.
`/numdrassl perm group <grupo> add <perm>`	Añade un permiso a un grupo.
`/numdrassl perm group <grupo> remove <perm>`	Elimina un permiso de un grupo.
`/numdrassl perm reload`	Recarga la configuración de permisos del disco.

Comandos de Consola (Proxy)

Comando	Descripción
`auth login`	Inicia la autenticación con Hytale.
`auth status`	Muestra el estado de la autenticación.
`auth logout`	Borra las credenciales almacenadas.
`sessions`	Lista los jugadores conectados actualmente al proxy.
`stop`	Detiene el proxy de forma elegante.
`help`	Muestra los comandos disponibles.

Comandos de Jugador

Comando	Descripción
`/server` (o `/srv`)	Lista los servidores disponibles.
`/server <nombre>`	Transfiere al jugador al servidor objetivo.
`/numdrassl version`	Muestra la versión del proxy.

Errores Comunes

Error “Proxy not authenticated”: Escribe auth login en la consola.
Error “Invalid player info message”: Tu proxySecret no coincide entre el proxy y el bridge.
Imposible conectar: Comprueba que el servidor backend se haya iniciado con el argumento --transport QUIC.

Fuente: Hytale.game