Guida al Modding: Come Installare Mod su Hytale

Le mod sono il cuore dell'esperienza di Hytale. Questa guida ti spiega come installarle manualmente (senza app esterne) o tramite l'app di CurseForge, sia per il gioco singolo che per i server dedicati.

Nota Importante: Installa solo mod compatibili con la tua versione di Hytale. Mischiare versioni diverse può causare il crash del gioco.

1. Installazione su Client (Gioco Singolo)

Non è necessario chiudere il gioco per aggiungere o rimuovere mod, ma devi essere nel Menu Principale prima di avviare un mondo.

Passaggi Manuali:

  1. Apri l'Hytale Launcher.
  2. Clicca sull'icona dell'ingranaggio in alto a sinistra.
  3. Seleziona "Open Directory" (Apri cartella).
  4. Entra nella cartella UserData e poi nella cartella Mods. Questo è il posto dove andranno i file.
  5. Scarica le mod da CurseForge Hytale Mods.
    • Assicurati che il file scaricato sia in formato .jar.
    • Non scompattare (unzip) il file .jar.
  6. Trascina i file .jar scaricati nella cartella UserData/Mods aperta in precedenza.

Attivazione nel Gioco:

  • Torna nel gioco e clicca su "Worlds".
  • Per un nuovo mondo: Clicca l'ingranaggio accanto al campo del nome.
  • Per un mondo esistente: Fai tasto destro sul mondo.
  • In basso a sinistra vedrai l'elenco delle mod: metti la spunta su quelle che vuoi attivare e avvia il mondo.

2. Installazione su Server (Dedicato)

A differenza del client, il server deve essere riavviato ogni volta che aggiungi o rimuovi una mod.

  1. Vai nella cartella principale (root) del tuo server.
  2. Apri la cartella denominata /mods.
  3. Scarica i file .jar delle mod che desideri utilizzare.
  4. Inserisci i file .jar nella cartella /mods del server.
  5. Riavvia il server per applicare le modifiche.

3. Alternativa Semplificata: App CurseForge

Se preferisci un metodo automatico che gestisca gli aggiornamenti per te:

  • Scarica e installa l'App CurseForge sul tuo PC.
  • L'app rileverà automaticamente Hytale.
  • Cerca e installa le mod direttamente dall'interfaccia dell'app.
  • Una volta installate, dovrai comunque attivarle nelle impostazioni del mondo all'interno del gioco (come spiegato al punto 1).

4. Risoluzione dei Problemi

Se le mod non appaiono nell'elenco o il gioco crasha, controlla quanto segue:

  • Percorso file: Verifica che i file siano in UserData/Mods per il client o in /mods per il server.
  • Estensione: Assicurati che il file finisca per .jar e non sia uno zip o una cartella estratta.
  • Versione: Controlla nella pagina di download della mod se supporta la versione attuale di Hytale.
  • Riavvio: Se le mod non vengono rilevate a gioco aperto, prova a chiudere e riaprire completamente il Launcher.

In questa guida tecnica spieghiamo esattamente come funzionano l'installazione e la gestione delle mod in Hytale, sia per chi vuole giocare online sia per chi ama il singleplayer.

1. Multiplayer: Il sistema "Hot-Loading"

Se la tua intenzione è giocare su server moddati (es. server RPG, corse, sparatutto), la procedura è completamente automatizzata.

Hytale utilizza un sistema di trasferimento asset in tempo reale. Ecco cosa succede quando clicchi su "Entra":

  1. Il Client interroga il Server per conoscere la lista delle mod necessarie.
  2. Il Server invia automaticamente i file (modelli, texture, script e suoni) al tuo PC in una cartella temporanea sicura.
  3. Il gioco applica le modifiche solo per quella sessione.
Vantaggio chiave: Non dovrai mai più cercare la versione corretta di una mod su internet o preoccuparti di conflitti ID. Se il server usa una mod, tu la scarichi e giochi all'istante.

2. Singleplayer: Installazione Manuale

Per il tuo mondo personale, hai il controllo totale. Hytale include un pannello di controllo interno per gestire le modifiche senza toccare i file di sistema.

Come aggiungere una Mod al tuo Client

  • Passo 1: Scarica il file della mod (estensione prevista .hmod o pacchetti compressi).
  • Passo 2: Avvia Hytale e vai su "Modding" > "Libreria Locale".
  • Passo 3: Trascina il file scaricato o usa il tasto "Importa".

Come attivare le Mod in un Mondo

Le mod non sono attive ovunque per default. Devi attivarle per ogni specifico salvataggio:

  1. Nel menu di creazione mondo, clicca su "Impostazioni Avanzate".
  2. Vai alla scheda "Mod e Script".
  3. Spunta le caselle delle mod che vuoi caricare in quella partita.

3. Sicurezza e Performance

Uno dei timori più grandi nel scaricare mod è la sicurezza. Hytale affronta il problema alla radice:

  • Nessun eseguibile (.exe): Le mod di Hytale non sono programmi esterni, ma script e asset letti dal motore di gioco. È molto più difficile nascondere virus.
  • Client Side Prediction: Anche con molte mod grafiche, il client è ottimizzato per mantenere alti gli FPS scaricando il lavoro sulla CPU in modo intelligente.

In attesa del Download

Al momento del lancio ufficiale, aggiorneremo questa guida con i percorsi esatti delle cartelle di sistema (es. %appdata%/Hytale/mods) e i link ai repository ufficiali dove trovare le prime mod approvate dalla community.

Prepara le tue idee: modificare il mondo non è mai stato così facile.