Guida alla Configurazione del Server Vintage Story

Questa guida spiega come configurare e impostare il tuo server dedicato Vintage Story ospitato con Legion Hosting, incluso il primo avvio, le variabili di GPanel, la gestione delle versioni, la configurazione del server, le impostazioni del mondo, la connessione dei giocatori e la gestione dei salvataggi. Per l'installazione delle mod, consulta Installazione di Mod su Vintage Story. Per la configurazione amministrativa e i comandi, consulta Comandi Amministrativi di Vintage Story.

Prima di iniziare: Assicurati che il tuo server sia creato in GPanel. Se hai bisogno di aiuto per trovare l'indirizzo IP e la porta del tuo server, consulta Come Trovare l'IP e la Porta del Tuo Server.

Primo Avvio

Quando avvii il tuo server Vintage Story per la prima volta da GPanel, il server scaricherà automaticamente i file di gioco dall'API ufficiale di Vintage Story e genererà un mondo predefinito. Questo avvio iniziale può richiedere diversi minuti mentre i file vengono scaricati ed estratti.

Accedi a GPanel e seleziona il tuo server Vintage Story.
Prima di avviare, controlla la scheda Startup per confermare il branch di versione preferito (stable, unstable o pre-release).
Clicca su Start nella scheda Console. Osserva l'output della console per i messaggi di avanzamento mentre il server scarica e installa i file di gioco.
Una volta visualizzato un messaggio che indica che il server è in ascolto delle connessioni, il server è pronto. Un file serverconfig.json predefinito verrà generato automaticamente.

Il primo avvio richiede più tempo del solito. Il server deve scaricare il pacchetto server completo di Vintage Story prima di poter avviarsi. Gli avvii successivi saranno molto più rapidi, a meno che tu non cambi la versione o il branch.

Variabili di Avvio di GPanel

Le impostazioni principali del server sono controllate tramite la scheda Startup in GPanel. Controllale e regolale prima di avviare il tuo server.

Variabile	Predefinito	Descrizione
`SERVER_PORT`	(assegnata)	La porta di gioco che i giocatori usano per connettersi. Viene assegnata automaticamente da GPanel -- controlla la scheda Network per la porta assegnata.
`MAX_CLIENTS`	`16`	Numero massimo di giocatori simultanei. Può essere impostato fino a 256. Dovrebbe corrispondere alle risorse del tuo piano di hosting.
`FILES_BRANCH`	`stable`	Quale branch di rilascio utilizzare. Opzioni: `stable`, `unstable` o `pre`. Vedi la sezione Gestione delle Versioni qui sotto per i dettagli.
`RELEASE_VERSION`	`latest`	La versione specifica da installare. Imposta su `latest` per usare sempre la versione più recente sul branch scelto, oppure inserisci un numero di versione specifico (ad es. `1.19.8`) per bloccarti su quella versione.
`OPTIONS`	(vuoto)	Argomenti aggiuntivi da riga di comando passati al processo del server all'avvio. Lascia vuoto a meno che tu non abbia bisogno di flag di avvio specifici.
`SQLITE_TMPDIR`	(auto)	Directory temporanea utilizzata da SQLite per le operazioni sul database. In genere non è necessario modificarla.

Dopo aver aggiornato le variabili di avvio, riavvia il server da GPanel affinché le modifiche abbiano effetto.

Gestione delle Versioni

Vintage Story offre tre branch di rilascio. La scelta del branch viene impostata tramite la variabile di avvio FILES_BRANCH in GPanel.

Branch	Valore	Descrizione
Stable	`stable`	Il branch consigliato per la maggior parte dei server. Questi rilasci sono stati testati approfonditamente e sono i più affidabili per i mondi a lungo termine.
Unstable	`unstable`	Rilasci beta con nuove funzionalità e modifiche ancora in fase di test. Potrebbero contenere bug. Usa questo branch se desideri l'accesso anticipato ai nuovi contenuti e accetti una certa instabilità.
Pre-release	`pre`	Build di sviluppo iniziali. Sono le meno testate e potrebbero presentare problemi significativi. Consigliate solo a scopo di test -- non per server di produzione.

Bloccare una Versione Specifica

Per impostazione predefinita, RELEASE_VERSION è impostato su latest, il che significa che il server scaricherà e installerà la versione più recente disponibile sul branch scelto ogni volta che il server si avvia (se è disponibile una versione più recente). Per evitare gli aggiornamenti automatici e bloccare il tuo server su una versione specifica:

