Den här guiden går igenom headless-konsolkommandon, sessionshantering, konfiguration av mod loader och felsökning för din Resonite-server. För den första installationen, se Installationsguide för Resonite headless-server.
1. Headless-konsolkommandon
Resonite headless-servern accepterar kommandon via GPanel-konsolen. Servern svarar på kommandot shutdown för en kontrollerad avstängning.
| Kommando | Beskrivning |
|---|---|
worlds |
Listar alla aktiva världssessioner. |
focus <world_index> |
Fokusera på en specifik värld för kommandon. |
status |
Visa status för den fokuserade världen. |
users |
Listar användare i den fokuserade världen. |
kick <username> |
Sparka ut en användare från den fokuserade världen. |
ban <username> |
Banna en användare från den fokuserade världen. |
silence <username> |
Tysta en användare i den fokuserade världen. |
unsilence <username> |
Häv tystning av en användare. |
respawn <username> |
Återskapa en användare vid världens ursprungspunkt. |
role <username> <role> |
Ange en användares roll (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Byt namn på den fokuserade sessionen. |
accessLevel <level> |
Ändra vem som kan ansluta (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Ändra det maximala antalet användare för den fokuserade världen. |
save |
Spara den fokuserade världen. |
close |
Stäng den fokuserade världen. |
restart |
Starta om den fokuserade världen. |
invite <username> |
Bjud in en användare till den fokuserade världen. |
message <text> |
Skicka ett meddelande till den fokuserade världen. |
shutdown |
Stäng av hela headless-servern på ett kontrollerat sätt. |
2. Åtkomstnivåer
Styr vem som kan ansluta till dina världssessioner med inställningen accessLevel:
| Nivå | Beskrivning |
|---|---|
| Anyone | Öppen för alla Resonite-användare. |
| RegisteredUsers | Endast registrerade Resonite-konton. |
| Contacts | Endast användare på headless-kontots kontaktlista. |
| ContactsPlus | Kontakter och kontakters kontakter. |
| Private | Endast via inbjudan. |
3. Användarroller
Tilldela roller för att styra vad användare kan göra i din värld:
| Roll | Beskrivning |
|---|---|
| Admin | Fullständig kontroll över världen. |
| Builder | Kan bygga och modifiera objekt. |
| Moderator | Kan sparka/banna användare och moderera chatten. |
| Guest | Standardanvändaråtkomst. |
| Spectator | Kan observera men inte interagera. |
Ange standardroller i Config.json med defaultUserRoles eller tilldela dem per användare med konsolkommandot role.
4. Flera världar
Headless-servern kan hosta flera världar samtidigt. Lägg till ytterligare poster i startWorlds-arrayen i 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"
}
]Använd focus 0 och focus 1 i konsolen för att växla mellan världar.
5. Mod Loader
Resonite stöder mods via ResoniteModLoader. För att aktivera:
- Sätt
ENABLE_MODLOADERtilltruepå fliken Startup. - Installera om eller starta om servern -- mod loaderns DLL-filer laddas ned automatiskt.
- Placera mod-DLL:er i katalogen
rml_mods/via SFTP. - Starta om servern för att ladda modsen.
Mod loader-filer:
Libraries/ResoniteModLoader.dll-- Den huvudsakliga mod loadern.rml_libs/0Harmony.dll-- Nödvändigt beroende.rml_mods/-- Placera dina mod-DLL:er här.
6. Felsökning
- Servern startar inte: Verifiera att inloggningsuppgifterna i
Config.jsonär korrekta. Headless-servern måste autentisera med ett giltigt Resonite-konto. - Världen visas inte i bläddraren: Kontrollera att
hideFromPublicListinginte är satt tilltrue. Säkerställ attaccessLeveltillåter de användare som söker. - "World running..." visas inte: Kontrollera om det finns fel i konsolen. Namnet på världsförinställningen kan vara felaktigt.
- Mods laddas inte: Verifiera att
ENABLE_MODLOADERärtrueoch att mod-DLL:erna finns irml_mods/. Kontrollera konsolen efter mod loader-fel. - Hög resursanvändning: Minska
tickRateiConfig.jsoneller sänkmaxConcurrentAssetTransfers. Komplext användargenererat innehåll kan vara resurskrävande.
Relaterade artiklar
- Installationsguide för Resonite headless-server
- Hur du hittar din server-IP och port
- Hur du laddar upp filer via SFTP
Behöver du hjälp?
Om du behöver ytterligare hjälp, öppna ett supportärende med dina serveruppgifter och eventuella felmeddelanden från GPanel-konsolen.
