This is an old revision of the document!

/ban

This command can be used by moderators to forcibly remove other clients from the chat for a specified amount of time.

The main differences between this command and /kick in the original implementation were that not specifying an argument for this command would imply a permanent ban, whereas for /kick it implied instant revocation, and this command would also place a ban on the client's IP address, while /kick did not. Implementations can decide on their own whether they want to replicate the latter behaviour, the argument behaviour should remain consistent, however.

If an error occurred while trying to issue the ban one of the notices below will be sent to the client, otherwise the target user will receive S2C Packet 9: Forced Disconnect on all their connected clients and other clients present in the same channel will receive S2C Packet 3: User Remove with the reason being set to kick.

Format

/ban [user] [duration?]

[user] is a string argument that is used to specify the target user for the ban.
[duration?] is an optional int argument that can be used to specify the duration of the ban in seconds.

Notices

If an error occurs whilst trying to issue the ban, one of the following notices will be sent to the client that issued the command.

cmdna - Client is not allowed to use this command. First argument is set to /ban.
usernf - Target user could not be found. First argument is set to the value supplied to [user].
kickna - Target user could be found but the client is not allowed to ban them. First argument is set to the display name of the target user.
cmderr - Format of the [duration?] argument was not acceptable.

Remarks

When doing lookups for the [user] argument, it is a good idea to keep the prefixes added by the /afk and /nick commands in mind.

Examples

Successful ban attempt

Client issues the following command:

/ban flash

Target user receives on all connected clients, followed by the connection being closed:

9\t1\t-1

Clients in the same channel will receive something among the lines of:

3\t1\tflash\tkick\t1744583077\t39988602271681

Attempting to ban a user with higher rank

Client issues the following command, in the unrealistic scenario where nook actually marked themself as away:

/ban <AFK>_nook 9999999

Client receives the following notice:

2\t1744636406\t-1\t1\fkickna\fnook\t40002254529965\t10010

Railgun

Table of Contents