Questa guida illustra come configurare il tuo server headless Resonite ospitato con Legion Hosting. Resonite è una piattaforma sociale VR dove gli utenti possono costruire, creare e socializzare in mondi generati dagli utenti. Per la gestione delle sessioni e i comandi admin, consulta Guida admin server Resonite.
1. Accedere al tuo server
- Accedi a GPanel.
- Seleziona il tuo server Resonite dall'elenco dei server.
- Il tuo server viene gestito tramite la scheda Console in GPanel e la configurazione headless di Resonite.
Nota: Le porte vengono assegnate casualmente a meno che tu non disponga di un IP privato. I server headless di Resonite utilizzano principalmente un file di configurazione JSON e il browser delle sessioni per le connessioni, ma la porta assegnata viene comunque utilizzata per la comunicazione di rete.
2. Variabili di avvio
Configura queste impostazioni dalla scheda Startup in GPanel:
| Variabile | Nome Env | Predefinito | Descrizione |
|---|---|---|---|
| Abilita Mod Loader | ENABLE_MODLOADER |
false | Abilita ResoniteModLoader per le mod personalizzate (true/false). |
| Aggiornamento automatico | AUTO_UPDATE |
1 | Aggiorna automaticamente il server all'avvio (1=sì, 0=no). |
Importante: Il server headless di Resonite richiede un abbonamento Patreon con accesso headless. È necessaria una password beta (ottenuta inviando un messaggio al bot Resonite in-game con
/headlessCode) per l'installazione. Questa viene configurata dal provider di hosting.
3. File di configurazione
Il file di configurazione principale è Headless/Config/Config.json. Modificalo tramite SFTP. Impostazioni chiave:
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. Riferimento alle impostazioni di Config.json
| Impostazione | Predefinito | Descrizione |
|---|---|---|
tickRate | 60.0 | Tick rate della simulazione del server. |
maxConcurrentAssetTransfers | 4 | Numero massimo di download di asset simultanei. |
loginCredential | (vuoto) | Nome utente dell'account Resonite per il server headless. |
loginPassword | (vuoto) | Password dell'account Resonite. |
5. Configurazione del mondo
Ogni voce nell'array startWorlds definisce una sessione di mondo. Impostazioni chiave del mondo:
| Impostazione | Predefinito | Descrizione |
|---|---|---|
isEnabled | true | Indica se questo mondo deve essere avviato. |
sessionName | null | Nome visualizzato per la sessione. |
maxUsers | 32 | Numero massimo di utenti nel mondo. |
accessLevel | Anyone | Chi può unirsi: Anyone, RegisteredUsers, Contacts, ContactsPlus, Private. |
loadWorldPresetName | SpaceWorld | Preset del mondo da caricare (es. SpaceWorld, Grid, BasicEmpty). |
loadWorldURL | null | URL di un mondo personalizzato da caricare al posto di un preset. |
autoRecover | true | Recupera automaticamente il mondo dopo un crash. |
autoSleep | true | Mette il mondo in standby quando non ci sono utenti presenti. |
saveOnExit | false | Salva lo stato del mondo quando il server viene spento. |
autosaveInterval | -1.0 | Intervallo di salvataggio automatico in secondi (-1 = disabilitato). |
hideFromPublicListing | null | Nascondi questa sessione dall'elenco pubblico. |
awayKickMinutes | -1.0 | Minuti prima che gli utenti AFK vengano espulsi (-1 = disabilitato). |
idleRestartInterval | -1.0 | Riavvia il mondo dopo questo numero di secondi di inattività (-1 = disabilitato). |
forcedRestartInterval | -1.0 | Forza il riavvio dopo questo numero di secondi indipendentemente dagli utenti (-1 = disabilitato). |
6. Connettersi al tuo server
- Avvia Resonite sul tuo PC o visore VR.
- Apri il Session Browser (Dash Menu > Worlds).
- Cerca il tuo server per nome della sessione.
- Clicca su Join per entrare nel mondo.
Per le sessioni private, l'account headless deve invitare gli utenti o utilizzare autoInviteUsernames nel config.
7. Checklist di prima configurazione
- Modifica
Headless/Config/Config.jsonper impostareloginCredentialeloginPasswordper il tuo account Resonite. - Imposta un
sessionNameper il tuo mondo. - Scegli un
loadWorldPresetNameo fornisci unloadWorldURLper un mondo personalizzato. - Imposta l'
accessLevelper controllare chi può unirsi. - Avvia il server e verifica che mostri
World running...nella console.
Articoli correlati
- Guida admin server Resonite
- Come trovare l'IP e la porta del tuo server
- Come caricare file tramite SFTP
Hai bisogno di aiuto?
Se riscontri problemi con il tuo server Resonite, apri un ticket di supporto e includi i dettagli del tuo server, una descrizione del problema e qualsiasi messaggio di errore dalla console di GPanel.
