This wiki is archived and useful information is being migrated to the main bzflag.org website

Editing Ban File

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Archived wiki

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
The banfile is a file in which a list of banned player accounts and IP addresses are saved. Server administrators may issue bans to players who use foul language, [[Team Kill]], use a cheat client or who behave inappropriately or against the spirit of the game.
+
{{Stub}}[[Category:Server]]
 +
The [[banfile]] is a file in which a list of banned player accounts and IP addresses are saved. Server administrators may issue bans to players who use foul language, [[Team Kill]], use a cheat client or who behave inappropriately or against the spirit of the game.
  
 
==Creating a Banfile==
 
==Creating a Banfile==
Line 5: Line 6:
 
  -banfile filename.txt
 
  -banfile filename.txt
 
to the [[BZFS]] [[BZFS Command Line Options|configuration]].
 
to the [[BZFS]] [[BZFS Command Line Options|configuration]].
 
It is also possible to specify a Master Ban URL location like so:
 
-masterBanURL http://www.bzflag.org/master-bans.txt
 
 
Note that the URL specified includes the master bans the BZFlag developers have noted as cases where a [[Master Ban]] was necessary.
 
 
==Managing the Banfile==
 
If the ban files are ever updated outside of the game, or if you have multiple servers using the same ban files, they will need to be updated manually every time they change.
 
 
One method of doing this with administrative privileges is to run the '''/reload''' command in-game like so:
 
/reload bans
 
 
The second method is to load the [[Server Control]] plugin which would automatically perform a ban reload upon ban updates. You can view the plugin's wiki page for more details on setting it up.
 
 
==Layout==
 
A banfile follows a specific layout, which can also be written or modified by hand.
 
 
Example entry:
 
12.34.56.*
 
end: 1282088135
 
banner: admin
 
reason: (badguy) cheating.
 
 
The first line can either be an IP, a ranged IP, a host, a ranged host or a BZID (Syntax: 'bzid: 12345').
 
The second line 'end:' defines the expiry date with a unix timestamp.
 
The third line 'banner:' defines the callsign of the privileged player who executed the ban.
 
The fourth and last line 'reason:' specifies a reason why the specific subject was banned and classically contains the banned callsign.
 
Each ban block is divided from the others by one empty line.
 
 
Unix timestamps can be generated on this website: http://www.unixtimestamp.com/index.php
 
  
 
==See also==
 
==See also==
Line 44: Line 15:
 
* [[Ban]]
 
* [[Ban]]
 
* [[How To Ban]]
 
* [[How To Ban]]
 
[[Category:Server]]
 
[[Category:Server Security]]
 

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)