ChanServ

From OGN-Wiki

Jump to: navigation, search

ChanServ is used to administrate a channel. The rights you have in a channel depends on your access which is saved at your AuthServ account.

Contents

Commands


All commands are executable by

  • !(#channel) <command>
  • /cs #channel <command>
  • /msg ChanServ #channel <command>

User administration in your channel


  • ADDUSER nick|*account level
    • Adds a user to the user list with a specific access level. levels range from 1 to 500 generally, while only one can have 500 (owner access) at a time. For unchanged channel settings there are:
      • Level 1-99: user can get channel invitations on himself/herself
      • Level 100-199: user automatically gets voice (+v) on join
      • Level 200-299: user automatically gets op (+o/+@) on join
      • Level 300-399: user can add others to channel’s user list
      • Level 400-500: user can change channel settings
    • A user with 300 access of course gets +o as well. Privileges are entailed though. The voiced flag is an exception here, because its unnecessary while having the Op state. The maximum that can be granted by oneself is the own access level minus one.
  • Aliases of ADDUSER
    • ADDPEON <nick|*account>: same as: ADDUSER <nick|*account> 100.
    • ADDOP <nick|*account>: same as: ADDUSER <nick|*account> 200.
    • ADDMASTER <nick|*account>: same as: ADDUSER <nick|*account> 300.
    • ADDCOOWNER <nick|*account>: same as: ADDUSER <nick|*account> 400. ADDCO is the short form of it.
    • ADDOWNER <nick|*account>: same as: <nick|*account> 500. This command is unavailable for common users.

required channel access: 300


  • DELUSER <nick|*account>
    • This command deletes the channel access of other users (only users with lower access levels can be deleted)

required channel access: 300


  • MDELPEON <name pattern>
    • This command deletes all users with exactly level 100, while the used pattern is a search mask in the peon list. A pattern can be a word that may/should contain wildcards. wildcards are * (any string possible) and ? (one specific char). For example: *jod*e? would match for each account that has "jod" as successive string and that ends with "e" followed by another character. This alias exists for access levels 100, 200, 300, 400, 500. Possible variants are listed below:
      • MDELPEON required channel access: 300
      • MDELOP required channel access: 300
      • MDELMASTER required channel access: 400
      • MDELCOOWNER required channel access: 500
      • MDELOWNER required channel access: not available for common users

again MDELCO is the short form for MDELCOOWNER


  • CLVL <nick|*account> <level>
    • This command changes the channel access of a user. The treated user has got to HAVE and has got to GET a lower access level than oneself to be executed.

required channel access: 300


  • ACCESS [nick|*account] (or A [nick|*account])
    • This command shows the access level of a specific user in that channel. In case the command is executed without declaration of a user, your own access is shown.
  • TRIM <access group|access range> <time>
    • This command deletes matching groups that havn’t been there for a given time. Access groups are "users" (all users below own access level) and "bans" (bans within ban list), while access ranges can be 200-399 for example. "210" would delete all with access 210, but would not remove users with 209 or 211 access. Times are defined by common abbreviations:
      • s - seconds
      • m - minutes
      • h - hours
      • w - weeks
      • M - months
      • y - years

Note the difference between minutes and months (case sensitive !!). Times are combineable, like 1w1h3m. example: TRIM 200-150 3w2d would delete all users with access between 200 and 150 that havn’t been there for at least 3 weeks and 2 days.

required channel access: 300


  • SUSPEND [nick]
    • This command suspends the access of a user. User has to have lower access than oneself. The suspended user is not capable of regaining his/her access himself/herself and cannot use the rights usually granted by the access level. User can be unsuspended by UNSUSPEND [nick].

required channel access: 300


  • RESYNC
    • This command synchronizes the access flags of the users in the channel with the user list. Users who recently gained 200 access will gain +o flag this way, assuming the giveops and givevoice settings are unchanged still. Users who got deleted will lose their flags after resync. Users that got +o or +v that ain’t listed in user list at all will also lose their flags.

required channel access: 300


  • UP
    • This command grants yourself channel flags depending on your access level and channel settings.


  • UPALL
    • This command grants yourself channel flags depending on your access level and channel settings in aLL channels with chanserv that you are in.


  • DOWN
    • This command takes any channel flags independent of your access level. Access remains unchanged.


  • DOWNALL
    • This command takes any channel flags independent of your access level in ALL channels you are in.


  • INVITEME #channel (or: INVITE #channel)
    • With this command users can invite themselves into invite only channels (mode +i). They have got to be on the user list of that channel. auto-invitation can be granted by USET AUTOINVITE (later on)

required channel access: 1, can be adapted by SET INVITEME

ChanServ user settings

  • USET <option> <value>
    • sets the chosen option with the chosen value
      • INFO <info>
        • Effect: sets your InfoLine that is shown at each join (assumed you've been waiting for at least 30 secs before rejoining the chan and assumed you are logged in. This command is equivalent to !SETINFO <info>. The command !SET USERINFO <access level> can restrict presentation of infolines depending on access of the user. !WIPEINFO <user> can delete such infolines for other users
      • NOAUTOOP 0|1 / NOAUTOVOICE 0|1
        • Effect: This option makes ChanServ setting (or not setting) user channel flags on join. (0) is standard setting for it. If (1) is chosen, you dont get +@ even if you still are an operator
      • AUTOINVITE 0|1
        • Effect: If this option is chosen (1) in a channel, chanserv will invite you into this channel on authing. Standard setting is (0).
      • WIPEINFO <nick|*authnick>
        • Deletes Infolines of other (lower accessed) users in a channel.

required channel access: 300

Other ChanServ related User-Commands

  • User settings who are not triggered by 'uset' Commands
    • !myaccess or /cs myaccess
      • Lists your global Channel access

ChanServ actions and ban management

  • KICK <nick|mask> <reason>
    • Kicks the specified user (or users that meet the specified mask) with a statement like: (yourNick) reason. With standard settings the user you kick has to have lower access than you. This can be changed by !SET PROTECT. short form is !k nick

required channel access: 200


  • BAN <nick|mask> <reason>
    • Bans the specified nick or mask with reason if stated. short form is !b nick

required channel access: 200


  • UNBAN <nick|mask>
    • Unbans the specified nick or mask (ban from banlist is not deleted that way! Just the mask or the nick is unbanned (-b))

required channel access: 200


  • UNBANME
    • Unbans all banmasks that match you, short form is UBM.

required channel access: 200


  • UNBANALL
    • Unbans all bans (+b) in a channel. Shortform is UBA.

required channel access: 200


  • KICKBAN <nick|mask> reason
    • kicks and bans the specified nick or all users that fit to the specified mask. Short form is !kb nick. Users with lower access can be banned, but this is adjustable by !set protect.

required channel access: 200


  • ADDBAN <nick|mask>
    • Kicks and bans the specified nick or all users that match the specified masks permanently and adds those masks to the ban list (blist). Entries in that list ain’t deletable with UBA or unban (see DELBAN). The user has to have lower access than you in case SET PROTECT remains unchanged.

required channel access: 250


  • DELBAN <nick|mask> <reason>
    • Deletes normal as well as permanent bans (/mode +b in chan and !addban)

required channel access: 250


  • ADDTIMEDBAN <nick|mask> <time> <reason>
    • Bans the specified nick or all users who fit to the used mask permanently or for a given time. The time units used are the same as those used for TRIM. The banned user has to have lower access than you, depending on SET PROTECT values. TB and ATB are short forms for ADDTIMEDBAN. Bans set by ATB can be deleted by DELBAN only.

required channel access:250


  • OP <nick> [nick]
    • This command grants OP (+@).

required channel access (depending on SET ENFOPS): 200 standard


  • VOICE <nick> [nick]
    • This command grants VOICE (+v).

requiered channel access: 200


  • DEOP <nick> [nick]
    • This command removes OP-Flag (-@).

required channel access (depending on SET ENFOPS): 200 standard


  • DEVOICE <nick> [nick]
    • This command removes VOICE-Flag (-v).

requiered channel access: 200


  • TOPIC [topic]
    • This command sets the topic of a channel. In case no parameter is submitted, the SET DEFAULTTOPIC is set. In the other case several things can happen:
      • With at least SET ENFTOPIC access the topic will be overwritten by [topic]
      • In case you have less access AND a SET TOPICMASK exists, the [topic] will be included at the wildcard-place in SET TOPICMASK.
      • In case you have less access AND no SET TOPICMASK exists, nothing happens

required channel access: 200


  • MODE [+|-][+|-][CcmntilkDrspov] [limit] [pw] [nick] [further nicks]
    • This command sets the modes of a channel. If no parameter is submitted, standard-modes are set. If parameters are submitted, these modes are set. Standard-modes only can be overwritten by users with higher access than SET ENFMODES-Value. Overview over all chan modes

required channel access: 200

ChanServ channel settings

SET <setting> <value> Sets the setting <setting> the value <value>.

Settings and possible values are:

  • Setting: DEFAULTTOPIC
    • Possible values: Any sentence
      • Sets the Defaulttopic, that is the topic which is used for TOPIC without parameters
  • Setting: TOPICMASK
    • Possible values: Any sentence
      • Sets the Topicmask with a variable part * which is overwritten with the parameters used together with TOPIC.
  • Setting: GREETING
    • Possible values: Any sentence
      • Sets the Greeting which is displayed to any user who joins the channel. If the user has access and a USERGREETING is set it won't be displayed.
  • Setting: USERGREETING
    • Possible values: Any sentence
      • Sets the Usergreeting which is displayed to a user with access in the channel when the user joins. The GREETING won't be displayed.
  • Setting: MODES
    • Possible values: [+|-][+|-][CcmntilkDrspov] [limit] [pw] [nick] [other nicks]
      • Sets the standard modes, which are used for MODE without parameters. They can only be changed by users with ENFMODE access.
  • Setting: PUBCMD
    • Possible values: <level>
      • Sets the level that a user needs to execute public commands (like !topic).
  • Setting: INVITEME
    • Possible values: <level>
      • Sets the level that a user needs to invite himself into the channel.
  • Setting: USERINFO
    • Possible values: <level>
      • Sets the level which is needed for a displayed infoline when a user joins the channel.
  • Setting: GIVEVOICE
    • Possible values: <level>
      • Sets the level which is needed to get voice automatically after joining.
  • Setting: GIVEOPS
    • Possible values: <level>
      • Sets the level which is needed to get op automatically after joining.
  • Setting: ENFOPS
    • Possible values: <level>
      • Sets the level that a user needs to give another user op.
  • Setting: ENFMODES
    • Possible values: <level>
    • Sets the level which is needed to overwrite the standard modes.
  • Setting: ENFTOPIC
    • Possible values: <level>
      • Sets the level which is needed to overwrite the DEFAULTTOPIC.
  • Setting: TOPICSNARF
    • Possible values: <level>
      • Sets the level which is needed to overwrite the DEFAULTTOPIC via /topic #channel <topic>.
  • Setting: SETTERS
    • Possible values: <level>
      • Sets the level which is needed to change the channelsettings
  • Setting: VOTERS
    • Possible values: <level>
      • Sets the level which is needed to contest an election
  • Setting: PROTECT
    • Possible values: 0-3
      • Sets which user is protected from kicks, bans and deops by other users.
        • 0 - All users will be protected from users with equal or lower access.
        • 1 - All users with access will be protected from users with equal or lower access.
        • 2 - All users with access will be protected from users with lower access.
        • 3 - Nobody will be protected.

Beware: Setting the Protect Level, does ONLY protect against kicks and bans done via CHANSERV. It is therefore still possible to kick someone by using /kick <Nick> as a Channel Operator. The person bypassing the protect level that way, will be kicked afterwards though - if a suitable level is set (0,1,2).

  • Setting: TOYS
    • Possible values: 0-2
      • Sets if you can use funcommands like !8ball (not explained).
        • 0 - Funcommands can't be used.
        • 1 - Funcommands are possible but the reply will be sent as a notice.
        • 2 - Funcommands are possible and the reply will be sent to the channel.
  • Setting:DYNLIMIT
    • Possible values: 0|1
      • Sets if the limit should increase every 30 seconds by 15 (to avoid joinfloods).
  • Setting: NODELETE
    • Possible values: 0|1
      • Sets if the channel is protected against unregistering (because of long inactivity). ONLY settable by Ops.

Required channel access (depending on SET SETTERS): 400 is standard

Votes

  • ADDVOTE <questions>
    • Creates a new vote. To execute this command no other vote is allowed to be active.

required channel access: 300


  • DELVOTE
    • This command deletes a vote. After this command nobody can vote and list the results of the old vote.

required channel access: 300


  • ADDOPTION <option>
    • Adds an option to the vote. You can add as many options as you want. They will be numbered. To start a vote you need at least 2 options.

required channel access: 300


  • DELOPTION <option>
    • This command deletes a current option. Option has to be the ID of the option.

required channel access: 300


  • STARTVOTE
    • This command starts the vote in the channel. The users can now vote.

required channel access: 300


  • ENDVOTE
    • This command stops a vote. Nobody can vote but you can see the result with VOTERESULTS.

required channel access: 300


  • VOTERESULTS [*]
    • This command displays the current results of the vote. If you use the * parameter, they will be displayed in the channel for all. The parameter * is only possible for users with 300 channel access.

required channel access: 300


  • VOTE <option>
    • With this command you'll vote for the ID you entered as <option>


Required channel access (depending on VOTERS): 1 is standard.

Personal tools