Change the map a Mindustry server hosts at startup

Map Name is passed to Mindustry’s host command when the process starts. Use a map recognized by the server, including its exact internal name.

Make the change

  1. Back up the server’s config directory and any saved games before replacing maps.
  2. Install a custom map using Mindustry’s supported map format and server map directory.
  3. Record the old Map Name, then stop the server.
  4. Set Map Name to the intended available map and start.
  5. Read Console to confirm the host command succeeds and join with a compatible client.
Controls used in this task
Panel fieldWhat to keep in mind
Map NameSelects the map loaded by this server. Use an exact installed map identifier supported by the game, including any required path.

Check the result

If the map cannot be found, verify its name and file location before reinstalling the server. Keep the previous map available so a typo does not leave the community without a working session.

Related guides

Mindustry server not showing up or unable to connect · Mindustry server settings: Startup and configuration

Documentation

Server configuration reference · Project documentation 2

Was this article helpful?

Your feedback helps us improve our guides.

Written by Konnect HostingUpdated 1 min read