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.
- The nickname (
NICK) is the name used to address you and is unique on the network. - The ident (or username,
USER) is the part before the@in the mask. It rarely carries meaning today. - The real name is a free-text field shown by
/whois.
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
- Never publish or reuse an IRC password; services passwords usually cannot be recovered.
- Command names, levels and modes depend on the network and the services software (Anope, etc.): check the network's help (
/msg NickServ help,/msg ChanServ help).