Mindustry is a hybrid tower-defense sandbox factory game where you build supply chains, construct turrets, and defend against enemy waves. This guide covers setting up your dedicated Mindustry server on Legion Hosting, configuring startup variables, and connecting players.
Before You Begin: Make sure you have access to your GPanel account. If you need help locating your server details, see How to Find Your Server IP and Port.
First Start in GPanel
- Log in to GPanel and select your Mindustry server.
- Navigate to the Console tab. The server will download the
server-release.jarfrom GitHub automatically. - Wait for the download to complete. This is a lightweight Java application and downloads quickly.
- Once started, look for
Server loaded.in the console. The server will then automatically host the configured map.
Java Server: Mindustry runs on Java 11. The server JAR is downloaded from the official Mindustry GitHub releases.
Startup Variables
Navigate to the Startup tab in GPanel to view and modify these:
| Variable | Description | Default |
|---|---|---|
VERSION |
Mindustry version to install. Use GitHub tag format (e.g., v146). Set to latest for the newest release. |
latest |
SERVER_NAME |
Server name displayed in the server list | A Pterodactyl Hosted Server |
MAPNAME |
Map to host when the server starts | Tendrils |
Available Default Maps
| Map Name |
|---|
| Ancient Caldera |
| Fork |
| Fortress |
| Glacier |
| Islands |
| Labyrinth |
| Maze |
| Shattered |
| Tendrils |
| Triad |
| Veins |
| Wasteland |
The startup command automatically configures the port, server name, and hosts the specified map:
java -Xms128M -Xmx{RAM}M -jar server-release.jar config port {PORT},config name {NAME},host {MAP}How to Connect
Via Server Browser
- Launch Mindustry (available on Steam, itch.io, or mobile).
- From the main menu, select Play then Join Game.
- Browse the server list and find your server by name, or use the Add Server button.
Via Direct IP
- In the Join Game screen, click Add Server.
- Enter your server IP and port in the format
IP:PORT. - Click Add, then select your server from the list and click Join.
Finding Your IP: Your server IP and port are displayed on the main page of your server in GPanel. Ports are randomly assigned unless you have a private IP. For detailed instructions, see How to Find Your Server IP and Port.
Custom Maps
You can upload custom maps to your server:
- Stop the server from GPanel.
- Upload custom map files (
.msav) to theconfig/maps/directory via SFTP or the File Manager. - Update the
MAPNAMEstartup variable to the custom map name, or use thehost [mapname]command in the console after starting.
Updating the Server
To update Mindustry to a newer version:
- Change the
VERSIONstartup variable to the desired version tag (e.g.,v146) or set it tolatest. - Use the Reinstall option in GPanel to download the new version.
Related Articles
Need Help? If you encounter any issues not covered in this guide, open a support ticket and our team will assist you.
