Skip to content
Back to Homepage

All Mindustry Console Commands

Use these console commands to host maps, manage players, change server settings, and handle saves on your Mindustry server. Commands are grouped by purpose so you can find what you need quickly.

Notation Meaning
<argument> Required. You must provide a value.
[argument] Optional. You can leave it out.
a/b/c Choose one of the listed options.
name... A value that can contain several words.
  1. Go to the AleForge Panel and select your Mindustry server.
  2. Open the Console page.
  3. Type a command into the console and press Enter.

For example, to see every available command, type:

help
Command Arguments Description
help [command] Displays the command list, or help for a specific command.
version Displays server version info.
status Displays server status.
stop Stops hosting the server.
exit Exits the server application.
yes Runs the last suggested command, if you typed one incorrectly.
Command Arguments Description
host [mapname] [mode] Opens the server. Defaults to survival and a random map if not specified.
maps [all/custom/default] Displays available maps. Shows only custom maps by default.
reloadmaps Reloads all maps from disk.
shuffle [none/all/custom/builtin] Sets the map shuffling mode.
nextmap <mapname...> Sets the next map to be played after a game over. Overrides shuffling.
Command Arguments Description
say <message...> Sends a message to all players.
pause <on/off> Pauses or unpauses the game.
runwave Triggers the next wave.
gameover Forces a game over.
fillitems [team] Fills the core with items.
rules [remove/add] [name] [value...] Lists, removes, or adds global rules. These apply regardless of the map.
Command Arguments Description
config [name] [value...] Configures server settings.
playerlimit [off/somenumber] Sets the server player limit.
mods Displays all loaded mods.
mod <name...> Displays information about a loaded mod.
js <script...> Runs arbitrary JavaScript.

Caution: js runs code directly on your server. Only use it if you know what the script does.

Command Arguments Description
kick <username...> Kicks a player by name.
ban <type-id/name/ip> <username/IP/ID...> Bans a player.
bans Lists all banned IPs and IDs.
unban <ip/ID> Completely unbans a player by IP or ID.
pardon <ID> Pardons a votekicked player by ID so they can join again.
subnet-ban [add/remove] [address] Bans a subnet. This rejects all connections from IPs that start with the given string.
whitelist [add/remove] [ID] Adds or removes players from the whitelist using their ID.
Command Arguments Description
admin <add/remove> <username/ID...> Makes an online user an admin, or removes them.
admins Lists all admins.
players Lists all players currently in the game.
info <IP/UUID/name...> Finds player info. Can also check all names or IPs a player has had.
search <name...> Searches for players who have used part of a name.
Command Arguments Description
save <slot> Saves the game state to a slot.
load <slot> Loads a save from a slot.
saves Lists all saves in the game directory.
host

Opens the server on a random map in survival mode.

playerlimit 10

Limits the server to 10 players.

admin add PlayerName

Makes the online player PlayerName an admin.

save 1

Saves the current game to slot 1.

These examples are for illustration. Use your own map names, player names, and slot numbers.