IRC roles, commands and modes

Here is an overview of useful moderation commands to help the staff fight crime and scum in channels.

Overview of staff permissions

A short overview of staff positions and the flags that are assigned to them, plus tripbot permissions.

• Tripsitter - +V in #tripsit - Voice in Tripsit

• Tripsitters are able to quiet a user #tripsit via tripbot. Tripsitters have no access to chanserv commands.

• Power User Flags - +AViv in #tripsit and #drugs - Voice in #tripsit and #drugs

• Power Users are able to quiet a user in #drugs or #tripsit via tripbot. Power Users have no access to chanserv commands.

• Moderator - +AVefiorv in #tripsit and #drugs - Voiced in #drugs and #tripsit with the ability to op

• Mods can kick, quiet and network ban through either tripbot or chanserv. They can set flags in rooms via !flags or /cs flags #channel user +/-flags, set modes via /cs mode #channel +/-modes or /mode #channel +/-modes, and change the topic only when opped and +t is set on the channel Via /topic or /topicappend.

• Admin - +AFORVefiorstv - Full permissions in #tripsit and #drugs, opped by default.

• In addition to kick, quiet, and ban, admins have founder, and the ability to use the set command.

Tripbot Commands

• ~quiet 15 username reason

• Sets +q on a user for the given time and reason

• Preffered over chanserv quiet for documentation and timed quiet reasons.

• ~unquiet user

• Remove a quiet before the timelimit is up.

• ~nban user reason

• Sets +b on the user in every channel tripbot is in, effectively banning them from the network while still allowing them to connect.

• ~nunban user

• Removes a network ban.

Channel comands

• /ban #channel username/hostmask

• Sets +b on a user.

• /msg chanserv unban #channel username/hostmask

• Removes +b on a user.

• /msg chanserv quiet #channel username/hostmask

• Sets +q on a user

• Can also be done through tripbot, with ~quiet 15 username reason. Quieting through tripbot is preferred as you can set a time, and automatically document it.

• /msg chanserv unquiet #channel username/hostmask

• Removes +q on a user.

• /topic #channel

• sets the topic for a channel

• /topicappend #channel

• adds to the existing topic at the end.

Channel modes

Channel modes are set on a channel. They allow you to do many useful things on both users and channels.

Channel modes are set with /mode #channel +/- modes or /msg chanserv mode #channel +/- modes

+ assigns modes, - removes them.

• +b, channel ban

• Bans take one parameter which can take several forms. The most common form is +b nick!user@host. The wildcards * and ? are allowed

• For example, *!user@host will ban any nickname from a given user.

• +c, colour filter

• This cmode activates the colour filter for the channel. This filters out bold, underline, reverse video, beeps, mIRC colour codes, and ANSI escapes

• +e, ban exemption

• This mode takes one parameter of the same form as bans, which overrides +b and +q bans for all clients it matches.

• +f, channel forwarding

• This mode takes one parameter. +f #channel

• If you try to join this channel, it will forward to the channel specified.

• +F, allow anybody to forward to this channel

• +g, allow anybody to invite

• Only applicable if the channel is set +i

• +i, invite only

• When this cmode is set, no client can join the channel unless they have an invex (+I) or are invited with the INVITE command.

• +I, invite exception (invex)

• This mode takes one parameter of the same form as bans. Matching clients do not need to be invited to join the channel when it is invite-only

• +j, join throttling

• This mode takes one parameter of the form n:t, where n and t are positive integers. Only n users may join in each period of t seconds.

• +k, key (channel password)

• Taking one parameter, when set, this mode requires a user to supply the key in order to join the channel: /JOIN #channel key. This is disabled by default and can only be set by the founder of a channel with the set command. For more information, see the overview of the set command

• +l, channel member limit

• Takes one numeric parameter, the number of users which are allowed to be in the channel before further joins are blocked. Invited users may join regardless. This is disabled by default and can only be set by the founder of a channel with the set command. For more information, see the overview of the set command

• +L, large ban list

• Channels with this mode will be allowed larger banlists (by default, 500 instead of 50 entries for +b, +q, +e and +I together). Only network operators with resv privilege may set this mode.

