Deze handleiding behandelt headless-consolecommando's, sessiebeheer, mod loader-installatie en probleemoplossing voor je Resonite-server. Zie voor de initiële installatie de Resonite Headless Server Installatiehandleiding.
1. Headless-consolecommando's
De Resonite headless server accepteert commando's via de GPanel-console. De server reageert op het shutdown-commando voor een veilige afsluiting.
| Commando | Beschrijving |
|---|---|
worlds |
Toon alle actieve wereldsessies. |
focus <world_index> |
Focus op een specifieke wereld voor commando's. |
status |
Toon de status van de gefocuste wereld. |
users |
Toon gebruikers in de gefocuste wereld. |
kick <username> |
Verwijder een gebruiker uit de gefocuste wereld. |
ban <username> |
Verban een gebruiker uit de gefocuste wereld. |
silence <username> |
Demp een gebruiker in de gefocuste wereld. |
unsilence <username> |
Maak het dempen van een gebruiker ongedaan. |
respawn <username> |
Respawn een gebruiker naar het oorsprongspunt van de wereld. |
role <username> <role> |
Stel de rol van een gebruiker in (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Hernoem de gefocuste sessie. |
accessLevel <level> |
Wijzig wie kan deelnemen (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Wijzig het maximaal aantal gebruikers voor de gefocuste wereld. |
save |
Sla de gefocuste wereld op. |
close |
Sluit de gefocuste wereld. |
restart |
Herstart de gefocuste wereld. |
invite <username> |
Nodig een gebruiker uit voor de gefocuste wereld. |
message <text> |
Stuur een bericht naar de gefocuste wereld. |
shutdown |
Sluit de volledige headless server veilig af. |
2. Toegangsniveaus
Bepaal wie kan deelnemen aan je wereldsessies met de accessLevel-instelling:
| Niveau | Beschrijving |
|---|---|
| Anyone | Open voor alle Resonite-gebruikers. |
| RegisteredUsers | Alleen geregistreerde Resonite-accounts. |
| Contacts | Alleen gebruikers op de contactlijst van het headless-account. |
| ContactsPlus | Contacten en contacten van contacten. |
| Private | Alleen op uitnodiging. |
3. Gebruikersrollen
Wijs rollen toe om te bepalen wat gebruikers in je wereld kunnen doen:
| Rol | Beschrijving |
|---|---|
| Admin | Volledige controle over de wereld. |
| Builder | Kan objecten bouwen en aanpassen. |
| Moderator | Kan gebruikers verwijderen/verbannen en chat modereren. |
| Guest | Standaard gebruikerstoegang. |
| Spectator | Kan observeren maar niet interacteren. |
Stel standaardrollen in via Config.json met defaultUserRoles of wijs ze per gebruiker toe met het role-consolecommando.
4. Meerdere werelden
De headless server kan meerdere werelden tegelijkertijd hosten. Voeg extra vermeldingen toe aan de startWorlds-array 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"
}
]Gebruik focus 0 en focus 1 in de console om tussen werelden te schakelen.
5. Mod Loader
Resonite ondersteunt mods via ResoniteModLoader. Om in te schakelen:
- Stel
ENABLE_MODLOADERin optrueop het Startup-tabblad. - Herinstalleer of herstart de server -- de mod loader DLL's worden automatisch gedownload.
- Plaats mod-DLL's in de
rml_mods/-map via SFTP. - Herstart de server om de mods te laden.
Mod loader-bestanden:
Libraries/ResoniteModLoader.dll-- De hoofd-mod loader.rml_libs/0Harmony.dll-- Vereiste afhankelijkheid.rml_mods/-- Plaats hier je mod-DLL's.
6. Probleemoplossing
- Server start niet: Controleer of de inloggegevens in
Config.jsoncorrect zijn. De headless moet authenticeren met een geldig Resonite-account. - Wereld verschijnt niet in browser: Controleer of
hideFromPublicListingniet optruestaat. Zorg ervoor dataccessLevelde zoekende gebruikers toestaat. - "World running..." verschijnt niet: Controleer de console op fouten. De naam van de wereldpreset kan onjuist zijn.
- Mods laden niet: Controleer of
ENABLE_MODLOADERoptruestaat en mod-DLL's inrml_mods/staan. Controleer de console op mod loader-fouten. - Hoog resourcegebruik: Verlaag
tickRateinConfig.jsonof verlaagmaxConcurrentAssetTransfers. Complexe door gebruikers gemaakte content kan resource-intensief zijn.
Gerelateerde artikelen
- Resonite Headless Server Installatiehandleiding
- Hoe je je server-IP en poort vindt
- Bestanden uploaden via SFTP
Hulp nodig?
Als je verdere hulp nodig hebt, open een supportticket met je servergegevens en eventuele foutmeldingen uit de GPanel-console.
