Deze handleiding behandelt headless console-commando's, wereldbeheer, gebruikersrollen, de NeosModLoader en probleemoplossing voor je NeosVR dedicated server. NeosVR is een sociale VR-metaverse met krachtige creatietools. Voor de eerste installatie, Config.json-configuratie en verbindingsinstructies, zie NeosVR Server Installatiehandleiding.
1. Toegang tot de Console
Beheer je NeosVR headless server via het tabblad Console in GPanel. Alle commando's worden direct in de console getypt.
2. Headless Console-commando's
Wereldbeheer
| Commando | Beschrijving |
|---|---|
worlds | Toon alle actieve werelden met hun indices. |
focus <world_index> | Schakel de focus naar een specifieke wereld op basis van index. |
startWorldURL <record_url> | Start een nieuwe wereld vanuit een Neos record-URL. |
startWorldTemplate <template> | Start een wereld vanuit een ingebouwd sjabloon (bijv. SpaceWorld). |
save | Sla de momenteel gefocuste wereld op. |
close | Sluit de momenteel gefocuste wereld. |
restart | Herstart de momenteel gefocuste wereld. |
Sessiebeheer
| Commando | Beschrijving |
|---|---|
sessionURL | Toon de sessie-URL voor de gefocuste wereld. |
sessionID | Toon het sessie-ID voor de gefocuste wereld. |
name <new_name> | Wijzig de sessienaam van de gefocuste wereld. |
accessLevel <level> | Wijzig het toegangsniveau: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Stel het maximale aantal gebruikers voor de sessie in. |
hideFromListing <true/false> | Schakel zichtbaarheid in de openbare sessiebrowser in of uit. |
description <text> | Stel de sessiebeschrijving in. |
Gebruikersbeheer
| Commando | Beschrijving |
|---|---|
users | Toon alle gebruikers in de gefocuste wereld. |
kick <username> | Verwijder een gebruiker uit de wereld. |
ban <username> | Verban een gebruiker uit de wereld. |
silence <username> | Demp een gebruiker (schakel hun stem uit). |
unsilence <username> | Hef de demping van een eerder gedempte gebruiker op. |
respawn <username> | Laat een gebruiker opnieuw verschijnen op het spawnpunt van de wereld. |
role <username> <role> | Wijs een rol toe aan een gebruiker (zie Sectie 3). |
Serverbeheer
| Commando | Beschrijving |
|---|---|
status | Toon serverstatus en resourcegebruik. |
shutdown | Sluit de headless server netjes af. |
gc | Forceer garbage collection om geheugen vrij te maken. |
tickRate <rate> | Wijzig de server tick rate tijdens runtime. |
3. Gebruikersrollen
NeosVR gebruikt een rolhiërarchie voor wereldpermissies:
| Rol | Beschrijving |
|---|---|
Admin | Volledige wereldcontrole. Kan alles wijzigen, gebruikers beheren en wereldinstellingen aanpassen. |
Builder | Kan objecten in de wereld aanmaken en bewerken. |
Moderator | Kan gebruikers kicken/bannen en sessie-instellingen beheren. |
Guest | Basistoegang. Kan interactie hebben met bestaande objecten maar kan niet bouwen. |
Spectator | Alleen-lezen toegang. Kan geen interactie hebben met de wereld. |
Wijs rollen toe via de console: role <username> Admin
Je kunt ook standaardrollen instellen in Config.json met de instelling defaultUserRoles.
4. NeosModLoader
NeosModLoader maakt het mogelijk om door de community gemaakte mods in de headless server te laden.
- Stel ENABLE_MODLOADER in op
truein de GPanel Startup-variabelen. - Download mods van de NeosModLoader GitHub.
- Upload mod
.dll-bestanden naar de mapnml_mods/via SFTP. - Herstart de server om de mods te laden.
5. Probleemoplossing
Server Start Niet
- Controleer of je STEAM_USER en STEAM_PASS correct zijn.
- Zorg ervoor dat het SRCDS_BETAPASS (headless beta-wachtwoord) up-to-date is vanuit de Neos Patreon Discord.
- Als je Steam Guard 2FA gebruikt, voer dan de code in bij STEAM_AUTH en herstart snel.
Wereld Laadt Niet
- Controleer of
Config.jsongeldige JSON is (geen achterliggende komma's, juiste haakjes). - Controleer of de
loginCredentialenloginPasswordcorrect zijn ingesteld inConfig/Config.json. - Zorg ervoor dat de wereld-URL of preset-naam geldig is.
Gebruikers Kunnen Niet Deelnemen
- Controleer of het
accessLevelniet opPrivatestaat, tenzij dit de bedoeling is. - Controleer of
maxUsersniet is bereikt. - Zorg ervoor dat de headless is ingelogd (controleer de console-uitvoer voor inlogbevestiging).
Gerelateerde Artikelen
- NeosVR Server Installatiehandleiding
- Hoe Je Je Server IP en Poort Vindt
- Hoe Je Bestanden Uploadt via SFTP
Hulp Nodig?
Als je problemen ondervindt met je NeosVR-server die hier niet worden behandeld, open dan een supportticket en vermeld je server-IP, een beschrijving van het probleem en eventuele relevante foutmeldingen uit de GPanel-console.
