You decide which services we may enable for analytics, personalization, and external content.
We use cookies and similar technologies on our website to personalize content, embed external media, and better understand how individual areas are used.
Necessary cookies
These entries support essential functions such as security, stability, and form processing.
Optional sections
AnalyticsMarketingPersonalizationExternal media
Your data may be processed with your consent or on the basis of legitimate interests. In the cookie settings, you can reject or explicitly allow each optional category.
Some services process personal data in third countries. By consenting, you also agree to this transfer. You can find more information in our Privacy Policy.
You can reopen and change your selection at any time. · 1.0.2
Learn how to fix common issues with your Mindustry game server—from connection errors and mods to save files → Find out more
10 November 20264 min read0 Views0 helpful
Introduction
Is your Mindustry game server not starting as expected, can’t you connect to it, or is it not running smoothly? Don’t worry—most issues have a simple cause. Here are the most common issues and how you can quickly fix them yourself.
FAQ
Frequently asked questions
Check in the Overview that the server is online, and use the exact IP address and port shown there. Enter status in the console to see whether a game is being hosted.
The game and server are running different versions. If you see Outdated client, update your game. If you see Outdated server, your game is newer than the server—please contact our support team.
Your mods don’t match the server’s. Players need exactly the mods in the config/mods folder, in the same versions, with no additional mods.
If the latest save can’t be loaded, the server tries older saves and starts a new game as a last resort. Use load [slot] to load a specific save, or enter saves to see them all.
The server applies the name, description, welcome message, port, and autosave settings from the Startup Parameters each time it starts. Change them in the Configuration tab instead of using the config command in the console.
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.
Navigation
Mindustry
Issues and solutions
The most important tool for troubleshooting is your game server’s console. It shows you what your server is doing when it starts, and you can enter commands like status to check whether a game is currently running.
Connection
Server can’t be found
First, check in the Overview that your server is online, and copy the IP address and port exactly as shown there. The port may not be the default port 6567—always include the port shown in your Overview.
If the server is running but no game is open, players can’t join. Enter status in the console. If the server reports that it isn’t hosting a game, start one with host or restart the server.
“Outdated client” or “Outdated server” message
The game and server must use the same Mindustry version. If you see Outdated client, your game is older than the server—update it to the latest version. You can check which version your server is running with the version command in the console. If you see Outdated server, your game is newer than the server—in this case, please contact our support team.
“Incompatible mods” message
When a player connects, Mindustry compares the player’s mods with the server’s. Your players need exactly the same mods, in the same versions, as those in the server’s config/mods folder—and no additional mods. The in-game message shows which mods are missing or unnecessary. Enter mods in the console to see which mods your server has loaded.
Player is rejected
If the message You are not whitelisted here appears, the whitelist is enabled. Add the player using the command shown in the console (whitelist add <ID>). For You are banned on this server, remove the ban with unban <IP or ID>. For This server is full, increase the player limit with playerlimit <number>. Find out more in our guide Become an admin.
Starting and save files
Map or game mode doesn’t change
Map Name and Game Mode in the Startup Parameters only apply to a new game. As long as Load Latest Save is set to 1, your server will continue loading the latest save when it starts. Set Load Latest Save to 0, or use stop and host <map> <mode> in the console.
Also make sure the map name exactly matches an available map (maps all shows you all maps), and that the mode is lowercase: survival, sandbox, attack, or pvp. If you select a mode other than survival but don’t enter a map, the server starts on a random Survival map.
Server starts with a different save file
If the latest save can’t be loaded—for example, because it’s corrupted—your server tries older saves in sequence and starts a new game as a last resort, so it doesn’t stay offline. The console shows you which save was loaded. Load a specific save with load <slot>, or enter saves to see a list of all saves.
Settings are gone after restarting
Your server applies the name, description, welcome message, port, and autosave settings from the Startup Parameters each time it starts. This overrides any changes made with the config command in the console. For this reason, enter these values in the Startup Parameters section of the Configuration tab.
Performance
Lag or crashes with large factories
Large factories with lots of conveyor belts, units, and buildings require a lot of memory and processing power. Keep an eye on resource usage in the Overview and under Statistics. If memory usage is consistently at its limit, upgrading your server can help.
Your server automatically uses an appropriate amount of the available memory for Java. So leave the Java Opts field empty—a value for -Xmx that’s set too high can cause your server to crash.
DDoS and other network threats
Game servers can be targeted by attacks that flood the server with traffic, causing lag or dropped connections. ZAP-Hosting offers integrated protection systems to protect your server from common attacks. If you suspect an attack, contact our support team.
Preventive measures
Regular backups can save you a lot of stress. We already back up your game server automatically every day. With the ZapX Pass, you can also create your own backups at any time and restore them with a click—with ZapX Pass Pro, you can even automate backups on your own schedule. Before making major changes, also save your game with save <slot> in the console so you can load it again later with load <slot>.
Conclusion
These steps should help you solve your issue. If they don’t, don’t hesitate to contact our support team—we’re here every day and happy to help! 🙂
Server hosting from €2.49 / month, online instantly, DDoS protection included.
Preferred source on Google
