Questa guida copre tutti i comandi admin, il supporto mod e gli strumenti di gestione del server disponibili per il tuo server dedicato Avorion su Legion Hosting. Scopri come gestire i giocatori, controllare la galassia, installare mod e risolvere problemi comuni. Per la configurazione iniziale del server, consulta la nostra Guida alla Configurazione del Server Avorion.

Configurazione Admin

Avorion utilizza un sistema admin basato su XML che concede permessi elevati a giocatori specifici. Gli admin sono definiti nel file admin.xml o possono essere aggiunti tramite comandi in gioco.

Aggiungere Admin tramite admin.xml

Il file admin.xml si trova nella cartella di salvataggio della tua galassia (es. galaxies/your_galaxy_name/admin.xml). Puoi modificare questo file tramite il File Manager di GPanel.

<?xml version="1.0" encoding="UTF-8"?>
<admin>
    <admin id="76561198012345678" />
    <admin id="76561198087654321" />
</admin>

Ogni voce <admin> contiene lo Steam ID di un giocatore (formato SteamID64). Per trovare lo Steam ID di un giocatore:

1. Vai al profilo Steam del giocatore
2. Se l'URL del profilo utilizza un nome personalizzato, usa uno strumento di ricerca SteamID per trovare il loro SteamID64
3. Il SteamID64 è un numero di 17 cifre che inizia con 7656119

Aggiungere Admin In Gioco

Se sei già un admin, puoi aggiungere altri admin usando il comando chat in gioco:

/admin <playerName>

Questo aggiunge il giocatore specificato alla lista admin immediatamente senza richiedere un riavvio del server.

Comandi Admin Comuni

I comandi admin vengono inseriti nella chat in gioco (premi Invio per aprire la chat) con il prefisso /. Questi possono essere eseguiti anche dalla console del server in GPanel.

Gestione Giocatori

Controllo Server

Teletrasporto e Navigazione

Gestione della Galassia

Come admin, hai strumenti per gestire la struttura della galassia e i settori.

Gestione dei Settori

Livelli dei Materiali

La galassia di Avorion è organizzata in anelli di livelli di materiali crescenti, che si irradiano verso l'interno in direzione della barriera al centro. Comprendere questo aiuta quando si teletrasportano giocatori o si gestiscono i contenuti dei settori.

Supporto Mod e Workshop

Avorion ha un robusto supporto per lo Steam Workshop, che ti permette di estendere il tuo server con mod create dalla community.

Installazione delle Mod

1. Trova la mod che desideri sullo Steam Workshop per Avorion
2. Annota l'ID Workshop dall'URL della mod (il numero alla fine)
3. Ferma il server in GPanel
4. Apri il File Manager di GPanel
5. Naviga nella directory galaxies/your_galaxy_name/
6. Modifica il file modconfig.lua (crealo se non esiste)
7. Aggiungi l'ID Workshop della mod alla configurazione
8. Avvia il server — la mod verrà scaricata automaticamente

Formato di modconfig.lua

-- Avorion Mod Configuration
modLocation = ""
forceEnabling = false

mods =
{
    {workshopid = "1234567890"},
    {workshopid = "0987654321"},
    {workshopid = "1122334455"},
}

Consigli per la Gestione delle Mod

• Aggiungi le mod una alla volta e testa dopo ogni aggiunta per identificare problemi di compatibilità
• Alcune mod richiedono un reset della galassia per avere pieno effetto (specialmente quelle che modificano la generazione dei settori)
• Controlla i commenti e le descrizioni delle mod per incompatibilità note prima dell'installazione
• Mantieni un backup del tuo modconfig.lua e della cartella della galassia prima di aggiungere o rimuovere mod
• Le mod solo lato server non richiedono l'installazione da parte dei client, ma la maggior parte delle mod di gameplay necessita di entrambi i lati

Risoluzione dei Problemi

Il Server Non Appare nel Browser

1. Verifica che listed=true nel tuo server.ini o nelle variabili di avvio
2. Controlla che la porta query di Steam (steamQueryPort) sia accessibile — tipicamente è la porta di gioco + 1
3. Attendi 2-3 minuti dopo l'avvio del server affinché la lista Steam si propaghi
4. Prova a connetterti tramite Direct Connect per confermare che il server è in esecuzione
5. Assicurati che il server sia completamente avviato controllando Server startup complete nella console

Crash del Server

Se il tuo server Avorion va in crash, segui questi passaggi:

1. Controlla i log dei crash — Cerca nella console di GPanel e nella cartella logs/ all'interno della directory della galassia per messaggi di errore
2. Rimuovi le mod aggiunte di recente — Se i crash sono iniziati dopo l'aggiunta di una mod, rimuovila da modconfig.lua e riavvia
3. Controlla la corruzione dei settori — Se il crash si verifica quando si carica un settore specifico, quel settore potrebbe essere corrotto. Usa /regeneratesector dalla console (se accessibile) o elimina il file del settore dalla cartella sectors/
4. Aggiorna il server — Assicurati che il server stia eseguendo l'ultima versione tramite GPanel
5. Riduci i thread di lavoro — Se il server sta esaurendo le risorse, prova a ridurre workerThreads e generatorThreads in server.ini
6. Ripristina da backup — Se tutto il resto fallisce, ripristina la cartella della galassia da un backup effettuato prima dell'inizio dei problemi

Problemi di Prestazioni

• Tick time elevato — Usa /status per controllare le prestazioni del server. Tick time elevati indicano che il server fatica a stare al passo con le richieste della simulazione.
• Troppi settori caricati — Ogni settore con giocatori o IA attiva consuma risorse. Incoraggia i giocatori a evitare di sparpagliarsi troppo nella galassia contemporaneamente.
• Navi grandi — Navi con un numero eccessivo di blocchi aumentano il carico della simulazione. Considera di impostare linee guida per le dimensioni massime delle navi.
• Spam di stazioni — Molte stazioni costruite dai giocatori in un singolo settore possono degradare le prestazioni. Monitora il conteggio delle entità del settore con /sector.

Problemi di Connessione dei Giocatori

• Versione non corrispondente — Tutti i giocatori devono avere la stessa versione del gioco del server. Assicurati che tutti abbiano aggiornato tramite Steam.
• Mod non corrispondenti — I giocatori necessitano delle stesse mod installate. Se un giocatore non riesce a connettersi, verifica che la sua lista mod corrisponda al modconfig.lua del server.
• Errori di timeout — Possono indicare sovraccarico del server o problemi di rete. Controlla le prestazioni del server con /status.
• Problemi di password — Se i giocatori segnalano che la password non funziona, verifica che la password nelle variabili di avvio e in server.ini corrispondano.

Riferimento Rapido

I comandi admin più comunemente usati per la gestione quotidiana del server:

# Check server health
/status

# See who is online
/players

# Save all data
/save

# Broadcast a message
/say Server restarting in 5 minutes!

# Kick a player
/kick PlayerName

# Ban a player
/ban PlayerName

# Teleport to a player
/tp PlayerName

# Give resources to a player
/give PlayerName 10000 Trinium

# View current sector info
/sector

# Check galaxy seed
/seed

# Safely shut down
/stop

Articoli Correlati

• Guida alla Configurazione del Server Avorion
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File tramite SFTP
• Iniziare con il Tuo Nuovo Server

Hai Bisogno di Aiuto?

Se hai bisogno di ulteriore assistenza con l'amministrazione del server Avorion o hai domande su comandi specifici, il nostro team di supporto è pronto ad aiutarti. Invia un ticket di supporto e risponderemo il prima possibile.