Questa guida copre i comandi della console headless, la gestione dei mondi, i ruoli utente, il NeosModLoader e la risoluzione dei problemi per il tuo server dedicato NeosVR. NeosVR è un metaverso VR sociale con potenti strumenti di creazione. Per la configurazione iniziale, la configurazione di Config.json e le istruzioni di connessione, consulta Guida alla configurazione del server NeosVR.
1. Accesso alla console
Gestisci il tuo server headless NeosVR tramite la scheda Console in GPanel. Tutti i comandi vengono digitati direttamente nella console.
2. Comandi della console headless
Gestione dei mondi
| Comando | Descrizione |
|---|---|
worlds | Elenca tutti i mondi in esecuzione con i loro indici. |
focus <world_index> | Cambia il focus su un mondo specifico tramite indice. |
startWorldURL <record_url> | Avvia un nuovo mondo da un URL di record Neos. |
startWorldTemplate <template> | Avvia un mondo da un template integrato (es. SpaceWorld). |
save | Salva il mondo attualmente in focus. |
close | Chiude il mondo attualmente in focus. |
restart | Riavvia il mondo attualmente in focus. |
Gestione della sessione
| Comando | Descrizione |
|---|---|
sessionURL | Mostra l'URL della sessione per il mondo in focus. |
sessionID | Mostra l'ID della sessione per il mondo in focus. |
name <new_name> | Cambia il nome della sessione del mondo in focus. |
accessLevel <level> | Cambia il livello di accesso: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Imposta il numero massimo di utenti per la sessione. |
hideFromListing <true/false> | Attiva/disattiva la visibilità nel browser pubblico delle sessioni. |
description <text> | Imposta la descrizione della sessione. |
Gestione degli utenti
| Comando | Descrizione |
|---|---|
users | Elenca tutti gli utenti nel mondo in focus. |
kick <username> | Espelle un utente dal mondo. |
ban <username> | Banna un utente dal mondo. |
silence <username> | Silenzia un utente (mute della voce). |
unsilence <username> | Rimuove il silenzio da un utente precedentemente mutato. |
respawn <username> | Fa rinascere un utente al punto di spawn del mondo. |
role <username> <role> | Assegna un ruolo a un utente (vedi Sezione 3). |
Controllo del server
| Comando | Descrizione |
|---|---|
status | Mostra lo stato del server e l'utilizzo delle risorse. |
shutdown | Spegne in modo controllato il server headless. |
gc | Forza la garbage collection per liberare memoria. |
tickRate <rate> | Cambia il tick rate del server in runtime. |
3. Ruoli utente
NeosVR utilizza una gerarchia di ruoli per i permessi dei mondi:
| Ruolo | Descrizione |
|---|---|
Admin | Controllo completo del mondo. Può modificare qualsiasi cosa, gestire utenti e cambiare le impostazioni del mondo. |
Builder | Può creare e modificare oggetti nel mondo. |
Moderator | Può espellere/bannare utenti e gestire le impostazioni della sessione. |
Guest | Accesso di base. Può interagire con gli oggetti esistenti ma non può costruire. |
Spectator | Accesso solo in visualizzazione. Non può interagire con il mondo. |
Assegna i ruoli tramite la console: role <username> Admin
Puoi anche impostare i ruoli predefiniti in Config.json utilizzando l'impostazione defaultUserRoles.
4. NeosModLoader
NeosModLoader consente di caricare mod create dalla community nel server headless.
- Imposta ENABLE_MODLOADER su
truenelle variabili Startup di GPanel. - Scarica le mod dal GitHub di NeosModLoader.
- Carica i file
.dlldelle mod nella directorynml_mods/via SFTP. - Riavvia il server per caricare le mod.
5. Risoluzione dei problemi
Il server non si avvia
- Verifica che STEAM_USER e STEAM_PASS siano corretti.
- Assicurati che SRCDS_BETAPASS (password beta headless) sia aggiornata dal Discord Patreon di Neos.
- Se usi Steam Guard 2FA, fornisci il codice in STEAM_AUTH e riavvia tempestivamente.
Il mondo non si carica
- Controlla che
Config.jsonsia JSON valido (senza virgole finali, parentesi corrette). - Verifica che
loginCredentialeloginPasswordsiano impostati correttamente inConfig/Config.json. - Assicurati che l'URL del mondo o il nome del preset sia valido.
Gli utenti non riescono a unirsi
- Controlla che
accessLevelnon sia impostato suPrivatea meno che non sia voluto. - Verifica che
maxUsersnon sia stato raggiunto. - Assicurati che il server headless sia loggato (controlla l'output della console per la conferma del login).
Articoli correlati
- Guida alla configurazione del server NeosVR
- Come trovare l'IP e la porta del tuo server
- Come caricare file via SFTP
Hai bisogno di aiuto?
Se riscontri problemi con il tuo server NeosVR che non sono trattati qui, apri un ticket di supporto e includi l'IP del tuo server, una descrizione del problema ed eventuali messaggi di errore rilevanti dalla console GPanel.
