Questa guida copre i comandi della console headless, la gestione delle sessioni, la configurazione del mod loader e la risoluzione dei problemi per il tuo server Resonite. Per la configurazione iniziale, consulta Guida alla configurazione del server headless Resonite.
1. Comandi della console headless
Il server headless di Resonite accetta comandi tramite la console di GPanel. Il server risponde al comando shutdown per uno spegnimento controllato.
| Comando | Descrizione |
|---|---|
worlds |
Elenca tutte le sessioni di mondo attive. |
focus <world_index> |
Mette a fuoco un mondo specifico per i comandi. |
status |
Mostra lo stato del mondo a fuoco. |
users |
Elenca gli utenti nel mondo a fuoco. |
kick <username> |
Espelle un utente dal mondo a fuoco. |
ban <username> |
Banna un utente dal mondo a fuoco. |
silence <username> |
Silenzia un utente nel mondo a fuoco. |
unsilence <username> |
Riattiva l'audio di un utente. |
respawn <username> |
Fa rinascere un utente all'origine del mondo. |
role <username> <role> |
Imposta il ruolo di un utente (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Rinomina la sessione a fuoco. |
accessLevel <level> |
Modifica chi può unirsi (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Modifica il numero massimo di utenti per il mondo a fuoco. |
save |
Salva il mondo a fuoco. |
close |
Chiude il mondo a fuoco. |
restart |
Riavvia il mondo a fuoco. |
invite <username> |
Invita un utente nel mondo a fuoco. |
message <text> |
Invia un messaggio al mondo a fuoco. |
shutdown |
Spegne in modo controllato l'intero server headless. |
2. Livelli di accesso
Controlla chi può unirsi alle sessioni del tuo mondo con l'impostazione accessLevel:
| Livello | Descrizione |
|---|---|
| Anyone | Aperto a tutti gli utenti Resonite. |
| RegisteredUsers | Solo account Resonite registrati. |
| Contacts | Solo utenti nell'elenco contatti dell'account headless. |
| ContactsPlus | Contatti e contatti dei contatti. |
| Private | Solo su invito. |
3. Ruoli utente
Assegna ruoli per controllare cosa possono fare gli utenti nel tuo mondo:
| Ruolo | Descrizione |
|---|---|
| Admin | Controllo completo sul mondo. |
| Builder | Può costruire e modificare oggetti. |
| Moderator | Può espellere/bannare utenti e moderare la chat. |
| Guest | Accesso utente standard. |
| Spectator | Può osservare ma non interagire. |
Imposta i ruoli predefiniti in Config.json utilizzando defaultUserRoles o assegnali per utente con il comando della console role.
4. Mondi multipli
Il server headless può ospitare più mondi contemporaneamente. Aggiungi ulteriori voci all'array startWorlds in Headless/Config/Config.json:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]Usa focus 0 e focus 1 nella console per passare da un mondo all'altro.
5. Mod Loader
Resonite supporta le mod tramite ResoniteModLoader. Per abilitarlo:
- Imposta
ENABLE_MODLOADERsutruenella scheda Startup. - Reinstalla o riavvia il server -- i DLL del mod loader verranno scaricati automaticamente.
- Posiziona i DLL delle mod nella directory
rml_mods/tramite SFTP. - Riavvia il server per caricare le mod.
File del mod loader:
Libraries/ResoniteModLoader.dll-- Il mod loader principale.rml_libs/0Harmony.dll-- Dipendenza richiesta.rml_mods/-- Posiziona qui i DLL delle tue mod.
6. Risoluzione dei problemi
- Server non si avvia: Verifica che le credenziali di accesso in
Config.jsonsiano corrette. Il server headless deve autenticarsi con un account Resonite valido. - Mondo non visibile nel browser: Controlla che
hideFromPublicListingnon sia impostato sutrue. Assicurati cheaccessLevelconsenta agli utenti che stanno cercando. - "World running..." non appare: Controlla la console per gli errori. Il nome del preset del mondo potrebbe essere errato.
- Mod non caricano: Verifica che
ENABLE_MODLOADERsiatruee che i DLL delle mod siano inrml_mods/. Controlla la console per gli errori del mod loader. - Uso elevato delle risorse: Riduci
tickRateinConfig.jsono abbassamaxConcurrentAssetTransfers. I contenuti complessi creati dagli utenti possono essere intensivi in termini di risorse.
Articoli correlati
- Guida alla configurazione del server headless Resonite
- Come trovare l'IP e la porta del tuo server
- Come caricare file tramite SFTP
Hai bisogno di aiuto?
Se hai bisogno di ulteriore assistenza, apri un ticket di supporto con i dettagli del tuo server e qualsiasi messaggio di errore dalla console di GPanel.
