doc/Modes.txt

   1
   2                      ngIRCd - Next Generation IRC Server
   3                            http://ngircd.barton.de/
   4
   5                (c)2001-2012 Alexander Barton and Contributors.
   6                ngIRCd is free software and published under the
   7                    terms of the GNU General Public License.
   8
   9                                -- Modes.txt --
  10
  11
  12 This document lists the different user modes, channel modes, and channel
  13 user modes that ngIRCd supports.
  14
  15
  16 I. User Modes
  17 ~~~~~~~~~~~~~
  18
  19 User modes are attributes a user has in the network, regardless of the
  20 channels he is using at the moment.
  21
  22   mode  since   description
  23
  24   a     0.3.0   User is away.
  25   b     20      User blocks private messages and notices.
  26   B     20      User is flagged as a "bot".
  27   c     17      IRC operator wants to receive connect/disconnect NOTICEs.
  28   C     19      Only users that share a channel are allowed to send messages.
  29   i     0.0.1   User is "invisible".
  30   o     0.0.1   User is IRC operator.
  31   q     20      User is protected, can not be kicked from a channel.
  32   r     0.0.1   User is restricted.
  33   R (1) 19      User is registered (e.g. by NickServ).
  34   s     0.4.0   User wants to receive server notices.
  35   w     0.11.0  User wants to receive WALLOPS messages.
  36   x     17      Hostname of this user is "cloaked".
  37
  38 II. Channel Modes
  39 ~~~~~~~~~~~~~~~~~
  40
  41 Channel modes are attributes of specific channels which are valid for all
  42 users joined (or trying to join) to this channel. Some modes add and remove
  43 users to lists (e.g. "invite list", "ban list"), others have parameters
  44 (like "channel key"), most are simple flags (like "moderated").
  45
  46   mode  since   description
  47
  48   b     0.5.0   Add/remove a host mask to the ban list.
  49   e     19      Add/remove a host mask to the exception list.
  50   i     0.5.0   Channel is "invite only".
  51   I     0.5.0   Add/remove a host mask to the invite list.
  52   k     0.6.0   Channel has a "key" (a password).
  53   l     0.6.0   Channel has a user limit.
  54   m     0.3.0   Channel is moderated, only "voiced" users can send messages.
  55   M     20      Only registered users (and IRC Ops) can send messages.
  56   n     0.3.0   Channel doesn't allow messages of users not being members.
  57   O     18      Only IRC operators are allowed to join this channel.
  58   P     0.5.0   Channel is "persistent".
  59   Q     20      Nobody can be kicked from the channel.
  60   r (1) 19      Channel is "registered" (e.g. by ChanServ).
  61   R     19      Only registered users are allowed to join this channel.
  62   s     0.9.0   Channel is "secret".
  63   t     0.3.0   Only ChanOps are allowed to modify the channel topic.
  64   V     20      Channel doesn't allow invites.
  65   z     16      Only users connected via SSL are allowed to join the channel.
  66
  67 III. Channel User Modes
  68 ~~~~~~~~~~~~~~~~~~~~~~~
  69
  70 Channel user modes are attributes that a particular user has in a specific
  71 channel of which he is a member.
  72
  73   mode  since   description
  74
  75   q     20      User is channel owner can only be set by a service, other
  76                 owner and irc op. Can promote other users to q, a, o, h, v.
  77   a     20      User is channel admin and can promote other users to v, h, o
  78   o     0.2.0   User is channel operator and can op/kick/... other members.
  79   h     20      User is half op and can set channel modes imntvIbek and kick
  80                 voiced and normal users.
  81   v     0.2.0   User is "voiced" and can speak even if channel is moderated.
  82
  83
  84 Notes
  85 ~~~~~
  86
  87 (1) This mode is not set by ngIRCd itself but by services. ngIRCd handles
  88     the mode transparently and possibly adjusts its behaviour.