• +m, moderated

• When a channel is set +m, only users with +o or +v on the channel can send to it.

• +n, no external messages

• When set, this mode prevents users from sending to the channel without being in it themselves. This is enabled by default and can only be set by the founder of a channel with the set command. For more information, see the overview of the set command

• +o, channel operator

• This mode takes one parameter, a nick, and grants or removes channel operator privilege to that user. Channel operators have full control over the channel, having the ability to set all channel modes except +nt-lk, and kick users. Like voiced users, channel operators can always send to the channel, overriding +b, +m and +q modes and the per-channel flood limit. In most clients channel operators are marked with an '@' sign. The privilege is lost if the user leaves the channel or server in any way, for this reason it is recommended to set channel operators with the flags command, instead of the mode command.

• +p, paranoid channel

• When set, the KNOCK command cannot be used on the channel to request an invite, and users will not be shown the channel in WHOIS replies unless they are on it.

• +P, permanent channel

• Channels with this mode the channel will not be destroyed when the last user leaves. Cannot be set by a user, must be set by an IRCop

• Note, this is not required on a registered channel as ChanServ joins, and will never leave once it is registered.

• +q, quiet

• Set the same way as +b, the effect is that they cannot knock on the channel, send to the channel or change their nick while on channel.

• +Q, block forwarded users

• Channels with this mode set are not valid targets for forwarding. Any attempt to forward to this channel will be ignored, and the user will be handled as if the attempt was never made (by sending them the relevant error message).

• +r, block unidentified

• When set, this mode prevents unidentified users from joining. Invited users can still join. In order to join a +r channel, you must have a nickserv account and be identified.

• +s, secret channel

• When set, this mode prevents the channel from appearing in the output of the LIST, WHO and WHOIS command by users who are not on it. Also, the server will refuse to answer WHO, NAMES, TOPIC and LIST queries from users not on the channel.

• +t, topic limit

• When set, this mode prevents users who are not channel operators from changing the topic. This is enabled by default and can only be set by the founder of a channel with the set command. For more information, see the overview of the set command

• +v, voice

• This mode takes one parameter, a nick, and grants or removes voice privilege to that user. Voiced users can always send to the channel, overriding +b, +m and +q modes and the per-channel flood limit. In most clients voiced users are marked with a plus sign. The privilege is lost if the user leaves the channel or server in any way, for this reason it is reccomended to set channel operators with the flags command, instead of the mode command.

• +z, reduced moderation

• When +z is set, the effects of +m, +b and +q are relaxed. For each message, if that message would normally be blocked by one of these modes, it is instead sent to all channel operators. This is intended for use in moderated debates.

Channel flags

Channel flags are set on a user. They allow you to do many useful things to a user. Flags are permanent, and must be manually unset if you wish to remove permissions.

Set with /msg chanserv flags #channel user +/-flags + will apply a flag, - will take it away.

• +v - Enables use of the voice/devoice commands.

• +V - Enables automatic voice.

• +o - Enables use of the op/deop commands.

• +O - Enables automatic op.

• +s - Enables use of the set command.

• overview of the set command

• +i - Enables use of the invite and getkey commands.

• +r - Enables use of the kick, kickban, ban and unban commands.

• +r - Enables use of the ban and unban commands.

• +R - Enables use of the recover and clear commands.

• +f - Enables modification of channel access lists.

• +t - Enables use of the topic and topicappend commands.

• +A - Enables viewing of channel access lists.

• +S - Marks the user as a successor.

• +F - Grants full founder access.

• +b - Enables automatic kickban.

Flags Template

Alternatively, you may use one of the predefined templates to easily set common flags. This is done with /msg chanserv flags #channel template where template is the name of the template. See above for a description of individual flags and what permissions they entail.

• Admin

• +AFORVefiorstv

• Aop

• +AOotv

• Bot

• +ORVeforv

• Founder

• +AFORfiorstv

• Moderator

• +AVefiorv

• Poweruser

• +AViv

• Sop

• +AOiorstv

• Vop

• +AVv