Guida Completa: Creare e Gestire un Server Hytale

Questa guida ti accompagnerà passo dopo passo nella creazione di un server Hytale, utilizzando gli strumenti ufficiali e le migliori pratiche per prestazioni ottimali. Hytale utilizza tecnologie moderne (come Java 25 e il protocollo QUIC), quindi segui attentamente i passaggi.

Requisito Fondamentale: Il server richiede obbligatoriamente Java 25 e una porta UDP aperta (Default: 5520).

1. Prerequisiti di Sistema

  • RAM: Minimo 4GB dedicati (l'uso varia in base ai giocatori e alla distanza di visione).
  • CPU: Supporto per architetture x64 e arm64.
  • Sistema Operativo: Windows o Linux (Ubuntu/Debian consigliati).

2. Installazione di Java 25

Hytale non funzionerà con versioni vecchie di Java (come 8, 17 o 21). Devi installare la versione 25.

Dove scaricarlo

Consigliamo la distribuzione Adoptium (Temurin), che è stabile e certificata.

Scarica Java 25 da Adoptium

Dopo l'installazione, verifica che sia tutto corretto aprendo il terminale e digitando:

java --version

Dovresti vedere un output simile a: openjdk 25.0.1 ....

3. Scaricare i File del Server (Metodo Ufficiale)

Per garantire di avere sempre l'ultima versione sicura, utilizza il Hytale Downloader CLI. Questo strumento gestisce il download e l'aggiornamento automatico.

Scarica Hytale Downloader CLI (.zip)

Come usarlo:

  1. Estrai lo zip in una cartella.
  2. Apri il terminale in quella cartella.
  3. Esegui il comando di download: 
    ./hytale-downloader
    (Su Windows potresti dover digitare solo hytale-downloader)

Questo scaricherà il file HytaleServer.jar e tutti gli asset necessari.

4. Configurazione Rete (Porte e Firewall)

Hytale usa il protocollo QUIC su UDP. A differenza di Minecraft, le connessioni TCP non servono per il gioco.

  • Porta: 5520 (Default)
  • Protocollo: UDP

Comando rapido per Linux (UFW):

sudo ufw allow 5520/udp

5. Avvio e Autenticazione

Al primo avvio, dovrai collegare il server al tuo account Hytale/Hypixel per motivi di sicurezza.

Comando di Avvio (Ottimizzato)

Usa questo comando per sfruttare la cache AOT (Ahead-Of-Time), che riduce drasticamente i tempi di accensione:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets PathToAssets.zip

Procedura di Login

Guarda la console. Vedrai un messaggio del genere:

> /auth login device
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234

Vai sul sito indicato, inserisci il codice e il server completerà l'avvio.

6. Plugin Consigliati e Ottimizzazione

Per gestire al meglio il server, i partner ufficiali (Nitrado e Apex Hosting) hanno rilasciato dei plugin essenziali.

Plugin Utili (Open Source)

  • Nitrado:PerformanceSaver - Link GitHub
    Regola dinamicamente la distanza di visione in base al carico del server per evitare lag.
  • Nitrado:Query - Link GitHub
    Permette di interrogare lo stato del server (numero giocatori, ecc.) via HTTP, utile per le liste server.
  • ApexHosting:PrometheusExporter - Link GitHub
    Esporta metriche dettagliate per monitorare l'uso di RAM e CPU in tempo reale.

Consigli per le Prestazioni

  • Distanza di Visione: Imposta un massimo di 12 chunk (384 blocchi). Hytale carica molti più dati rispetto ad altri giochi voxel, quindi valori più alti consumeranno rapidamente tutta la RAM.
  • Sviluppo: Se stai creando i tuoi plugin, avvia il server con --disable-sentry per evitare di inviare report di crash durante i tuoi test.