Den här guiden täcker headless-konsolkommandon, världshantering, användarroller, NeosModLoader och felsökning för din dedikerade NeosVR-server. NeosVR är ett socialt VR-metaverse med kraftfulla skapelseverktyg. För grundläggande installation, Config.json-konfiguration och anslutningsinstruktioner, se Installationsguide för NeosVR-server.
1. Komma åt konsolen
Hantera din NeosVR headless-server via fliken Console i GPanel. Alla kommandon skrivs direkt i konsolen.
2. Headless-konsolkommandon
Världshantering
| Kommando | Beskrivning |
|---|---|
worlds | Lista alla körande världar med deras index. |
focus <world_index> | Byt fokus till en specifik värld via index. |
startWorldURL <record_url> | Starta en ny värld från en Neos-record-URL. |
startWorldTemplate <template> | Starta en värld från en inbyggd mall (t.ex. SpaceWorld). |
save | Spara den för närvarande fokuserade världen. |
close | Stäng den för närvarande fokuserade världen. |
restart | Starta om den för närvarande fokuserade världen. |
Sessionshantering
| Kommando | Beskrivning |
|---|---|
sessionURL | Visa sessions-URL:en för den fokuserade världen. |
sessionID | Visa sessions-ID:t för den fokuserade världen. |
name <new_name> | Ändra sessionsnamnet för den fokuserade världen. |
accessLevel <level> | Ändra åtkomstnivå: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Ange det maximala antalet användare för sessionen. |
hideFromListing <true/false> | Växla synlighet i den publika sessionswebbläsaren. |
description <text> | Ange sessionsbeskrivningen. |
Användarhantering
| Kommando | Beskrivning |
|---|---|
users | Lista alla användare i den fokuserade världen. |
kick <username> | Sparka ut en användare från världen. |
ban <username> | Banna en användare från världen. |
silence <username> | Tysta en användare (stäng av deras röst). |
unsilence <username> | Häv tystnaden för en tidigare tystad användare. |
respawn <username> | Respawna en användare vid världens spawnpunkt. |
role <username> <role> | Tilldela en roll till en användare (se avsnitt 3). |
Serverkontroll
| Kommando | Beskrivning |
|---|---|
status | Visa serverstatus och resursanvändning. |
shutdown | Stäng av headless-servern på ett kontrollerat sätt. |
gc | Tvinga garbage collection för att frigöra minne. |
tickRate <rate> | Ändra serverns tick rate under körning. |
3. Användarroller
NeosVR använder en rollhierarki för världsbehörigheter:
| Roll | Beskrivning |
|---|---|
Admin | Fullständig kontroll över världen. Kan ändra vad som helst, hantera användare och ändra världsinställningar. |
Builder | Kan skapa och redigera objekt i världen. |
Moderator | Kan sparka ut/banna användare och hantera sessionsinställningar. |
Guest | Grundläggande åtkomst. Kan interagera med befintliga objekt men kan inte bygga. |
Spectator | Endast visningsåtkomst. Kan inte interagera med världen. |
Tilldela roller via konsolen: role <username> Admin
Du kan också ange standardroller i Config.json med inställningen defaultUserRoles.
4. NeosModLoader
NeosModLoader gör det möjligt att ladda community-skapade mods i headless-servern.
- Ställ in ENABLE_MODLOADER på
truei GPanels Startup-variabler. - Ladda ner mods från NeosModLoader GitHub.
- Ladda upp mod-
.dll-filer till katalogennml_mods/via SFTP. - Starta om servern för att ladda modsen.
5. Felsökning
Servern startar inte
- Kontrollera att din STEAM_USER och STEAM_PASS är korrekta.
- Säkerställ att SRCDS_BETAPASS (lösenordet för headless-betan) är uppdaterat från Neos Patreon Discord.
- Om du använder Steam Guard 2FA, ange koden i STEAM_AUTH och starta om snabbt.
Världen laddas inte
- Kontrollera att
Config.jsonär giltig JSON (inga avslutande kommatecken, korrekta parenteser). - Kontrollera att
loginCredentialochloginPasswordär korrekt inställda iConfig/Config.json. - Säkerställ att världens URL eller förinställningsnamn är giltigt.
Användare kan inte ansluta
- Kontrollera att
accessLevelinte är inställt påPrivateom det inte är avsiktligt. - Kontrollera att
maxUsersinte har uppnåtts. - Säkerställ att headless-klienten är inloggad (kontrollera konsolutdata efter inloggningsbekräftelse).
Relaterade artiklar
- Installationsguide för NeosVR-server
- Så hittar du din servers IP och port
- Så laddar du upp filer via SFTP
Behöver du hjälp?
Om du stöter på problem med din NeosVR-server som inte tas upp här, öppna ett supportärende och inkludera din server-IP, en beskrivning av problemet och eventuella relevanta felmeddelanden från GPanel-konsolen.
