C
Line 1: | Line 1: | ||
- | + | C is our channel services bot here on DareNET. It provides numerous features that help automate channel management, prevent channel takeovers and generally make life easier for both users and staff. This document describes the different commands and features that C provides. | |
== Usage == | == Usage == | ||
- | You can communicate with | + | You can communicate with C via private message, or through server-side aliases, as shown below: |
- | * <code>/msg | + | * <code>/msg C<nowiki><text></nowiki></code> |
- | * <code>/msg | + | * <code>/msg C@services.darenet.org <nowiki><text></nowiki></code> |
* <code>/ChanServ <nowiki><text></nowiki></code> | * <code>/ChanServ <nowiki><text></nowiki></code> | ||
* <code>/CS <nowiki><text></nowiki></code> | * <code>/CS <nowiki><text></nowiki></code> | ||
- | + | C also supports "in-channel" (also known as "fantasy") commands, which is discussed below. | |
For the purpose of this document, we will be using the first two methods listed, as some IRC clients do not readily support server-side aliases without additional setup and/or client commands. However, you can choose to use any of the above methods. | For the purpose of this document, we will be using the first two methods listed, as some IRC clients do not readily support server-side aliases without additional setup and/or client commands. However, you can choose to use any of the above methods. | ||
Line 16: | Line 16: | ||
==In-channel Commands== | ==In-channel Commands== | ||
- | As previously mentioned, | + | As previously mentioned, C supports what we call ''in-channel'' commands. You can use the ''in-channel'' method for just about any of the commands C recognizes. All ''in-channel'' commands directed towards C begin with a period. If a command is given in a channel, and the channel parameter is not given, C will use the name of the channel that the command was used in. |
- | ''In-channel'' commands may only be used in registered channels; however, | + | ''In-channel'' commands may only be used in registered channels; however, C does not have to reside in the channel for them to work. |
'''Example:''' | '''Example:''' | ||
Line 29: | Line 29: | ||
{| class="srvcscmd" width="100%" style="font-size: 90%;" | {| class="srvcscmd" width="100%" style="font-size: 90%;" | ||
|- | |- | ||
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/access|ACCESS]]</span><br />Check a user's access level in a channel. |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/clvl|CLVL]]</span><br />Change a user's access level. |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/mdelowner|MDELCOOWNER]]</span><br />Delete multiple Co-owners. |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/suspend|SUSPEND]]</span><br />Suspend a user's access. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addcoowner|ADDCOOWNER]]</span><br />Grant user Co-owner access. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/clist|CLIST]]</span><br />List all Co-owners. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mdelgrunt|MDELGRUNT]]</span><br />Delete multiple Grunts. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/trim|TRIM]]</span><br />Delete users based on last activity |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addgrunt|ADDGRUNT]]</span><br />Grant user Grunt access. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/deleteme|DELETEME]]</span><br />Delete yourself from a channel's user list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mdelhop|MDELHOP]]</span><br />Delete multiple HalfOps. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/unsuspend|UNSUSPEND]]</span><br />Restore a suspended user's access. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addhop|ADDHOP]]</span><br />Grant user HalfOp access. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/dellamer|DELLAMER]]</span><br />Delete entry from lamers list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mdelmanager|MDELMANAGER]]</span><br />Delete multiple Managers. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/users|USERS]]</span><br />View channel's user list. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addlamer|ADDLAMER]]</span><br />Add entry to lamers list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/deluser|DELUSER]]</span><br />Delete user from channel's user list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mdelop|MDELOP]]</span><br />Delete multiple Ops. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/uset|USET]]</span><br />Set your user options for a channel. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addmanager|ADDMANAGER]]</span><br />Grant user Manager access. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/glist|GLIST]]</span><br />List all Grunts. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mlist|MLIST]]</span><br />View Managers list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/wipeinfo|WIPEINFO]]</span><br />Remove a user's info line. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addop|ADDOP]]</span><br />Grant a user Op access in a channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/giveownership|GIVEOWNERSHIP]]</span><br />Give away ownership of channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/myaccess|MYACCESS]]</span><br />List channels you have access in. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/wlist|WLIST]]</span><br />List all Owners. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/addtimedlamer|ADDTIMEDLAMER]]</span><br />Add entry to lamers list that expires. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/hlist|HLIST]]</span><br />List all HalfOps. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/olist|OLIST]]</span><br />List all Ops. |
| | | | ||
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/adduser|ADDUSER]]</span><br />A more advanced way of granting access to users. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/lamers|LAMERS]]</span><br />View channel's lamers list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/seen|SEEN]]</span><br />View last time a user was in the channel. |
| | | | ||
|} | |} | ||
Line 78: | Line 78: | ||
{| class="srvcscmd" width="100%" style="font-size: 90%;" | {| class="srvcscmd" width="100%" style="font-size: 90%;" | ||
|- | |- | ||
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/ban|BAN]]</span><br />Set a ban on a user/host. |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/events|EVENTS]]</span><br />List recent activity by channel users. |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/op|OP]]</span><br />Grant use Op status (+o). |
- | | style="width: 310px;"|<span class="cmd">[[ | + | | style="width: 310px;"|<span class="cmd">[[C/unbanall|UNBANALL]]</span><br />Clear channel ban list. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/dehop|DEHOP]]</span><br />Remove HalfOp status from user(s). |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/hop|HOP]]</span><br />Grant user HalfOp status (+h). |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/open|OPEN]]</span><br />Remove modes/bans preventing you from joining channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/unbanme|UNBANME]]</span><br />Remove bans matching yourself. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/delnote|DELNOTE]]</span><br />Delete a channel note. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/invite|INVITE]]</span><br />Invite yourself (or others) into the channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/resync|RESYNC]]</span><br />Synchronize the channel's member list. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/unregister|UNREGISTER]]</span><br />Unregister a channel. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/deop|DEOP]]</span><br />Remove Op status from user(s). |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/kick|KICK]]</span><br />Kick user(s) from channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/register|REGISTER]]</span><br />Registers a channel to your account. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/up|UP]]</span><br />Grant yourself (Half)Op status. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/devoice|DEVOICE]]</span><br />Remove Voice status from user(s). |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/kickban|KICKBAN]]</span><br />Kick + Ban user(s) from channel. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/set|SET]]</span><br />Change various channel settings. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/upall|UPALL]]</span><br /> Grant yourself (Half)Op/Voice status in all channels. |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/down|DOWN]]</span><br />Remove (Half)Op/Voice status from yourself. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/mode|MODE]]</span><br />Manipulate channel's mode settings. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/topic|TOPIC]]</span><br />Set (or restore) the channel's topic. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/voice|VOICE]]</span><br />Grant user voice status (+v) |
|- | |- | ||
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/downall|DOWNALL]]</span><br />Remove (Half)Op/Voice status in all channels. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/note|NOTE]]</span><br />Set a channel note. |
- | | <span class="cmd">[[ | + | | <span class="cmd">[[C/unban|UNBAN]]</span><br />Remove entries from channel ban list. |
| | | | ||
|- | |- |
Revision as of 05:54, 11 October 2012
C is our channel services bot here on DareNET. It provides numerous features that help automate channel management, prevent channel takeovers and generally make life easier for both users and staff. This document describes the different commands and features that C provides.
In This Guide: |
Usage
You can communicate with C via private message, or through server-side aliases, as shown below:
-
/msg C<text>
-
/msg C@services.darenet.org <text>
-
/ChanServ <text>
-
/CS <text>
C also supports "in-channel" (also known as "fantasy") commands, which is discussed below.
For the purpose of this document, we will be using the first two methods listed, as some IRC clients do not readily support server-side aliases without additional setup and/or client commands. However, you can choose to use any of the above methods.
In-channel Commands
As previously mentioned, C supports what we call in-channel commands. You can use the in-channel method for just about any of the commands C recognizes. All in-channel commands directed towards C begin with a period. If a command is given in a channel, and the channel parameter is not given, C will use the name of the channel that the command was used in.
In-channel commands may only be used in registered channels; however, C does not have to reside in the channel for them to work.
Example:
To illustrate what we're talking about, let's say we have a channel named #chat and we would like to grant the user JoeClient op status. Using the in-channel method, we could achieve this by simply typing the following in #chat:
.OP JoeClient
User Management Commands
ACCESS Check a user's access level in a channel. | CLVL Change a user's access level. | MDELCOOWNER Delete multiple Co-owners. | SUSPEND Suspend a user's access. |
ADDCOOWNER Grant user Co-owner access. | CLIST List all Co-owners. | MDELGRUNT Delete multiple Grunts. | TRIM Delete users based on last activity |
ADDGRUNT Grant user Grunt access. | DELETEME Delete yourself from a channel's user list. | MDELHOP Delete multiple HalfOps. | UNSUSPEND Restore a suspended user's access. |
ADDHOP Grant user HalfOp access. | DELLAMER Delete entry from lamers list. | MDELMANAGER Delete multiple Managers. | USERS View channel's user list. |
ADDLAMER Add entry to lamers list. | DELUSER Delete user from channel's user list. | MDELOP Delete multiple Ops. | USET Set your user options for a channel. |
ADDMANAGER Grant user Manager access. | GLIST List all Grunts. | MLIST View Managers list. | WIPEINFO Remove a user's info line. |
ADDOP Grant a user Op access in a channel. | GIVEOWNERSHIP Give away ownership of channel. | MYACCESS List channels you have access in. | WLIST List all Owners. |
ADDTIMEDLAMER Add entry to lamers list that expires. | HLIST List all HalfOps. | OLIST List all Ops. | |
ADDUSER A more advanced way of granting access to users. | LAMERS View channel's lamers list. | SEEN View last time a user was in the channel. |
Channel Management Commands
BAN Set a ban on a user/host. | EVENTS List recent activity by channel users. | OP Grant use Op status (+o). | UNBANALL Clear channel ban list. |
DEHOP Remove HalfOp status from user(s). | HOP Grant user HalfOp status (+h). | OPEN Remove modes/bans preventing you from joining channel. | UNBANME Remove bans matching yourself. |
DELNOTE Delete a channel note. | INVITE Invite yourself (or others) into the channel. | RESYNC Synchronize the channel's member list. | UNREGISTER Unregister a channel. |
DEOP Remove Op status from user(s). | KICK Kick user(s) from channel. | REGISTER Registers a channel to your account. | UP Grant yourself (Half)Op status. |
DEVOICE Remove Voice status from user(s). | KICKBAN Kick + Ban user(s) from channel. | SET Change various channel settings. | UPALL Grant yourself (Half)Op/Voice status in all channels. |
DOWN Remove (Half)Op/Voice status from yourself. | MODE Manipulate channel's mode settings. | TOPIC Set (or restore) the channel's topic. | VOICE Grant user voice status (+v) |
DOWNALL Remove (Half)Op/Voice status in all channels. | NOTE Set a channel note. | UNBAN Remove entries from channel ban list. |
Quote Database Management Commands
ADDQUOTE Add a quote. | DELQUOTE Delete a quote. | QUOTE View a quote, or search quote database. | QVOTE Rate a quote. |
Informative / Miscellaneous Commands
COMMAND View some misc. info about a command. | INFO View channel's registration record. | LEVELS List numerical equivalents for named access levels. | STAFF List all network staff (opers+helpers) currently online. |
HELPERS List support helpers currently online. | IRCOPS List IRC operators currently online. | PEEK View information on a channel's modes, topic and member list. | VERSION View version information about ChanServ. |
Toys
8BALL Ask the magic 8ball a question. | FML Get a random quote from www.fmylife.com. | INSPIRE Get a random inspirational quote. | PASTEBIN Paste text to pastebin.com. |
CALC Calculate a mathematical expression. | GOOGLE Search Google. | ISGD Expands or shortens url for is.gd. | TWITTER View tweets via IRC. |
DICE Roll the dice. | GUESS Guess the number (between 1 and 100). | ISITDOWN Check whether a site is reachable (up) or not (down). | WEATHER Get weather conditions for a location. |