#+title: xero's irc ref
#+title_extra: {{{detail(Scraped from [[https://gist.github.com/xero/2d6e4b061b4ecbeb9f99][this gist]])}}}
#+rss_title: xero's irc ref
#+pubdate: <2020-04-04 Sat>


** [[#h-af9b727a-fe44-40f2-8ba6-e18272277397][The Basics]]
:PROPERTIES:
:CUSTOM_ID: h-af9b727a-fe44-40f2-8ba6-e18272277397
:END:

| 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.       |

** [[#h-4404e409-385b-48dd-9eb1-b42e9f161876][Nick Management (NickServ)]]
:PROPERTIES:
:CUSTOM_ID: h-4404e409-385b-48dd-9eb1-b42e9f161876
:END:

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   |

** [[#h-6dc4ab3f-d0ed-4c66-b41a-719058cb93c2][Channel modes]]
:PROPERTIES:
:CUSTOM_ID: h-6dc4ab3f-d0ed-4c66-b41a-719058cb93c2
:END:

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.                          |

** [[#h-a226cb18-b018-4504-8261-0b65f28a02e5][ChanServ commands]]
:PROPERTIES:
:CUSTOM_ID: h-a226cb18-b018-4504-8261-0b65f28a02e5
:END:

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


# pain
# #+MACRO:  code @@html:<code>@@$1@@html:</code>@@
# using ! so org tables cal still align and \vert{} inline looks gross to me here
#+macro: code (eval (format "@@html:<code>@@%s@@html:</code>@@" (s-replace "!" "\\vert{}" $1)))

| {{{code(/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.                                            |
| {{{code(/cs set #channel keeptopic <on!off>)}}} | Maintains the topic even if everyone leaves.                                              |
| {{{code(/cs set #channel enforce <on!off>)}}}   | Restores op/halfop/voice if a person with op/halfop/voice gets de-opped/halfopped/voiced. |
| {{{code(/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.                                             |

* [[#h-b90868c6-7968-4fa1-b6fb-de667b7599c1][Other stuff]]
:PROPERTIES:
:CUSTOM_ID: h-b90868c6-7968-4fa1-b6fb-de667b7599c1
:END:

** [[#h-d321c0d4-db80-4f25-8941-933172fac07e][Kicking people]]
:PROPERTIES:
:CUSTOM_ID: h-d321c0d4-db80-4f25-8941-933172fac07e
:END:

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

** [[#h-c03ad93e-65cc-4dd6-9aa7-af5c82dcf350][User modes]]
:PROPERTIES:
:CUSTOM_ID: h-c03ad93e-65cc-4dd6-9aa7-af5c82dcf350
:END:

| =+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 +).                                            |

** [[#h-07580360-b48c-4a4a-818a-61f1f750ecfc][Banning people]]
:PROPERTIES:
:CUSTOM_ID: h-07580360-b48c-4a4a-818a-61f1f750ecfc
:END:

- =/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=.

*** [[#h-1cca042b-1f35-4d85-acf0-e379c7224f4d][Examples:]]
:PROPERTIES:
:CUSTOM_ID: h-1cca042b-1f35-4d85-acf0-e379c7224f4d
:END:

| =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.                                              |

** [[#h-76341ce0-127b-4af7-bb0c-7f0e46086748][Access lists]]
:PROPERTIES:
:CUSTOM_ID: h-76341ce0-127b-4af7-bb0c-7f0e46086748
:END:

| =/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.        |

*** [[#h-249213a8-a9fa-43e9-9a46-f9d15df4f420][Access levels]]
:PROPERTIES:
:CUSTOM_ID: h-249213a8-a9fa-43e9-9a46-f9d15df4f420
:END:

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=.

* [[#h-c32b1089-530f-473f-9331-1c78baab2b41][AOPs and SOPs]]
:PROPERTIES:
:CUSTOM_ID: h-c32b1089-530f-473f-9331-1c78baab2b41
:END:

** [[#h-253a1f1e-e527-461b-b323-b92cabde0574][AOPs]]
:PROPERTIES:
:CUSTOM_ID: h-253a1f1e-e527-461b-b323-b92cabde0574
:END:

- 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.

** [[#h-a395932a-b851-4a52-958c-05987399ff40][SOPs]]
:PROPERTIES:
:CUSTOM_ID: h-a395932a-b851-4a52-958c-05987399ff40
:END:

- 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.

** [[#h-da4abeac-93a5-427a-87cc-270d9cd61125][Viewing and setting privileges]]
:PROPERTIES:
:CUSTOM_ID: h-da4abeac-93a5-427a-87cc-270d9cd61125
:END:

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

** [[#h-e0d5cdf5-5b64-4da5-8973-c00702bc3107][AKICKs]]
:PROPERTIES:
:CUSTOM_ID: h-e0d5cdf5-5b64-4da5-8973-c00702bc3107
:END:

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.                |
| {{{code(/cs akick #channel <list!view>)}}} | Displays the AKICK list.                         |

** [[#h-783bf87b-f96c-4b8d-a756-651cb73c3a64][Color codes]]
:PROPERTIES:
:CUSTOM_ID: h-783bf87b-f96c-4b8d-a756-651cb73c3a64
:END:

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)           |

** [[#h-f34114f3-04ec-4275-a9e5-03dd636cff16][Related]]
:PROPERTIES:
:CUSTOM_ID: h-f34114f3-04ec-4275-a9e5-03dd636cff16
:END:

(cw: 🅱enis) https://youtu.be/R8FOGlnYkgg