Skip to content

Mindustry: Server Configuration

Learn how to configure your Mindustry game server’s name, game mode, map, autosaves, custom maps, and mods → Learn more now

10 November 20264 min read0 Views0 helpful

Introduction

With the right settings, you can turn your Mindustry game server into exactly the kind of server you envision for your community: with a custom name, welcome message, game mode, map, and autosaves. In this guide, we’ll show you where to configure everything, which values are available, and how to add custom maps and mods to your server.

Startup Parameters

You’ll find your server’s most important settings in the Configuration tab under Startup Parameters. They’re applied every time your server starts. After you save, ZapX will offer to restart the server so your changes take effect.

FieldDescription
Server NameYour server’s name in the game’s server list
Server DescDescription shown below the server name (leave blank for none)
Server MotdWelcome message players see when they connect (leave blank for none)
Map NameMap for a new game, e.g. Fortress (leave blank for a random map)
Game ModeGame mode for a new game: survival, sandbox, attack, or pvp
Load Latest Save1 = load the latest save when the server starts, 0 = always start a new game
Autosave IntervalTime between autosaves in seconds (default 300, 0 disables autosaves)
Autosave AmountNumber of autosaves to keep (default 10); older saves are replaced
Auto Pause1 = pause the game when no one is online
Enable Votekick1 = allow players to kick other players by vote
Extra Start CommandsAdditional server commands to run at startup, separated by commas
Java OptsAdditional Java options; usually, leave this blank
Warning

Mindustry separates startup commands with commas. Therefore, commas in Server Name, Server Desc, and Server Motd are automatically replaced with spaces.

Game Mode and Map

Map Name and Game Mode only apply when the server starts a new game. As long as Load Latest Save is set to 1 and a save exists, your server will continue loading the latest save each time it starts—even after a restart, because your server automatically saves to the shutdown slot when it stops.

To start a new round with a different map or game mode, you have two options:

  • Set Load Latest Save to 0 and restart the server. It will then start a new game using Map Name and Game Mode. Your existing saves will be kept.
  • Or switch directly in the Console: stop ends the current game, and host <Karte> <Modus> starts a new one, e.g. host Fortress survival.
Tip

If you want a mode other than survival, be sure to specify a Map Name as well. Otherwise, the server will start on a random Survival map.

To see which maps are available, run maps all in the Console. For pvp, maps such as Veins, Glacier, and Passage are good choices. In the console, you can replace spaces in map names with underscores, e.g. host Meine_Karte survival for the map “Meine Karte.”

Additional Startup Commands

Use Extra Start Commands to automatically run any server commands at startup. Separate multiple commands with commas. For example, this command limits the number of players and hides connection messages:

Code
playerlimit 20, config showConnectMessages false

Your server applies the name, description, welcome message, port, and autosave settings from the startup parameters every time it starts. So always change these values through Startup Parameters, not with the config command in the console. Otherwise, they’ll be reset the next time the server restarts.

FAQ

Frequently asked questions

Go to the Configuration tab and open Startup Parameters. There, you can configure the server name, description, welcome message, map, game mode, and autosaves. Restart the server after saving your changes.
Map Name and Game Mode only apply to new games. As long as Load Latest Save is set to 1, your server will continue loading the latest save. Set Load Latest Save to 0, or use stop and host [map] [mode] in the console.
Enter survival, sandbox, attack, or pvp in the Game Mode field. If you choose a mode other than survival, specify a Map Name too. Otherwise, the server will start on a random Survival map.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.