Vai alla scheda Startup in GPanel.
Cambia RELEASE_VERSION da latest al numero di versione esatto desiderato (ad es. 1.19.8).
Riavvia il server. Utilizzerà solo la versione bloccata indipendentemente dai rilasci più recenti.

Compatibilità delle mod: Se utilizzi delle mod, si consiglia di bloccare una versione specifica. Gli aggiornamenti di gioco possono compromettere la compatibilità delle mod, e aggiornare a metà partita può causare problemi. Verifica che le tue mod supportino la versione di destinazione prima di aggiornare. Consulta Installazione di Mod su Vintage Story per i dettagli.

Il cambio di branch può richiedere un reset del mondo. Il passaggio tra i branch stable e unstable può introdurre modifiche al formato del mondo. Esegui sempre un backup del tuo mondo prima di cambiare branch. Se la nuova versione è incompatibile con il tuo mondo esistente, potresti dover iniziarne uno nuovo.

serverconfig.json

Il file di configurazione principale del server è serverconfig.json, situato nella directory root del server. Questo file viene generato automaticamente al primo avvio. Arresta il server prima di modificarlo, quindi riavvia affinché le modifiche abbiano effetto.

Arresta il server dalla scheda Console di GPanel.
Apri la scheda Files e clicca su serverconfig.json per modificarlo.
Modifica le impostazioni di cui hai bisogno (vedi la tabella qui sotto).
Salva il file e avvia il server.

Impostazioni Chiave

