docs/conf/helpop.conf.example

   1 # Sample configuration file for m_helpop.so
   2 # You can either copy this into your conf folder and set up the module to use it,
   3 # or you can customize the responses for your network and/or add more.
   4 #
   5 # The way the new helpop system works is simple. You use one or more helpop tags.
   6 #   <helpop key="moo" value="something here">.
   7 # key is what the user is looking for (i.e. /helpop moo), and value is what they get back
   8 # (note that it can span multiple lines!).
   9 #   -- w00t 16/dec/2006
  10 #
  11
  12 <alias text="HELP" replace="HELPOP $2-">
  13
  14 <helpop key="start" value="InspIRCd Help System
  15
  16 This system provides help for commands and modes.
  17 Specify your question or a command name as the
  18 parameter for this command.
  19
  20 /HELPOP CUSER    -      To see a list of user commands
  21 /HELPOP COPER    -      To see a list of oper commands
  22 /HELPOP UMODES   -      To see a list of user modes
  23 /HELPOP CHMODES  -      To see a list of channel modes
  24 /HELPOP SNOMASKS -      To see a list of oper snotice masks
  25 /HELPOP EXTBANS  -      To see a list of extended bans">
  26
  27 <helpop key="nohelp" value="There is no help for the topic
  28 you searched for. Please try again.">
  29
  30 <helpop key="cuser" value="User Commands
  31 -------------
  32
  33 PRIVMSG   NOTICE   NICK      JOIN      PART
  34 CYCLE     KNOCK    MODE      DEVOICE   TOPIC
  35 KICK      FPART    REMOVE    TBAN      INVITE
  36 UNINVITE  AWAY     DCCALLOW  SILENCE   ACCEPT
  37 MKPASSWD  VHOST    TITLE     SETNAME
  38
  39 WHOIS     WHOWAS   ISON      USERHOST  WATCH
  40 LIST      NAMES    WHO       MOTD
  41 ADMIN     MAP      LINKS     LUSERS    TIME
  42 STATS     VERSION  INFO      MODULES   COMMANDS
  43 SSLINFO
  44
  45 USER      PASS     PING     PONG       QUIT
  46
  47 OPER">
  48
  49 <helpop key="coper" value="Oper Commands
  50 -------------
  51
  52 OPERMOTD  CHECK     CLONES      USERIP   TLINE
  53 ALLTIME   WALLOPS   GLOBOPS
  54
  55 SETHOST   SETIDENT  CHGHOST     CHGIDENT CHGNAME
  56 SETIDLE   SWHOIS
  57
  58 SANICK    NICKLOCK  NICKUNLOCK
  59
  60 SAJOIN    SAPART    SAMODE      SATOPIC  SAKICK
  61
  62 KILL      SAQUIT    GLINE       ZLINE    QLINE
  63 KLINE     RLINE     ELINE       CBAN     SHUN
  64 FILTER    CLEARCHAN
  65
  66 CONNECT   SQUIT     RCONNECT    RSQUIT
  67
  68 DIE            RESTART      REHASH
  69 CLEARCACHE     LOADMODULE   UNLOADMODULE
  70 RELOADMODULE   GLOADMODULE  GUNLOADMODULE
  71 GRELOADMODULE  CLOSE        JUMPSERVER
  72 LOCKSERV       UNLOCKSERV">
  73
  74 <helpop key="umodes" value="User Modes
  75 ----------
  76
  77  c            Blocks private messages and notices from users who do
  78               not share a common channel with you (requires
  79               commonchans module).
  80  d            Deaf mode. User will not receive any messages or notices
  81               from channels they are in (requires deaf module).
  82  g            In combination with /ACCEPT, provides for server side
  83               ignore (requires callerid module).
  84  h            Marks as 'available for help' in WHOIS (IRCop only,
  85               requires helpop module).
  86  i            Makes invisible to /WHO if the user using /WHO is not in
  87               a common channel.
  88  k            Prevents the user from being kicked from channels, or
  89               having op modes removed from them (services only,
  90               requires servprotect module).
  91  o            Marks as a IRC operator.
  92  s <mask>     Receives server notices specified by <mask>
  93               (IRCop only).
  94  r            Marks as a having a registered nickname
  95               (requires services account module).
  96  w            Receives wallops messages.
  97  x            Gives a cloaked hostname (requires cloaking module).
  98  B            Marks as a bot (requires botmode module).
  99  G            Censors messages sent to the user based on filters
 100               configured for the network (requires censor module).
 101  H            Hides an oper's oper status from WHOIS (requires
 102               hideoper module).
 103  I            Hides a user's entire channel list in WHOIS from
 104               non-IRCops (requires hidechans module).
 105  R            Blocks private messages from unregistered users
 106               (requires services account module).
 107  S            Strips mIRC color/bold/underline codes out of private
 108               messages to the user (requires stripcolor module).
 109  W            Receives notification when a user uses WHOIS on them
 110               (IRCop only, requires showwhois module).">
 111
 112 <helpop key="chmodes" value="Channel Modes
 113 -------------
 114
 115  v <nickname>       Gives voice to <nickname>, allowing them to speak
 116                     while the channel is +m.
 117  h <nickname>       Gives halfop status to <nickname> (requires
 118                     customprefix module).
 119  o <nickname>       Gives op status to <nickname>.
 120  a <nickname>       Gives protected status to <nickname>, preventing
 121                     them from them from being kicked (+q only,
 122                     requires customprefix module).
 123  q <nickname>       Gives owner status to <nickname>, preventing them
 124                     from being kicked (Services or only, requires
 125                     customprefix module).
 126
 127  b <hostmask>       Bans <hostmask> from the channel.
 128  e <hostmask>       Excepts <hostmask> from bans (requires
 129                     banexception module).
 130  I <hostmask>       Excepts <hostmask> from +i, allowing matching
 131                     users to join while the channel is invite-only
 132                     (requires inviteexception module).
 133
 134  c                  Blocks messages containing mIRC color codes
 135                     (requires blockcolor module).
 136  d <time>           Blocks messages to a channel from new users
 137                     until they have been in the channel for <time>
 138                     seconds (requires delaymsg module).
 139  f [*]<lines>:<sec> Kicks on text flood equal to or above the
 140                     specified rate. With *, the user is banned
 141                     (requires messageflood module).
 142  i                  Makes the channel invite-only.
 143                     Users can only join if an operator
 144                     uses /INVITE to invite them.
 145  j <joins>:<sec>    Limits joins to the specified rate (requires
 146                     joinflood module).
 147  k <key>            Set the channel key (password) to <key>.
 148  l <limit>          Set the maximum allowed users to <limit>.
 149  m                  Enable moderation. Only users with +v, +h, or +o
 150                     can speak.
 151  n                  Blocks users who are not members of the channel
 152                     from messaging it.
 153  p                  Make channel private, hiding it in users' whoises
 154                     and replacing it with * in /LIST.
 155  r                  Marks the channel as registered with Services
 156                     (requires services account module).
 157  s                  Make channel secret, hiding it in users' whoises
 158                     and /LIST.
 159  t                  Prevents users without +h or +o from changing the
 160                     topic.
 161  u                  Makes the channel an auditorium; normal users only
 162                     see themselves or themselves and the operators,
 163                     while operators see all the users (requires
 164                     auditorium module).
 165  w <flag>:<banmask> Adds basic channel access controls of <flag> to
 166                     <banmask>, via the +w listmode.
 167                     For example, +w o:R:Brain will op anyone identified
 168                     to the account 'Brain' on join.
 169                     (requires autoop module)
 170  z                  Blocks non-SSL clients from joining the channel.
 171
 172  A                  Allows anyone to invite users to the channel
 173                     (normally only chanops can invite, requires
 174                     allowinvite module).
 175  B                  Blocks messages with too many capital letters,
 176                     as determined by the network configuration
 177                     (requires blockcaps module).
 178  C                  Blocks any CTCPs to the channel (requires noctcp
 179                     module).
 180  D                  Delays join messages from users until they
 181                     message the channel (requires delayjoin module).
 182  E [~*][lines]:[sec]{[:difference]}{[:backlog]} Allows blocking of similiar messages.
 183                     Kicks as default, blocks with ~ and bans with *
 184                     The last two parameters are optional.
 185  F <changes>:<sec>  Blocks nick changes when they equal or exceed the
 186                     specified rate (requires nickflood module).
 187  G                  Censors messages to the channel based on the
 188                     network configuration (requires censor module).
 189  J <seconds>        Prevents rejoin after kick for the specified
 190                     number of seconds. This prevents auto-rejoin
 191                     (requires kicknorejoin module).
 192  K                  Blocks /KNOCK on the channel.
 193  L <channel>        If the channel reaches its limit set by +l,
 194                     redirect users to <channel> (requires redirect
 195                     module).
 196  M                  Blocks unregistered users from speaking (requires
 197                     services account module).
 198  N                  Prevents users on the channel from chainging nick
 199                     (requires nonicks module).
 200  O                  Channel is IRCops only (can only be set by IRCops,
 201                     requires operchans module).
 202  P                  Makes the channel permanent; Bans, invites, the
 203                     topic, modes, and such will not be lost when it
 204                     empties (can only be set by IRCops, requires
 205                     permchannels module).
 206  Q                  Only ulined servers and their users can kick
 207                     (requires nokicks module)
 208  R                  Blocks unregistered users from joining (requires
 209                     services account module).
 210  S                  Strips mIRC color codes from messages to the
 211                     channel (requires stripcolor module).
 212  T                  Blocks /NOTICEs to the channel from users who are
 213                     not at least halfop (requires nonotice module).
 214
 215  g <mask>           Blocks messages matching the given glob mask
 216                     (requires chanfilter module).
 217  X <mode>           Makes channel operators immune to the specified
 218                     restrictive mode (requires exemptchanops module).
 219
 220 -------------
 221 NOTE: A large number of these modes are dependent upon server-side modules
 222 being loaded by a server/network administrator. The actual modes available
 223 on your network may be very different to this list. Please consult your
 224 help channel if you have any questions.">
 225
 226 <helpop key="snomasks" value="Server Notice Masks
 227
 228  a      Allows receipt of local announcement messages.
 229  A      Allows receipt of remote announcement messages.
 230  c      Allows receipt of local connect messages.
 231  C      Allows receipt of remote connect messages.
 232  d      Allows receipt of general (and sometimes random) debug
 233         messages.
 234  f      Allows receipt of flooding notices.
 235  g      Allows receipt of globops (requires globops module).
 236  j      Allows receipt of channel creation notices (requires
 237         chancreate module).
 238  J      Allows receipt of remote channel creation notices (requires
 239         chancreate module).
 240  k      Allows receipt of local kill messages.
 241  K      Allows receipt of remote kill messages.
 242  l      Allows receipt of local linking related
 243         messages.
 244  L      Allows receipt of remote linking related
 245         messages.
 246  n      See local nickname changes (requires seenicks module).
 247  N      See remote nickname changes (requires seenicks modules).
 248  o      Allows receipt of oper-up, oper-down, and oper-failure
 249         messages.
 250  O      Allows receipt of remote oper-up, oper-down, and oper-failure
 251         messages.
 252  q      Allows receipt of local quit messages.
 253  Q      Allows receipt of remote quit messages.
 254  t      Allows receipt of attempts to use /STATS (local and remote).
 255  v      Allows receipt of oper-override notices (requires override module).
 256  x      Allows receipt of local Xline notices (g/Z/q/k/e/R/shuns).
 257  X      Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns).">
 258
 259 <helpop key="extbans" value="Extended Bans
 260 ----------
 261
 262 Extbans are split into two types; matching extbans, which match on
 263 users in additional ways, and acting extbans, which restrict users
 264 in different ways to a standard ban.
 265
 266 To use an extban, simply set +b <ban> or +e <ban> with it as the ban,
 267 instead of a normal nick!user@host mask, to ban or exempt matching
 268 users. Ban exceptions on acting extbans exempt that user from matching
 269 an extban of that type, and from any channel mode corresponding to the
 270 restriction. Matching extbans may also be used for invite exceptions by
 271 setting +I <extban>.
 272
 273 Matching extbans:
 274
 275  j:<channel>   Matches anyone in the given channel. Does not support
 276                wildcards (requires channelban module).
 277  r:<realname>  Matches users with a matching realname (requires gecosban
 278                module).
 279  s:<server>    Matches users on a matching server (requires serverban
 280                module).
 281  z:<certfp>    Matches users having the given SSL certificate
 282                fingerprint (requires sslmodes module).
 283  O:<opertype>  Matches IRCops of a matching type, mostly useful as an
 284                an invite exception (requires operchans module).
 285  R:<account>   Matches users logged into a matching account (requires
 286                services account module).
 287
 288 Acting extbans:
 289
 290  c:<banmask>   Blocks any messages that contain color codes from
 291                matching users (requires blockcolor module).
 292  m:<banmask>   Blocks messages from matching users (requires muteban
 293                module). Users with +v or above are not affected.
 294  p:<banmask>   Blocks part messages from matching users (requires
 295                nopartmsg module).
 296  A:<banmask>   Blocks invites by matching users even when +A is set
 297                (requires allowinvite module).
 298  B:<banmask>   Blocks all capital or nearly all capital messages from
 299                matching users (requires blockcaps module).
 300  C:<banmask>   Blocks CTCPs from matching users (requires noctcp
 301                module).
 302  M:<account>   Blocks messages from users logged into a matching
 303                account (requires services account module).
 304  N:<banmask>   Blocks nick changes from matching users (requires
 305                nonicks module).
 306  Q:<banmask>   Blocks kicks by matching users (requires nokicks
 307                module).
 308  S:<banmask>   Strips color/bold/underline from messages from matching
 309                users (requires stripcolor module).
 310  T:<banmask>   Blocks notices from matching users (requires nonotice
 311                module).
 312  U:<banmask>   Blocks unregistered users matching the given banmask.
 313                (requires services account).
 314
 315 A ban given to an Acting extban may either be a nick!user@host mask
 316 (unless stated otherwise, for example M: taking an account name),
 317 matched against users as for a normal ban, or a Matching extban.
 318
 319 There is an additional special type of extended ban, a redirect ban:
 320
 321  Redirect      n!u@h#channel will redirect the banned user to #channel
 322                when they try to join (requires banredirect module).">