This guide covers server administration for Modiverse, including RCON access, map cycle management, Workshop content, player management, and troubleshooting.
RCON Access
Modiverse supports RCON (Remote Console) for server administration. The RCON password is configured in ServerConfiguration.json:
KJMod/Binaries/Linux/ServerData/ServerConfiguration.jsonThe rconPassword field controls access:
"rconPassword": "your_secure_password_here"cHangeRC0nPasswOrD) to a unique, secure password. The default is publicly known.
Server Console
The GPanel Console tab displays server output. Monitor it for player connections, game mode changes, and error messages. The server stops gracefully using GPanel's Stop button.
Map Cycle Management
The map cycle determines which game modes and maps the server rotates through. Each entry in the mapCycle array in ServerConfiguration.json defines one rotation step.
Adding a New Game Mode/Map
- Stop the server from GPanel.
- Browse the Modiverse Steam Workshop to find game modes and maps.
- Note the Workshop ID from the item URL (the number in
?id=XXXXXXXXXX). - Edit
ServerConfiguration.jsonand add a new entry to themapCyclearray:
{
"gameMode": "WORKSHOP_ID_OF_GAMEMODE",
"comment": "Mode Name, Map Name",
"map": "WORKSHOP_ID_OF_MAP",
"assets": ["WORKSHOP_ID_OF_REQUIRED_ASSETS"],
"duration": 1800
}Duration Settings
The duration field sets round length in seconds:
- 900 -- 15 minutes (short rounds)
- 1800 -- 30 minutes (standard)
- 3600 -- 60 minutes (long rounds)
Server PIN
Control server access with the pin field in ServerConfiguration.json:
- Set a numeric PIN (e.g.,
"pin": "1234") to require a password to join. - Set to
"0000"or empty for a public server.
Message of the Day (MOTD)
Display a custom message to players when they join:
motdURL-- URL to an HTML page that displays as the MOTD. Host this on your own web server or use any publicly accessible URL.motdDelay-- Seconds to wait before showing the MOTD (default: 5).
Workshop Content Management
The server automatically downloads Workshop items referenced in the map cycle. If content fails to download:
- Verify the Workshop IDs are correct.
- Check that the Workshop items are public and not deleted.
- Try restarting the server to trigger a re-download.
- Look in the
KJMod/Binaries/Linux/ServerData/directory for downloaded content.
Troubleshooting
| Problem | Solution |
|---|---|
| Server fails to start | Check the console for errors. Verify ServerConfiguration.json is valid JSON. The file is located in KJMod/Binaries/Linux/ServerData/. |
| Workshop content not loading | Verify Workshop IDs are correct and the items are published. Restart the server to retry downloads. |
| Players cannot connect | Ensure the server shows listening on port in the console. Verify IP and port are correct. Check that clients have the required Workshop content subscribed. |
| Map cycle not working | Verify the mapCycle array format is valid JSON. Each entry needs valid gameMode, map, and duration fields. |
| RCON connection refused | Verify you are using the correct RCON password and the server is running. The query port may also be needed for RCON connections. |
