Numdrassl : Le guide complet du proxy Hytale

Pour les administrateurs de serveurs Hytale cherchant à créer des réseaux interconnectés (multi-serveurs pour répartir la charge), Numdrassl – Hytale Proxy Server est la solution incontournable.

Ce proxy haute performance permet de relier plusieurs serveurs Hytale (lobby, survie, mini-jeux) derrière une adresse unique, offrant une expérience fluide inspirée de BungeeCord ou Velocity.

Ce guide détaille l’installation, la configuration du réseau et la maîtrise du système de permissions.

Qu’est-ce que Numdrassl ?

Numdrassl est un serveur proxy Java qui s’intercale entre le joueur et vos serveurs backend. Il gère l’authentification et le routage des paquets via le protocole QUIC natif d’Hytale.

Fonctionnalités clés :

• Réseau Multi-serveurs : Naviguez entre serveurs sans déconnexion.
• Transfert de joueurs : Commandes /server natives.
• Sécurité : Authentification centralisée et support des référents signés.
• Système de Permissions : Gestion fine par groupes et utilisateurs.

Prérequis

• Java 25 ou supérieur.
• Un ou plusieurs serveurs Hytale.
• Les fichiers proxy-*.jar et bridge-*.jar (disponibles sur CurseForge).

Installation du proxy

Démarrage

1. Placez le fichier proxy-*.jar dans un dossier dédié.
2. Lancez le proxy :
   java -jar proxy-1.0-SNAPSHOT.jar
3. Authentification : Au premier lancement, tapez auth login dans la console et suivez les instructions pour lier votre compte Hytale.

Configuration (config/proxy.yml)

Éditez le fichier généré pour définir votre réseau :

# Réseau
bindAddress: "0.0.0.0"
bindPort: 45585
publicAddress: "play.mon-serveur.com"
publicPort: 45585

# SÉCURITÉ (Doit être identique sur le Bridge)
proxySecret: "votre-secret-tres-securise"

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

Configuration des serveurs (backend)

Vos serveurs Hytale (Lobby, Survie…) ne doivent plus gérer l’authentification eux-mêmes ; c’est le rôle du proxy.

Installation du Plugin Bridge

1. Téléchargez le fichier bridge-*.jar.
2. Copiez-le dans le dossier plugins/ de chaque serveur Hytale de votre réseau.

Lancement Spécifique

Pour que le système fonctionne, lancez vos serveurs Hytale avec ces arguments précis :

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


• --auth-mode insecure : Désactive l’authentification native du serveur (le proxy s’en charge).
• --transport QUIC : Active le protocole réseau compatible avec le proxy.

Configuration du Bridge

Au premier lancement, un fichier plugins/Bridge/config.json est créé sur chaque serveur. Éditez-le :

{
  "proxySecret": "votre-secret-tres-securise-a-changer",
  "serverName": "lobby"
}

• proxySecret : Doit être strictement identique à celui défini dans proxy.yml.
• serverName : Le nom de ce serveur (utilisé pour les logs et l’identification dans le réseau).

Sécurité (Pare-feu)

Il est vital de bloquer les connexions directes aux ports de vos serveurs backend (ex: 5520, 5521). Seule l’adresse IP du proxy doit être autorisée à s’y connecter. Sans cela, des joueurs pourraient contourner votre proxy (et donc vos bannissements/permissions).

Système de Permissions

Numdrassl utilise une structure de fichiers spécifique pour gérer les droits. Voici comment elle s’organise sur votre disque :

Structure des dossiers

data/permissions/
├── players/
│   └── {uuid}.yml       # Permissions spécifiques à un joueur
├── groups/
│   ├── default.yml      # Groupe par défaut (tous les joueurs)
│   └── admin.yml        # Groupes personnalisés
└── player-groups.yml    # Assignation des joueurs aux groupes

Exemples de configuration

Group (groups/admin.yml):

name: admin 
default: false 
permissions:
  - numdrassl.command.* # Wildcard
  - numdrassl.admin

Player (players/{uuid}.yml):

permissions:
  - numdrassl.command.server
  - numdrassl.command.help
  - -numdrassl.command.stop # Denied (prefix with -)

Commandes et administration

Commandes de permissions (/numdrassl perm ...)

Commandes console (proxy)

Commandes joueurs

Erreurs fréquentes

• Erreur « Proxy not authenticated » : Tapez auth login dans la console.
• Erreur « Invalid player info message » : Votre proxySecret est différent entre le proxy et le bridge.
• Connexion impossible : Vérifiez que le serveur backend est lancé avec --transport QUIC.