Banning and Unbanning Players - Alderon-Games/pot-community-servers GitHub Wiki
Caution
We have moved our documentation to a new location! Please visit Banning and Unbanning Users for the most up-to-date information for this page.
You can ban users two ways, either by adding them manually to the bans.txt file or by using a chat command in-game.
Important Note: The bans.txt file will hot reload once a minute if changed and there is an in-game command to add / remove items from the list (see below). We recommend adding bans with RCON commands or in-game chat commands!
- In the Saved folder you must create a file called
bans.txt - Add the banned users for your server in the text file and click "Save".
Path: Saved/bans.txt
You must add each ban on a new line.
Each line in your text file must follow this format:
AGID:UnixTimestamp:AdminReason:UserReason
| Variable | Example | Description |
|---|---|---|
| AGID | 123-443-512 |
The Alderon Games ID of the player. |
| UnixTimestamp | 1644464516 |
If the ban is temporary, enter the Unix Timestamp of the date the player will be unbanned. You can generate the timestamp here https://www.epochconverter.com/. If the ban is permanent, set this to 0
|
| AdminReason | Admin message here! |
An internal message that will only be visible by admins. Useful for keeping notes. Can be left blank. NOTE: you cannot use a colon : in this description or else it will break your bans. |
| UserReason | Banned for spamming the chat. |
The message the user will see when attempting to join your server. Ensure this is descriptive so the player understand why they were banned. NOTE: you cannot use a colon : in this description or else it will break your bans. |
525-053-709:0:Reason for admins here:Stay out of my server
123-456-678:1645059401:I have banned them:Broke rule number three
543-226-532:1645059400:admin note here:You are banned because you were rude
766-980-003:0::Broke rule 12 so you are permabanned.
Log into your server and issue the following command: /ban <playername> <kick reason> Example: /ban Jiggy Breaking rule 12
You can leave the ban reason blank if desired.
/unban PlayerID - Unbans the user.
/reloadbans - The bans list will be refreshed ever 1 minute, however this command will reload it immiedately.
While in Spectator Mode, you are able to click "Ban" next to the player's name to ban them from the server. Upon banning a player, it will prompt you for a ban reason. This is optional, and can be left blank if desired. Bans via this method are permanent.
Server Hosting Agreement || Host Your Own Server || Report a Server Bug || Common Issues and Frequently Asked Questions
Copyright Alderon Games Pty Ltd