How do I set up a whitelist?

Enable the whitelist with config whitelist true. When a player tries to join, the console shows the command whitelist add [ID], which you can use to approve them.

How do I limit the number of players?

Enter playerlimit [Zahl] in the console. Use playerlimit off to remove the limit.

Mindustry: Become an Admin

Learn how to give yourself administrator rights on your Mindustry game server, manage players, and set up a whitelist → Find out more

10 November 20262 min read0 Views0 helpful

Introduction

As an administrator, you have full control of your Mindustry game server: You can kick and ban players, manage a whitelist, and limit the number of players. In this guide, we'll show you how to give yourself and your team administrator rights and which commands can help.

Requirements

You assign administrator rights for Mindustry through your game server's Console. Enter server commands directly in the input line there—without a leading slash. Your server must be running and hosting a game.

Add an admin

Connect to your server as described in our guide Connect to the server.
In ZapX, open the Console tab for your game server.
Enter the following command and replace the name with your player name:

Code

admin add DeinSpielername

The console confirms the change with Changed admin status of player. You now have administrator rights in the game.

Tip

The command only works with a name while the player is online. If they're not currently on the server, use their player ID (UUID) instead. You can find the IDs of all known players with info <Name> or search <part of name>.

Use admins to list all administrators, and admin remove <Name or ID> to revoke a player's rights. The admin list is retained even after a restart.

Manage players

You can also enter the following commands in the Console:

Command	Effect
`players`	Lists all players who are currently online
`kick <Name>`	Kicks a player from the server
`ban name <Name>`	Bans a player who is currently online
`ban id <ID>`	Bans a player by their ID
`ban ip <IP>`	Bans an IP address
`bans`	Lists all banned IDs and IP addresses
`unban <IP or ID>`	Lifts a ban
`pardon <ID>`	Allows a player who was kicked by a vote to rejoin the server
`say <Message>`	Sends a message to all players
`playerlimit <Number>`	Limits the number of players; `playerlimit off` removes the limit

Use help to list all available commands in the console, or help <Command> to get an explanation of a specific command.

Set up a whitelist

If you only want to let selected players join your server, use the whitelist:

Enable it with config whitelist true.
If a player who isn't on the whitelist tries to join, they'll be denied. The Console will display the relevant command with their ID, for example whitelist add <ID>.
Enter that command—the player can then join.

Use whitelist without any additional arguments to see all approved players, or whitelist remove <ID> to remove a player. Use config whitelist false to disable the whitelist.

Warning

The whitelist applies to you and your team, too. Anyone who hasn't been approved will also be denied access—just add yourselves as described in steps 2 and 3.

Conclusion

Congratulations! You've successfully assigned administrator rights and learned the most important commands for managing players. Find more server settings in our guide to Server configuration. Our support team is available every day if you have any questions! 🙂

FAQ

Frequently asked questions

Connect to your server and enter admin add [Spielername] in your game server's console. You'll then have administrator rights in the game.

Use their player ID (UUID) instead of their name: admin add [ID]. Find the ID with info [Name] or search [Namensteil] in the console.

Use ban name [Name] to ban a player who's online, or ban id [ID] or ban ip [IP] to ban them by ID or IP address. Use unban [IP oder ID] to lift the ban.

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.

Which 🍪 cookies would you like to allow?

Mindustry: Become an Admin

Introduction

Requirements

Add an admin

Manage players

Set up a whitelist

Conclusion

Frequently asked questions

Mindustry

Requirements

Add an admin

Set up a whitelist

Conclusion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting