Questa guida spiega come configurare i file GameUserSettings.ini e Game.ini per il tuo server ARK: Survival Ascended ospitato con Legion Hosting.
Ferma il server prima di modificare i file di configurazione. Ferma sempre il server dalla scheda Console di GPanel prima di modificare qualsiasi file
.ini. ARK può sovrascrivere i file allo spegnimento, quindi le modifiche effettuate mentre il server è in esecuzione potrebbero andare perse.
Panoramica dei File di Configurazione
ARK: Survival Ascended utilizza due file di configurazione principali per controllare il comportamento del server. Entrambi si trovano nella directory ShooterGame/Saved/Config/WindowsServer/ sul tuo server.
| File | Scopo |
|---|---|
GameUserSettings.ini |
Impostazioni principali del server — nome sessione, password, numero giocatori, tassi, crossplay, BattleEye e altro. Questo file viene creato al primo avvio del server. |
Game.ini |
Override avanzati del gameplay — punti engramma, scaling delle statistiche, dimensioni degli stack degli oggetti, spawn NPC personalizzati. Deve essere esattamente Game.ini (sensibile alle maiuscole/minuscole). Crealo manualmente se non esiste. |
Game.ini potrebbe non esistere di default. Se il file non è presente, crealo manualmente nell'editor di file di GPanel. Il nome del file deve essere esattamente
Game.ini con G e I maiuscole — game.ini o GAME.INI non funzioneranno.
Passaggio 1 — Accedere al File Manager in GPanel
- Accedi a GPanel.
- Seleziona il tuo server ARK: Survival Ascended dalla lista dei server.
- Se il server è in esecuzione, clicca Stop nella scheda Console e attendi che lo stato cambi in Offline.
- Clicca sulla scheda Files per aprire il file manager.
- Naviga fino a
ShooterGame/Saved/Config/WindowsServer/. TroveraiGameUserSettings.iniqui una volta che il server è stato avviato almeno una volta. SeGame.ininon è presente, lo creerai manualmente nel Passaggio 3.
Passaggio 2 — Configurare GameUserSettings.ini
Clicca su GameUserSettings.ini nel file manager per aprirlo nell'editor inline. Il file è diviso in sezioni — le più importanti per la configurazione del server sono [SessionSettings] e [ServerSettings].
Impostazioni Chiave in [SessionSettings]
| Impostazione | Valore di Esempio | Descrizione |
|---|---|---|
SessionName |
My Legion Server |
Il nome che appare nel browser dei server in gioco. Sceglilo unico in modo che i giocatori possano trovarlo facilmente. |
QueryPort |
7778 |
La porta di query utilizzata dal browser dei server. Deve corrispondere alla porta assegnata in GPanel. Il valore predefinito è porta di gioco + 1. |
Impostazioni Chiave in [ServerSettings]
| Impostazione | Valore di Esempio | Descrizione |
|---|---|---|
ServerPassword |
mypassword |
Password richiesta ai giocatori per entrare. Lascia vuoto per un server pubblico. |
ServerAdminPassword |
adminpass123 |
Password admin utilizzata per autenticare i comandi admin in gioco. Mantienila privata. |
MaxPlayers |
20 |
Numero massimo di giocatori simultanei. Dovrebbe corrispondere al limite di slot giocatori del tuo piano. |
XPMultiplier |
2.0 |
Moltiplicatore per l'XP guadagnata. 1.0 è il valore predefinito, 2.0 raddoppia il guadagno di XP. |
TamingSpeedMultiplier |
3.0 |
Moltiplicatore per la velocità di addomesticamento. Valori più alti accelerano l'addomesticamento. |
HarvestAmountMultiplier |
2.0 |
Moltiplicatore per le risorse raccolte per ogni azione di raccolta. |
DifficultyOffset |
1.0 |
Controlla la distribuzione dei livelli delle creature. Imposta a 1.0 per i livelli selvatici massimi con impostazioni in stile ufficiale. |
OverrideOfficialDifficulty |
5.0 |
Imposta il livello massimo dei dinosauri selvatici quando DifficultyOffset=1.0. Un valore di 5.0 permette livelli fino a 150. |
AllowCrateSpawnsOnTopOfStructures |
True |
Permette alle casse di rifornimento di atterrare sulle strutture dei giocatori. Consigliato per i server PvE. |
EnablePvPGamma |
True |
Permette ai giocatori di regolare il gamma in PvP. Disabilita per un'esperienza più competitiva. |
Un esempio minimale di una sezione configurata di GameUserSettings.ini:
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.0Passaggio 3 — Creare e Configurare Game.ini
Creare Game.ini
Game.ini deve essere creato manualmente dall'utente se non esiste già. Naviga fino a ShooterGame/Saved/Config/WindowsServer/ nel file manager di GPanel. Se Game.ini non è elencato, crea un nuovo file con il nome esatto Game.ini (G maiuscola e I maiuscola — game.ini o GAME.INI non funzioneranno).
Inizia il file con la seguente intestazione — tutte le impostazioni di Game.ini vanno sotto questa singola sezione:
[/script/shootergame.shootergamemode]Modificare Game.ini
Game.ini utilizza un formato basato su sezioni. La sezione più comune per la personalizzazione del server è [/script/shootergame.shootergamemode]. Le impostazioni vengono aggiunte una per riga all'interno della sezione appropriata.
Personalizzazioni comuni di Game.ini:
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)| Impostazione | Descrizione |
|---|---|
OverridePlayerLevelEngramPoints=N |
Imposta i punti engramma assegnati ad ogni livello. Aggiungi una riga per ogni livello del giocatore. Usalo per concedere più engrammi per livello. |
MaxCustomNodes=N |
Controlla il numero massimo di nodi di spawn personalizzati. Rilevante per configurazioni avanzate di spawn moddati. |
EngramEntryAutoUnlocks=(...) |
Forza lo sblocco automatico di engrammi specifici a un livello definito, utile per dare a tutti i giocatori accesso a determinati oggetti senza spendere punti. |
ConfigOverrideItemMaxQuantity=(...) |
Sovrascrive le dimensioni massime degli stack per oggetti specifici. |
Suggerimento: L'intestazione di sezione
[/script/shootergame.shootergamemode] deve essere presente esattamente una volta in Game.ini. Se la aggiungi una seconda volta, verrà utilizzata solo l'ultima occorrenza. Aggiungi tutte le tue impostazioni sotto la singola intestazione.
Configurazione della Query Port
La query port è separata dalla porta di gioco e viene utilizzata esclusivamente dal browser dei server (Steam/Epic) per elencare il tuo server. Se la query port è errata o irraggiungibile, il tuo server non apparirà nel browser anche se funziona correttamente.
| Porta | Predefinita | Configurata in | Scopo |
|---|---|---|---|
| Game Port | 7777 |
Scheda Startup / Network di GPanel | I giocatori si connettono attraverso questa porta per entrare nel server |
| Query Port | 7778 |
GameUserSettings.ini — QueryPort sotto [SessionSettings] |
Polling del browser dei server — deve corrispondere alla porta allocata in GPanel |
La query port deve corrispondere a GPanel. Il valore
QueryPort in GameUserSettings.ini deve corrispondere esattamente alla query port mostrata nella scheda Network di GPanel. Legion Hosting pre-assegna entrambe le porte quando il tuo server viene creato — controlla la scheda Network per i tuoi valori specifici prima di modificare il file .ini. Non dare per scontato che i valori predefiniti 7777/7778 si applichino al tuo server.
Applicare le Modifiche
- Salva il file
.inimodificato usando il pulsante Save nell'editor di file di GPanel. - Torna alla scheda Console.
- Clicca Start per avviare il server. GPanel caricherà la configurazione aggiornata all'avvio.
- Monitora l'output della console per eventuali errori. Errori di configurazione come valori non validi o intestazioni di sezione duplicate produrranno spesso avvisi nel log di avvio.
Modifica sempre i file di configurazione mentre il server è fermo. Modificare
GameUserSettings.ini o Game.ini mentre il server è fermo e poi avviare il server è sufficiente. Non tentare di ricaricare i file di configurazione a caldo mentre il server è in esecuzione — ARK non supporta il ricaricamento della configurazione in tempo reale per la maggior parte delle impostazioni.
Risoluzione dei Problemi
Game.ini non esiste o le impostazioni non vengono lette
Game.ininon viene creato automaticamente. Se il file non esiste, crealo manualmente nell'editor di file di GPanel all'interno diShooterGame/Saved/Config/WindowsServer/.- Il nome del file è sensibile alle maiuscole/minuscole. Deve essere esattamente
Game.ini— nongame.ini,GAME.INIo qualsiasi altra variazione. - Assicurati che il file contenga l'intestazione
[/script/shootergame.shootergamemode]come prima riga e che questa intestazione appaia una sola volta.
Le impostazioni in Game.ini o GameUserSettings.ini non vengono applicate
- Conferma che il server fosse completamente fermo prima di modificare il file. Se il server era in esecuzione, potrebbe aver sovrascritto le tue modifiche al suo prossimo spegnimento.
- Controlla che l'intestazione di sezione (ad es.
[ServerSettings]o[/script/shootergame.shootergamemode]) appaia esattamente una volta nel file. Intestazioni di sezione duplicate causeranno l'override delle impostazioni precedenti da parte di quelle successive, oppure verranno ignorate interamente a seconda del parser. - Dopo aver salvato il file, riavvia completamente il server da GPanel prima di testare.
- Verifica che il file sia nella directory corretta:
ShooterGame/Saved/Config/WindowsServer/. I file posizionati nella posizione sbagliata vengono silenziosamente ignorati.
Il server non appare nel browser dei server dopo la configurazione delle impostazioni
- Conferma che la
QueryPortinGameUserSettings.inicorrisponda esattamente alla porta elencata nella scheda Network di GPanel. - Il browser dei server può impiegare 5–10 minuti per indicizzare un server appena avviato o riconfigurato. Prova una connessione diretta con
open IP:GAMEPORTnella console in gioco di ASA per verificare che il server sia raggiungibile mentre il browser si aggiorna. - Se il crossplay è abilitato, i giocatori devono deselezionare i filtri di blocco della piattaforma nel browser dei server. Consulta la guida alla connessione per i dettagli.
