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

stop

Stop the game and return to lobby without exiting the server process.

exit

Shut down the server process entirely.

status

Show server status: players online, map, wave, and uptime.

version

Print 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

reloadmaps

Reload 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

saves

List all saved game slots.

loadautosave

Load the most recent auto-save.

gameover

Force the current game to end immediately.

runwave

Manually trigger the next enemy wave.

Player Management

players

List 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

bans

List 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

admins

List 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 clear

Remove 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

gc

Run 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

mods

List 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)

Private Mindustry hosting

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.

Rent a Mindustry server Real hardware · Full control panel · 98% SLA

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.