Banning Users from the Extended Chat Network

Beginning with Hermes build 17, Hermes can ban users from the extended chat network by citizen number, user name, and IP address. Versions prior to build 17 could only ban by citizen number and user name.

Only bot administrators and citizens who hold eject rights can ban users from Hermes.

Change Log

Build Description
36
  • Syntax of the h:ban command was changed to require a comment to be specified about the ban.
37
  • All ban types are now combined into a single record.
38
  • Bans are now automatically set to expire after 15 minutes (or any other time as configured)

Commands

Ban Type Command Syntax Example Additional Notes
Build 37 and Newer
IP address ban -ip='[address]',#[id]: [comment] ban -ip='1.2.3.4',#1: Abusive user, "LameTourist"

To ban an entire class C, specify 0 for the 4th bit; example: 1.2.3.0.

The # parameter may be omitted if this is a new ban; otherwise, this should be the ID number of the ban record to modify. (e.g., to update or add additional types to this record.)

Comment may be omitted if only updating an existing ban.
Citizen number ban -cit='[number]',#[id] ban -cit='358911',#1 Using the citizen number 0 effectively removes the citizen number from the ban record.
User name ban -name='[name'],#[id] ban -name='[Sirius]'  
Session number ban -sid='[number]',#[id] ban -sid='22532'

This command will use the following rules to create a ban:

  1. If the user is a citizen, the user will be banned by both citizen number and IP address.
  2. If the user is a bot, the user will be banned by only its name.
  3. If the user is a tourist, the user will be banned by IP address.
Temporary ban -expire='[minutes]',#[id] ban -expire='5',#1 This can only be used to set an expiration time on existing bans. # must be specified.
Update comment ban -comment='[id]': [comment] ban -comment=2: Lame user This can only be used to update the comment on an existing ban.
Build 36 and earlier
IP address h:ban /a <address>: <comment> h:ban /a 1.2.3.4: "Tourist"-- abusive user To ban an entire class C, specify 0 for the 4th bit; example: 1.2.3.0.
Citizen number h:ban /c <citnum>: <comment> h:ban /c 358911: waterboy-- excessive idiocy  
Session number h:ban /u <session>: <comment> h:ban /u 22532: "Jimbo Jambo"-- excessive OCD

This command will use the following rules to create a ban:

  1. If the user is a citizen, a citizen number ban (h:ban /c) will be placed.
  2. If the user is a bot, a user name ban (h:ban /n) will be placed.
  3. If the user is a tourist, an IP address ban (h:ban /a) will be placed.
User name h:ban /n <name>: <comment> h:ban /n "Andrew": excessive idiocy When banning tourists, the ban is automatically turned into an IP address ban; it is thus not possible to ban only tourist names.

Removing Bans

In versions prior to build 36: to unban a citizen number, user name, or IP address, use h:unban in place of h:ban in all the above examples. This is no longer available in Build 37 and later.

Beginning with Hermes build 20, h:unban can accept entry numbers. For example, given a ban list of:

  1. 127.0.0.1
  2. 296894
  3. 10.0.0.2

Typing h:unban #2 will remove 296894 from the ban list. Beginning with Build 37, this is now the only method for removing bans.

Maintenance

A list of banned users may be obtained by typing h:ban -list. (Iin Build 36, this command is h:ban /L.)

The entire ban list can be deleted all at once by typing h:ban -clear. Beginning with build 29, this function is now only available to bot administrators. (In build 36, this command is h:ban /CLEAR.)