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

Difference between revisions of "Ban File"

From BZFlagWiki
Jump to: navigation, search
(removed topic about banning which and added see-also-links to ban and how-to-ban)
(information on file layout)
Line 6: Line 6:
 
  -banfile filename.txt
 
  -banfile filename.txt
 
to the [[BZFS]] [[BZFS Command Line Options|configuration]].
 
to the [[BZFS]] [[BZFS Command Line Options|configuration]].
 +
 +
==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==

Revision as of 21:13, 26 September 2010

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

A server administrator wishing to use a banfile (eg: filename.txt) would add:

-banfile filename.txt

to the BZFS configuration.

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