This guide covers server administration for Mindustry, including console commands, player management, map management, game rules, and mod installation.
Server Console
Mindustry provides a rich set of console commands. Enter them in the GPanel Console tab. The server stops with the exit command (handled by GPanel's Stop button).
Essential Commands
| Command | Description |
|---|---|
help |
Lists all available commands |
host [mapname] [mode] |
Hosts a map with an optional game mode (survival, attack, pvp, sandbox) |
maps |
Lists all available maps |
status |
Shows current server status, map, and player count |
say [message] |
Broadcasts a message to all players |
save [name] |
Saves the current game state to a file |
load [name] |
Loads a previously saved game |
saves |
Lists all saved games |
gameover |
Forces a game over, returning to the lobby |
exit |
Shuts down the server |
Player Management
| Command | Description |
|---|---|
players |
Lists all connected players with their IDs |
kick [player] |
Kicks a player by name or ID |
ban [type] [value] |
Bans a player (by name, IP, or ID) |
unban [ip/id] |
Unbans a player by IP or ID |
bans |
Lists all current bans |
admin [player] |
Grants admin privileges to a player |
unadmin [player] |
Revokes admin privileges from a player |
admins |
Lists all admin players |
Admin Players
Players granted admin via the admin command gain access to in-game moderation tools. They can kick and ban players directly from within the game.
Server Configuration
| Command | Description |
|---|---|
config [name] [value] |
Sets a server configuration value |
config name [value] |
Changes the server name |
config port [value] |
Changes the server port (set by GPanel) |
config desc [value] |
Sets the server description |
Game Modes
Mindustry supports several game modes that you can specify when hosting a map:
- Survival: Default mode. Build defenses and survive enemy waves.
- Attack: Destroy the enemy core while defending your own.
- PvP: Player versus player. Teams compete to destroy each other's cores.
- Sandbox: Unlimited resources, no enemies. Build freely.
host Tendrils survival
host Fork pvp
host Glacier sandboxMap Management
Custom Maps
Upload custom .msav map files to the config/maps/ directory. After uploading, use the maps command to verify they appear, then host with host [mapname].
Map Rotation
Mindustry automatically cycles to the next map after a game ends. The rotation includes all maps in the maps directory. You can skip the current map by running gameover in the console.
Mod Installation
- Stop the server from GPanel.
- Download mods from the Mindustry community or mod repositories.
- Upload mod files (
.jaror.zip) to theconfig/mods/directory via SFTP. - Restart the server and check the console for mod load messages.
Troubleshooting
| Problem | Solution |
|---|---|
| Server not appearing in browser | Verify the server is running and the port is correct. It may take a minute for the server to register on the list. |
| Custom map fails to load | Ensure the map file is a valid .msav and was made with a compatible Mindustry version. |
| Mod causes crash | Remove the mod from config/mods/ and restart. Check mod version compatibility. |
| Out of memory | The server may need more RAM for large maps or many mods. Check your server plan's memory allocation. |
