Questa guida copre la configurazione admin, i comandi della console, il sistema di pacchetti Lua, la gestione dei giocatori e dei veicoli e la configurazione del database per il tuo server dedicato Onset su Legion Hosting. Per la configurazione iniziale del server, consulta la nostra Guida alla configurazione del server Onset.
Configurazione Admin
Onset gestisce i privilegi di amministratore tramite scripting Lua all'interno dei pacchetti del game mode. A differenza di molti giochi con sistemi admin integrati, Onset si affida ai pacchetti per definire chi ha i permessi elevati e cosa tali permessi consentono.
La maggior parte dei pacchetti di game mode della community include un sistema admin. Tipicamente, la configurazione admin prevede:
- Apri il File Manager in GPanel
- Naviga nella directory del tuo pacchetto (es.
packages/mygamemode/) - Individua il file di configurazione admin (spesso
config.lua,admins.luao un file JSON di configurazione) - Aggiungi il tuo Steam64 ID o l'ID giocatore in-game alla lista admin
- Salva il file e riavvia il server
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Comandi della console del server
Onset fornisce comandi della console del server integrati che funzionano indipendentemente dai pacchetti installati. Possono essere inseriti direttamente nella console di GPanel.
| Comando | Descrizione |
|---|---|
help |
Elenca tutti i comandi della console disponibili |
stop |
Arresta il server in modo controllato |
restart |
Riavvia il server |
players |
Elenca tutti i giocatori connessi con i loro ID |
kick <playerid> [reason] |
Espelle un giocatore dal server |
ban <playerid> [reason] |
Banna un giocatore dal server |
unban <steamid> |
Rimuove un ban per l'ID Steam specificato |
package reload <name> |
Ricarica un pacchetto senza riavviare il server |
package start <name> |
Avvia un pacchetto che non è attualmente in esecuzione |
package stop <name> |
Arresta un pacchetto in esecuzione |
package list |
Elenca tutti i pacchetti caricati e il loro stato |
Sistema di pacchetti (Scripting Lua)
Il gameplay di Onset è definito interamente da pacchetti scritti in Lua. Ogni pacchetto è una cartella all'interno della directory packages/ contenente script Lua che vengono eseguiti sul lato server e/o client.
Struttura del pacchetto
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scriptsInstallazione dei pacchetti
- Scarica il pacchetto dai forum della community Onset o dai repository GitHub
- Connettiti al tuo server tramite SFTP
- Carica la cartella del pacchetto nella directory
packages/ - Apri
server_config.jsonnel File Manager - Aggiungi il nome della cartella del pacchetto all'array
"packages" - Riavvia il server tramite GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" vengono caricati nell'ordine in cui sono elencati. Se un pacchetto dipende da un altro, assicurati che la dipendenza sia elencata per prima.
Gestione dei giocatori
Oltre ai comandi integrati di kick e ban, la maggior parte dei pacchetti di game mode fornisce funzionalità aggiuntive di gestione dei giocatori. I comandi comuni forniti dai pacchetti includono:
| Comando (Dipendente dal pacchetto) | Descrizione |
|---|---|
/tp <player> |
Teletrasporta verso un altro giocatore |
/bring <player> |
Teletrasporta un altro giocatore nella tua posizione |
/goto <x> <y> <z> |
Teletrasporta a coordinate del mondo specifiche |
/setadmin <player> <level> |
Imposta il livello admin di un giocatore (se il pacchetto supporta i livelli) |
/announce <message> |
Invia un annuncio a tutto il server |
Gestione dei veicoli
Onset include un sistema di veicoli integrato che i pacchetti possono estendere. Gli admin comunemente devono gestire i veicoli generati per evitare disordine sul server.
- Spawn dei veicoli — La maggior parte dei pacchetti RP consente agli admin di generare veicoli tramite comandi come
/car <model> - Pulizia dei veicoli — Alcuni pacchetti includono l'auto-despawn per veicoli abbandonati o comandi admin come
/destroyvehicles - Limiti dei veicoli — Configura il numero massimo di veicoli per giocatore per prevenire lag causati da troppi entità generate
Database (MariaDB)
Onset supporta connessioni a database MariaDB/MySQL per l'archiviazione persistente dei dati. Questo viene utilizzato dai pacchetti roleplay e altri game mode per memorizzare dati dei giocatori, inventari, proprietà e altro.
La configurazione del database viene gestita all'interno dei file di configurazione del tuo pacchetto. Una configurazione tipica:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Il server si avvia ma non c'è gameplay disponibile | Hai bisogno di almeno un pacchetto di game mode installato ed elencato in server_config.json. Un server Onset puro non ha gameplay integrato. |
| Il pacchetto non si carica | Controlla la console GPanel per i messaggi di errore Lua. Cause comuni: package.json mancante, errori di sintassi nei file Lua o dipendenze mancanti. |
| Errori di connessione al database | Verifica le credenziali del database, assicurati che il database esista e controlla che il servizio MariaDB sia in esecuzione. Testa la connettività dai log della console. |
| Server non visibile nel browser | Assicurati che "visible": true sia impostato in server_config.json. Verifica anche che la porta 7776 (TCP) sia accessibile per la porta query. |
| Alta latenza o lag | Abbassa il valore streamdistance, riduci tickrate se l'uso della CPU è elevato e controlla la presenza di script Lua inefficienti nei tuoi pacchetti. |
Articoli correlati
- Guida alla configurazione del server Onset
- Come trovare l'IP e la porta del tuo server
- Come caricare file tramite SFTP
- Per iniziare con il tuo nuovo server
Hai bisogno di aiuto?
Se stai riscontrando problemi con il tuo server Onset o hai bisogno di ulteriore assistenza, il nostro team di supporto è qui per aiutarti. Apri un ticket di supporto e ti risponderemo il prima possibile.
