Ban

Kicks the player and bans their name and address.

A join attempt under the name or from the address is refused with the reason until the ban runs out; seconds 0 or none = for good. Kept in the server’s own database across restarts. A name ban is only as strong as the name (nobody proves a name to the server); the address ban is the one that holds. Like a Kick, it is announced to nobody else - a mode that wants it known says it (OnPlayerDisconnect gets "kicked: banned: <reason>").

Syntax

Ban(pid, reason [, seconds])

Parameter	Type
pid	number	the player
reason	string	shown to the player now and at every refused join
seconds	number	how long; 0 or none = for good (optional)

Returns

boolean - false when not connected

Example

Ban(pid, "speed hacking", 7 * 24 * 3600)     -- a week

See also

BanName · BanAddress · Unban · IsBanned · Kick · the Accounts, admins, bans and the audit group of the index