xero's irc ref

2020-05-03 • 2020-04-04

This is a scraping of xero's irc ref from https://gist.github.com/xero/2d6e4b061b4ecbeb9f99

0.1 The Basics

command meaning
/join #channel Joins the specified channel.
/part #channel Leaves the specified channel.
/quit <message> Disconnects from current server with optional leaving message.
/server hostname Connects to the specified server.
/list Lists all channels on the current network.
/links Lists all servers on the current network. May be disabled "for
/nick nickname Changes your nick.
/names #channel Shows the nicks of all users on #channel.
/msg nickname message Sends a private message to a user.
/query nickname message Sends a private message to a user and opens a private chat window.
/me action Prints "yourname action"
/notice nickname message Sends a notice to the specified user. Like a /msg, but usually makes a sound.
/whois nickname Shows information about the specified user. This action is not
/whowas nickname Shows information about a user who has quit.
/dns nickname Attempts to resolve the IP address of the specified user. Doesn't
/ping nickname Pings the specified user. This action is visible to the specified user.

0.2 Nick Management (NickServ)

All nickserv commands begin with /ns or /msg NickServ. Depending on your client, /ns may not work.

/ns register password <email> Registers your current nick with NickServ with the chosen password and binds it to an e-mail address (optional).
/ns identify password Identifies your nick to NickServ using the password you set. If you have a nick that's been registered, and you don't i
/ns recover nickname password Kills (forcibly disconnects) someone who has your registered nick.
/ns ghost nickname password Terminates a "ghost" IRC session that's using your nickname.
/ns set password yournewpassword Changes your password. NOTE: Under no circumstances should you change your nick to the letter O followed by 8 digit

0.3 Channel modes

Set a mode with: /mode #channel +/-attribute <data>.

+n Disallows external messages.
+t Only op/hops can set the topic.
+p Sets the channel as invisible in /list.
+s Sets the channel as invisible in /list and /whois.
+i Sets the channel as closed unless the person was invited.
+k <pass> Sets a password for the channel which users must enter to join.
+l <number> Sets a limit on the number of users who are allowed in the channel
+m Prevents users who are not opped/hopped/voiced from talking.
+R Sets the channel so only registered nicks are allowed in.
+M Sets the channel so only registered nicks are allowed to talk.
+S Strips formatting from messages, rendering them as plaintext.
+c Blocks messages containing color codes.
+i A user must be invited to join the channel.
+N No nick changes permitted in the channel.

0.4 ChanServ commands

All ChanServ commands begin with /cs or /chanserv or /msg ChanServ. Depending on your client, /cs or /chanserv may not work.

/cs set #channel secureops <on|off> Keeps everyone except aops, sops, and the founder from becoming ops.
/cs identify #channel <password> Identifies you as the channel's founder and gives you founder-level privileges.
/cs set #channel mlock modes Locks the channel's modes. Just + unlocks all.
/cs set #channel keeptopic <on|off> Maintains the topic even if everyone leaves.
/cs set #channel enforce <on|off> Restores op/halfop/voice if a person with op/halfop/voice gets de-opped/halfopped/voiced.
/cs set #channel leaveops <on|off> Whether or not to allow the first person who join the channel to get ops.
/cs register #channel password description Registers the current channel to you with ChanServ and sets its password and description.
/cs drop #channel <dropcode> Un-registers the current channel to you with ChanServ.
/cs set #channel founder <nickname> Sets the current channel's founder.
/cs set #channel password <newpass> Changes the current channel's password to newpass.
/cs set #channel desc <description> Changes the current channel's description.
/cs set #channel url <address> Associates a URL with the channel.
/cs set #channel <email@address> Associates an email address with the channel.

1 Other stuff

1.1 Kicking people

/kick #channel nickname <reason> temporarily remove user from channel
/mode nickname +/-attributes <data> Setting people's modes (for current channel only)

1.2 User modes

+q User is owner of the current channel (prefix ~ on UnrealIRCd, usually @ elsewhere)
+a User is an admin (SOP) on the current channel (prefix & on UnrealIRCd, usually @ elsewhere).
+o User is an operator (AOP) on the current channel (prefix @).
+h User is a half-op on the current channel (prefix %).
+v User has voice on the current channel (prefix +).

1.3 Banning people

  • /mode *channel +b hosts
    • Hosts take the following form: nickname!userid@hostname
  • Use /whois, /whowas or /who to find the information necessary for a ban.
  • * is a wildcard and can replace nickname, userid, parts of nickname or userid, hostname or a segment of a hostname.

1.3.1 Examples:

joe!*@* Will prevent anyone with the nick joe from joining.
*myg0t*!* Will prevent anyone whose nick contains myg0t from joining.
mark!*elc@* Will prevent anyone with the nick mark and the userid elc from joining.
*!*@c-123-24-76-213.ga.isp.net Will prevent anyone with the host c-123-24-76-213.ga.isp.net from joining.
*!*@* Bans everyone. Don't do that.

1.4 Access lists

/cs access #channel add <nickname> <level> Adds nickname to the channel's access list at the specified level.
/cs access #channel del <nickname> Removes nickname from the channel's access list.
/cs access #channel list Displays the channel's access list.
/cs access #channel count Displays how many entries are in the channel's access list.

1.4.1 Access levels

These may vary from network to network. For example, some networks do not go by tens and use 3, 4, 5, 10, etc.

Founder Full access to ChanServ functions, automatic opping upon entering channel.
100+ Makes the person an SOP, automatic opping upon entering channel.
50 Makes the parson an AOP, automatic opping upon entering channel.
40 Automatic half-opping.
30 Automatic voicing.
0 No special privileges.
-1 May not be opped.
-100 May not join the channel.

Any nick not on the access list has an access level of 0.

2 AOPs and SOPs

2.1 AOPs

  • Are automatically ops and can give themselves ops.
  • Can give/take op/halfop/voice to/from other channel members.
  • Can unban themselves.
  • Receive memos sent to the whole channel.
  • Can invite themselves to the channel.

2.2 SOPs

  • Can do everything AOPs can.
  • Can give and take AOP privileges.
  • Receive memos sent to the channel's SOPs.
  • Can add (but not remove) AKICKs.

2.3 Viewing and setting privileges

/cs <aop|sop> #channel list= Viewing AOP and SOP lists
/cs <AOP|SOP> #channel <ADD|DEL|LIST|CLEAR> <nick|entry-list> adding a AOP or SOP

2.4 AKICKs

People on the AKICK list are automatically kicked and banned when they enter the channel. Bans made as a result of AKICK must be removed manually.

/cs akick #channel add host <reason> Adds host to #channel's AKICK list (for reason).
/cs akick #channel del host Removes host from the AKICK list.
/cs akick #channel <list|view> Displays the AKICK list.

2.5 Color codes

it's possible to color your text in irc. in most clients you can use control c then foreground,background (background is optional). examples: red text ^c4. black text on a blue background ^c1,2. here's a full list of the color codes:

Number Name
00 white
01 black
02 blue (navy)
03 green
04 red
05 brown (maroon)
06 purple
07 orange (olive)
08 yellow
09 light green (lime)
10 teal (a green/blue cyan)
11 light cyan (cyan / aqua)
12 light blue (royal)
13 pink (light purple / fuchsia)
14 grey
15 light grey (silver)

2.6 Related