Impostazione	Valore di Esempio	Descrizione
`ServerName`	`"My Legion VS Server"`	Il nome visualizzato nel browser dei server in-game. Rendilo descrittivo affinché i giocatori possano trovare il tuo server.
`WelcomeMessage`	`"Welcome to the server!"`	Messaggio mostrato ai giocatori quando entrano. Supporta la formattazione di base.
`MaxClients`	`16`	Numero massimo di giocatori simultanei. Dovrebbe corrispondere alla variabile di avvio `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Password richiesta per entrare nel server. Lascia una stringa vuota (`""`) per un server pubblico.
`AllowPvP`	`true`	Imposta su `true` per abilitare il combattimento giocatore contro giocatore, oppure su `false` per un server solo PvE.
`SpawnRadius`	`50`	Raggio (in blocchi) attorno al punto di spawn del mondo in cui i nuovi giocatori possono comparire. Un valore più grande distribuisce maggiormente i giocatori al momento dell'ingresso.
`MapSizeX`	`1024000`	Larghezza del mondo in blocchi. Il valore predefinito crea un mondo molto grande. Riducendolo si limita quanto i giocatori possono viaggiare in direzione est-ovest.
`MapSizeZ`	`1024000`	Profondità del mondo in blocchi. Il valore predefinito crea un mondo molto grande. Riducendolo si limita quanto i giocatori possono viaggiare in direzione nord-sud.
`WorldSeed`	`"myseed123"`	Seed utilizzato per la generazione del mondo. Lo stesso seed produce lo stesso mondo. Lascia una stringa vuota per un seed casuale.

Un esempio minimale delle impostazioni chiave in serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

Il file deve essere JSON valido. Assicurati che tutte le stringhe siano racchiuse tra virgolette doppie, che i booleani siano in minuscolo (true/false) e che non ci siano virgole finali dopo l'ultimo elemento di un oggetto o array. Se il server non si avvia dopo la modifica, controlla la presenza di errori di sintassi JSON.

Configurazione del Mondo

Vintage Story genera il suo mondo in base alle impostazioni in serverconfig.json. La generazione del mondo avviene solo al primo avvio con un dato mondo -- modificare le impostazioni di generazione dopo che il mondo è stato creato non altererà retroattivamente il terreno esistente.

Impostazioni di Generazione del Mondo

WorldSeed: Determina la disposizione del terreno, il posizionamento dei biomi e la distribuzione delle risorse. Imposta un seed specifico per condividere la stessa disposizione del mondo con altri, oppure lascialo vuoto per un mondo generato casualmente.
MapSizeX / MapSizeZ: Controllano l'area giocabile massima. Valori più piccoli creano un mondo più contenuto e possono ridurre l'utilizzo delle risorse. I giocatori che raggiungono il bordo della mappa non potranno viaggiare oltre in quella direzione.
WorldConfig: L'oggetto WorldConfig all'interno di serverconfig.json ti permette di mettere a punto i parametri di generazione del mondo come la scala delle forme del terreno, i pattern climatici e le caratteristiche geologiche. Queste sono impostazioni avanzate -- i valori predefiniti funzionano bene per la maggior parte dei server.

Le impostazioni di generazione del mondo sono bloccate dopo la creazione. Impostazioni come WorldSeed, MapSizeX e MapSizeZ hanno effetto solo quando il mondo viene generato per la prima volta. Per applicare nuove impostazioni di generazione, devi creare un nuovo mondo (vedi Gestione dei Salvataggi qui sotto).

Scegliere un Seed

Il seed può essere qualsiasi stringa di testo o numero. I giocatori della community di Vintage Story condividono i seed per disposizioni del mondo interessanti. Se desideri un tipo specifico di terreno o di posizione di spawn, cerca nei forum di Vintage Story o sui siti della community i seed consigliati.

Come Connettersi

I giocatori si connettono al tuo server Vintage Story tramite il menu multiplayer in-game.

Connessione Diretta

Avvia Vintage Story e clicca su Multiplayer dal menu principale.
Clicca su Direct Connect.
Inserisci l'indirizzo IP e la porta di gioco del tuo server nel formato:
```
your.server.ip:port
```
Controlla la scheda Network in GPanel per l'IP e la porta assegnati.
Clicca su Connect. Se il server ha una password, inseriscila quando richiesto.

Browser dei Server

Avvia Vintage Story e clicca su Multiplayer dal menu principale.
Il browser dei server caricherà un elenco di server pubblici. Usa la barra di ricerca per trovare il tuo server per nome (il valore ServerName da serverconfig.json).
Clicca sul tuo server nell'elenco e clicca su Join.

Il server non appare nel browser? Il browser dei server può impiegare diversi minuti per indicizzare un server appena avviato. Usa la Connessione Diretta per un accesso immediato. Verifica inoltre di non aver impostato una password -- i server protetti da password potrebbero non apparire nel browser pubblico a seconda delle impostazioni del server.

Gestione dei Salvataggi

I dati del mondo di Vintage Story sono memorizzati sul tuo server e salvati automaticamente durante il gioco.

Posizione dei Dati del Mondo

I file di salvataggio del mondo sono memorizzati nella directory data/ sul tuo server. Il percorso esatto dipende dal nome del tuo mondo. Puoi accedere a questi file tramite la scheda Files di GPanel o via SFTP.

Backup del Tuo Mondo

Arresta il server per garantire un backup pulito (nessun file in scrittura durante il salvataggio).
Connettiti al tuo server via SFTP. Consulta Come Caricare File tramite SFTP per le istruzioni di connessione.
Scarica l'intera directory data/ sul tuo computer locale.
Conserva il backup in un luogo sicuro. Valuta di mantenere più backup datati nel caso in cui tu debba ripristinare un punto specifico.

I backup regolari sono fortemente consigliati. La corruzione del mondo, il griefing accidentale o gli aggiornamenti delle mod falliti possono tutti causare la perdita di dati. Esegui un backup del tuo mondo prima di apportare modifiche significative come l'aggiornamento della versione di gioco, l'aggiunta o la rimozione di mod, o la modifica delle impostazioni del mondo.

Reset del Mondo

Per iniziare un mondo completamente nuovo:

Arresta il server dalla scheda Console di GPanel.
Esegui un backup dei dati del mondo esistente se desideri conservarli (vedi sopra).
Vai alla directory data/ nel file manager di GPanel ed elimina i file di salvataggio del mondo.
Facoltativamente, aggiorna il WorldSeed in serverconfig.json per generare una diversa disposizione del mondo.
Avvia il server. Un nuovo mondo verrà generato da zero utilizzando le tue impostazioni di configurazione attuali.

L'eliminazione dei file del mondo è permanente. Una volta eliminato, il mondo non può essere recuperato a meno che tu non abbia un backup. Scarica sempre un backup prima di eseguire un reset del mondo.

Hai Bisogno di Aiuto?

Se riscontri un problema non trattato in questa guida, apri un ticket di supporto e includi l'indirizzo IP del tuo server, una descrizione del problema e qualsiasi output rilevante della console di GPanel.

Guida alla Configurazione del Server Vintage Story - Archivio Domande

Supporto

Categorie

Guida alla Configurazione del Server Vintage Story