Mindustry Admin Command Reference
All server console commands for Mindustry, organized by category. Search by keyword or browse by group. These commands run in the server console (the terminal where you launched java -jar server.jar).
Server Control
host [mapname] [mode]Start hosting. Optionally specify map name and mode (survival/attack/pvp/sandbox).
e.g. host Frozen Forest survival
stopStop the game and return to lobby without exiting the server process.
exitShut down the server process entirely.
statusShow server status: players online, map, wave, and uptime.
versionPrint the current Mindustry server version.
help [command]List all commands, or show details for a specific command.
e.g. help ban
Map Management
maps [all/custom/default]List available maps. Filter by all, custom, or default (built-in).
e.g. maps custom
reloadmapsReload all maps from the maps/ directory without restarting the server.
nextmap <mapname>Set the next map to load when the current game ends.
e.g. nextmap Saltflats
shuffle [none/all/custom/builtin]Set map rotation mode. none=fixed order, custom=custom maps only, builtin=default maps only, all=both.
e.g. shuffle custom
save <slot>Save the current game state to a numbered slot (0–9).
e.g. save 0
load <slot>Load a previously saved game from a numbered slot.
e.g. load 0
savesList all saved game slots.
loadautosaveLoad the most recent auto-save.
gameoverForce the current game to end immediately.
runwaveManually trigger the next enemy wave.
Player Management
playersList all currently connected players with their UUIDs and IPs.
kick <username>Kick a player by name (disconnects immediately).
e.g. kick griefer123
ban name <username>Ban a player by their current username.
e.g. ban name griefer123
ban id <uuid>Ban a player by their UUID.
e.g. ban id abc123...
ban ip <address>Ban a player by IP address.
e.g. ban ip 192.168.1.5
unban <ip/uuid>Remove a ban by IP or UUID.
e.g. unban 192.168.1.5
bansList all currently banned players (IPs and UUIDs).
admin add <username/ID>Grant in-game admin privileges to a player.
e.g. admin add MyFriend
admin remove <username/ID>Revoke in-game admin privileges from a player.
e.g. admin remove MyFriend
adminsList all players with in-game admin privileges.
whitelist add <uuid>Add a player UUID to the whitelist.
e.g. whitelist add abc123...
whitelist remove <uuid>Remove a player UUID from the whitelist.
playerlimit [off/number]Set max concurrent players. Use 'off' or 0 to remove limit.
e.g. playerlimit 16
info <IP/UUID/name>Look up a player's UUID, IP, ban status, and last-seen time.
e.g. info griefer123
search <name>Search for players by partial name across recent history.
e.g. search grief
pardon <ID>Pardon (unban) a player by their UUID.
e.g. pardon abc123...
Name & Subnet Bans
name-ban add <regex>Block players whose names match a case-insensitive regex pattern.
e.g. name-ban add .*[Aa]dmin.*
name-ban remove <regex>Remove a name-ban regex pattern.
e.g. name-ban remove .*[Aa]dmin.*
name-ban clearRemove all name-ban patterns.
subnet-ban add <prefix>Ban all IPs starting with a given prefix (entire subnet).
e.g. subnet-ban add 192.168.1.
subnet-ban remove <prefix>Remove a subnet ban.
e.g. subnet-ban remove 192.168.1.
Game State
pause <on/off>Pause or unpause the game.
e.g. pause on
say <message>Broadcast a message to all connected players.
e.g. say Server restart in 5 minutes!
fillitems [team]Fill the team's core with all resources. Useful for testing.
e.g. fillitems sharded
gcRun garbage collection to free unused memory.
Config & Rules
config [name] [value]Get or set a server config value. Omit value to read current setting.
e.g. config name My Server
rules add <name> <value>Set a game rule value for the current session.
e.g. rules add unitHealthMultiplier 1.5
rules remove <name>Reset a game rule to its default value.
e.g. rules remove waveSendMultiplier
Mods & Scripting
modsList all loaded server-side mods.
mod <name>Show details about a specific loaded mod.
js <script>Execute a JavaScript snippet in the server context. Use with caution.
e.g. js print(Vars.state.wave)
Run your own Mindustry server.
Rent a private Mindustry server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.
Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.