LLI Wiki — My Digital Knowledge Base

IRC cheat sheet: commands, NickServ, ChanServ and modes

Basic IRC commands, NickServ/ChanServ/BotServ services, channel and user modes, bans and access levels.

Cheat sheet for an IRC client (HexChat, mIRC...): basic commands, NickServ and ChanServ services (Anope-style), channel and user modes, bans and access levels. Exact commands can vary depending on the network and the services software.

Basic commands

Command Effect
/join #channel Join a channel
/part #channel Leave a channel
/quit [message] Disconnect from the server
/nick nickname Change nickname
/msg nickname message Private message
/query nickname message Private message in a dedicated window
/notice nickname message Send a notice without opening a window
/me action Action message
/names #channel List users in the channel
/list List channels on the network
/topic Show the channel topic
/whois nickname Information about a user
/whowas nickname Information about a user who has quit
/ping nickname Measure the lag to a user
/ignore nickname Ignore a user
/away and /back Mark yourself away, then return
/kick #channel nickname [reason] Temporarily remove a user

Never accept a DCC chat or DCC transfer from someone you do not know.

Nick, username and real name

A user is identified by nick!ident@host.

NickServ: nickname management

Commands start with /msg NickServ (or /ns if the network allows it).

Command Effect
/msg NickServ register password email Register the current nickname (the password usually cannot be recovered)
/msg NickServ identify password Identify; required on every connection
/msg NickServ status Show identification status
/msg NickServ ghost nickname password Disconnect a ghost session using your nickname
/msg NickServ recover nickname password Disconnect someone using your registered nickname
/msg NickServ release nickname password Release a nickname held by services
/msg NickServ set kill on Protect the nickname: about 60 seconds to identify
/msg NickServ drop nickname Delete the nickname (channels you founded are dropped too)
/msg NickServ help set language List the languages available for services

After a GHOST, take your nickname back with /nick nickname, then identify again.

ChanServ: channel management

Command Effect
/msg ChanServ register #channel password "description" Register a channel (a registered nickname is required)
/msg ChanServ set #channel entrymsg "text" Message shown on join
/msg ChanServ set #channel keeptopic on Keep the topic even if the channel empties
/msg ChanServ set #channel secureops on Only AOPs, SOPs and the founder can be ops
/msg ChanServ set #channel founder nickname Change the founder
/msg ChanServ drop #channel Unregister the channel
/msg ChanServ xop #channel add nickname Add a user with the XOP system (VOP, HOP, AOP, SOP)
/msg ChanServ set #channel xop off Disable XOP to use access levels
/msg ChanServ levels #channel list List the levels
/msg ChanServ levels #channel set type level Change a level
/msg ChanServ levels #channel reset Reset levels to defaults
/msg ChanServ access #channel add nickname level Add to the access list
/msg ChanServ access #channel del nickname Remove from the access list
/msg ChanServ access #channel list Show the access list
/msg ChanServ akick #channel add host [reason] Automatic kick and ban on join

Typical access levels

Values vary from network to network.

Level Role Effect
Founder QOP (~, +q) Full access to ChanServ functions
100 and above SOP (&, +a) Auto-op, manages AOPs
50 AOP (@, +o) Auto-op
40 HOP (%, +h) Auto half-op
30 VOP (+, +v) Auto voice
0 - No privileges
-1 - Cannot be opped
-100 - Cannot join the channel

BotServ

A services bot in the channel is required to use "fantasy" commands (!command).

Command Effect
/msg BotServ botlist List available bots
/msg BotServ assign #channel bot Assign a bot to the channel
/msg BotServ unassign #channel Remove the bot
/msg BotServ say #channel message Make the bot speak
/msg BotServ act #channel action Make the bot perform an action
/msg BotServ kick #channel badwords on Enable kicking on bad words
/msg BotServ kick #channel badwords add word [any|single] Add a bad word

With any, the bot kicks when the word appears inside another word (mac also matches macintosh). With single, only the exact word is matched. /msg BotServ help kick lists the other kickers (bold, colors, repeats...).

Nickname prefixes

Symbol Status Required mode
~ Owner +q
& Admin +a
@ Operator +o
% Half-operator +h
+ Voice +v

Channel modes

Syntax: /mode #channel +/-mode [argument].

Mode Effect
b mask Ban a nick!ident@host mask
i Invite only
k key Key (password) required to join
l number Limit the number of users
m Moderated: only ops, half-ops and voiced users can talk
n No external messages to the channel
p Private (hidden from /list)
s Secret (hidden from /list and /whois)
t Only operators can change the topic
c Block messages containing color codes
S Strip formatting from messages (server dependent)
N No nick changes in the channel (server dependent)
R Only registered nicknames can join (server dependent)
M Only registered nicknames can talk (server dependent)
e mask Ban exception (server dependent)
I mask Invite exception (server dependent)

The full list depends on the server; see for example the Zandronum channel modes reference.

Examples:

/mode #channel +o nickname
/mode #channel +ooo nick1 nick2 nick3
/mode #channel -o nickname
/mode #channel +b nickname
/mode #channel -b nickname
/mode #channel +i

Giving operator status gives control over the channel: reserve it for people you trust.

User modes

Syntax: /mode nickname +i.

Mode Effect
i Invisible: hidden from /who and /names for people outside your channels
o IRC operator (set by the server)
s Receive server notices
w Receive wallops
x Hidden (cloaked) hostname
r Registered nickname (set by services)
z Connected via TLS/SSL (set by the server)
R Private messages only from registered users (server dependent)

Bans: masks

Format: nick!ident@host, where * replaces any part. Use /whois, /whowas or /who to get the information you need.

Mask Effect
joe!*@* Block the nickname joe
*abc*!*@* Block any nickname containing abc
*!*@host.example.com Block a host
*!*@* Bans everyone, avoid

Formatting codes

In most clients:

Shortcut Effect
Ctrl+K then color Colored text, Ctrl+K 8,4: yellow text on a red background
Ctrl+B Bold
Ctrl+U Underline
Ctrl+R Reverse (or italics depending on the client)
Ctrl+O Back to plain text

Colors range from 00 to 15: 00 white, 01 black, 02 blue, 03 green, 04 red, 05 brown, 06 purple, 07 orange, 08 yellow, 09 light green, 10 teal, 11 cyan, 12 light blue, 13 pink, 14 grey, 15 light grey. Many channels forbid colors, so use them sparingly.

HexChat configuration folder

Installation Folder
Windows %APPDATA%\HexChat
Linux ~/.config/hexchat
Flatpak ~/.var/app/io.github.Hexchat/config/hexchat
Snap ~/snap/hexchat/current/.config/hexchat

This is also where a client certificate for authentication (CertFP) is placed.

Notes

Mastodon LLIMastodon SocialFosstodon