This guide explains how to set up admins, moderators, whitelists, and bans on your 7 Days to Die server using serveradmin.xml, and covers essential in-game admin console commands. For general server configuration, see the 7 Days to Die Server Setup Guide.
Admin Setup (serveradmin.xml)
The serveradmin.xml file controls admin permissions, moderators, the whitelist, and the blacklist. Its exact location depends on the server's UserDataFolder setting and may vary between server configurations -- it is not always in a simple saves/ directory.
Accessing serveradmin.xml
- Log in to GPanel and open the File Manager.
- Use the file browser's search functionality to search for
serveradmin.xml, or browse into the directory specified by your server'sUserDataFoldersetting inserverconfig.xml. - Open
serveradmin.xmlonce located.
serveradmin.xml via SFTP. See the SFTP file upload guide for instructions.
Adding Admins and Moderators
Each player is identified by their Steam 64 ID (a 17-digit number). You can look up a Steam 64 ID on sites like steamid.io.
Permission Levels
Permission levels range from 0 (full admin) to 1000 (standard player). Common values:
| Level | Role |
|---|---|
0 |
Full administrator (all commands) |
1 |
Administrator |
100 |
Moderator (limited commands) |
1000 |
Normal player (default) |
50) and assign individual commands to specific permission levels via the <permissions> section in serveradmin.xml.
Whitelist and Blacklist
The <whitelist> section restricts your server to only the listed Steam IDs. Leave it empty to allow anyone to join. The <blacklist> section permanently bans players. You can optionally set an unbandate for temporary bans.
Example serveradmin.xml
<?xml version="1.0" encoding="UTF-8"?>
<adminTools>
<!-- Admins: add Steam64 IDs and permission levels -->
<admins>
<admin steamID="76561198000000001" permission_level="0" />
<admin steamID="76561198000000002" permission_level="100" />
</admins>
<!-- Moderators -->
<moderators>
</moderators>
<!-- Whitelist: only these players can join (leave empty to disable whitelist) -->
<whitelist>
</whitelist>
<!-- Blacklist: permanently banned players -->
<blacklist>
<blacklisted steamID="76561198000000099" unbandate="" />
</blacklist>
</adminTools>admin reload) to apply changes.
In-Game Admin Commands
Once you have admin permission, press F1 in-game to open the console. You can also run commands from the Console tab in GPanel.
Player Management
| Command | Description |
|---|---|
listplayers |
List all connected players with their Entity IDs and Steam IDs. |
kick <player> <reason> |
Kick a player from the server. |
ban add <player> <duration> <reason> |
Ban a player for a duration (e.g., 1 day, 1 hour). |
ban remove <player> |
Remove a ban from a player. |
ban list |
Show all currently banned players. |
Server Management
| Command | Description |
|---|---|
say <message> |
Send a server-wide message to all players. |
saveworld |
Force save the world immediately. |
shutdown |
Gracefully shut down the server. |
admin reload |
Reload serveradmin.xml without restarting the server. |
Gameplay Commands
| Command | Description |
|---|---|
give <player> <item> <count> |
Give an item to a player. |
teleportplayer <player> <x> <y> <z> |
Teleport a player to specific coordinates. |
settime <day> <hour> <minute> |
Set the in-game time. |
weather <weathertype> |
Change the current weather. |
help in the console to see a full list of available commands with their required permission levels.
Need Help?
If you need further assistance with admin configuration, please open a support ticket and include your server ID and a description of the issue.
Related Articles
- 7 Days to Die Server Setup Guide — serverconfig.xml configuration and how to connect
- 7 Days to Die Mod Installation — installing mods and EAC requirements
- 7 Days to Die Troubleshooting — common issues and solutions
