All Mindustry Console Commands
Mindustry Server Console Commands
Section titled “Mindustry Server 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.
How to Read the Arguments
Section titled “How to Read the Arguments”| 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. |
How to Run Commands
Section titled “How to Run Commands”- Go to the AleForge Panel and select your Mindustry server.
- Open the Console page.
- Type a command into the console and press Enter.
For example, to see every available command, type:
helpGeneral Commands
Section titled “General Commands”| 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. |
Hosting and Maps
Section titled “Hosting and Maps”| 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. |
Game Control
Section titled “Game Control”| 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. |
Server Settings and Mods
Section titled “Server Settings and Mods”| 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:
jsruns code directly on your server. Only use it if you know what the script does.
Player Management
Section titled “Player Management”Kicks, Bans and Access
Section titled “Kicks, Bans and Access”| 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. |
Admins and Player Info
Section titled “Admins and Player Info”| 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. |
Common Examples
Section titled “Common Examples”hostOpens the server on a random map in survival mode.
playerlimit 10Limits the server to 10 players.
admin add PlayerNameMakes the online player PlayerName an admin.
save 1Saves the current game to slot 1.
These examples are for illustration. Use your own map names, player names, and slot numbers.