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      RULES
  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     MODENOTICE
  54 CLOAK
  55
  56 SETHOST   SETIDENT  CHGHOST     CHGIDENT CHGNAME
  57 SETIDLE   SWHOIS
  58
  59 SANICK    NICKLOCK  NICKUNLOCK
  60
  61 SAJOIN    SAPART    SAMODE      SATOPIC  SAKICK
  62
  63 KILL      SAQUIT    GLINE       ZLINE    QLINE
  64 KLINE     RLINE     ELINE       CBAN     SHUN
  65 FILTER
  66
  67 CONNECT   SQUIT     RCONNECT    RSQUIT
  68
  69 DIE            RESTART      REHASH
  70 CLEARCACHE     LOADMODULE   UNLOADMODULE
  71 RELOADMODULE   GLOADMODULE  GUNLOADMODULE
  72 GRELOADMODULE  CLOSE        JUMPSERVER
  73 LOCKSERV       UNLOCKSERV">
  74
  75 <helpop key="umodes" value="User Modes
  76 ----------
  77
  78  c            Blocks private messages and notices from users who do
  79               not share a common channel with you (requires
  80               commonchans module).
  81  d            Deaf mode. User will not receive any messages or notices
  82               from channels they are in (requires deaf module).
  83  g            In combination with /ACCEPT, provides for server side
  84               ignore (requires callerid module).
  85  h            Marks as 'available for help' in WHOIS (IRCop only,
  86               requires helpop module).
  87  i            Makes invisible to /WHO if the user using /WHO is not in
  88               a common channel.
  89  k            Prevents the user from being kicked from channels, or
  90               having op modes removed from them (services only,
  91               requires servprotect module).
  92  o            Marks as a IRC operator.
  93  s <mask>     Receives server notices specified by <mask>
  94               (IRCop only).
  95  r            Marks as a having a registered nickname
  96               (requires services account module).
  97  w            Receives wallops messages.
  98  x            Gives a cloaked hostname (requires cloaking module).
  99  B            Marks as a bot (requires botmode module).
 100  G            Censors messages sent to the user based on filters
 101               configured for the network (requires censor module).
 102  H            Hides an oper's oper status from WHOIS (requires
 103               hideoper module).
 104  I            Hides a user's entire channel list in WHOIS from
 105               non-IRCops (requires hidechans module).
 106  L            Stops redirections done by m_redirect (mode must be
 107               enabled in the config).
 108  R            Blocks private messages from unregistered users
 109               (requires services account module).
 110  S            Strips mIRC color/bold/underline codes out of private
 111               messages to the user (requires stripcolor module).
 112  W            Receives notification when a user uses WHOIS on them
 113               (IRCop only, requires showwhois module).">
 114
 115 <helpop key="chmodes" value="Channel Modes
 116 -------------
 117
 118  v <nickname>       Gives voice to <nickname>, allowing them to speak
 119                     while the channel is +m.
 120  h <nickname>       Gives halfop status to <nickname> (this mode can
 121                     be disabled).
 122  o <nickname>       Gives op status to <nickname>.
 123  a <nickname>       Gives protected status to <nickname>, preventing
 124                     them from them from being kicked (+q only,
 125                     requires chanprotect module).
 126  q <nickname>       Gives owner status to <nickname>, preventing them
 127                     from being kicked (Services or only, requires
 128                     chanprotect module).
 129
 130  b <hostmask>       Bans <hostmask> from the channel.
 131  e <hostmask>       Excepts <hostmask> from bans (requires
 132                     banexception module).
 133  I <hostmask>       Excepts <hostmask> from +i, allowing matching
 134                     users to join while the channel is invite-only
 135                     (requires inviteexception module).
 136
 137  c                  Blocks messages containing mIRC color codes
 138                     (requires blockcolor module).
 139  d <time>           Blocks messages to a channel from new users
 140                     until they have been in the channel for <time>
 141                     seconds (requires delaymsg module).
 142  f [*]<lines>:<sec> Kicks on text flood equal to or above the
 143                     specified rate. With *, the user is banned
 144                     (requires messageflood module).
 145  i                  Makes the channel invite-only.
 146                     Users can only join if an operator
 147                     uses /INVITE to invite them.
 148  j <joins>:<sec>    Limits joins to the specified rate (requires
 149                     joinflood module).
 150  k <key>            Set the channel key (password) to <key>.
 151  l <limit>          Set the maximum allowed users to <limit>.
 152  m                  Enable moderation. Only users with +v, +h, or +o
 153                     can speak.
 154  n                  Blocks users who are not members of the channel
 155                     from messaging it.
 156  p                  Make channel private, hiding it in users' whoises
 157                     and replacing it with * in /LIST.
 158  r                  Marks the channel as registered with Services
 159                     (requires services account module).
 160  s                  Make channel secret, hiding it in users' whoises
 161                     and /LIST.
 162  t                  Prevents users without +h or +o from changing the
 163                     topic.
 164  u                  Makes the channel an auditorium; normal users only
 165                     see themselves or themselves and the operators,
 166                     while operators see all the users (requires
 167                     auditorium module).
 168  w <flag>:<banmask> Adds basic channel access controls of <flag> to
 169                     <banmask>, via the +w listmode.
 170                     For example, +w o:R:Brain will op anyone identified
 171                     to the account 'Brain' on join.
 172                     (requires autoop module)
 173  z                  Blocks non-SSL clients from joining the channel.
 174
 175  A                  Allows anyone to invite users to the channel
 176                     (normally only chanops can invite, requires
 177                     allowinvite module).
 178  B                  Blocks messages with too many capital letters,
 179                     as determined by the network configuration
 180                     (requires blockcaps module).
 181  C                  Blocks any CTCPs to the channel (requires noctcp
 182                     module).
 183  D                  Delays join messages from users until they
 184                     message the channel (requires delayjoin module).
 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  H <num>:<duration> Displays the last <num> lines of chat to joining
 190                     users. <duration> is the maximum time to keep
 191                     lines in the history buffer (requires chanhistory
 192                     module).
 193  J <seconds>        Prevents rejoin after kick for the specified
 194                     number of seconds. This prevents auto-rejoin
 195                     (requires kicknorejoin module).
 196  K                  Blocks /KNOCK on the channel.
 197  L <channel>        If the channel reaches its limit set by +l,
 198                     redirect users to <channel> (requires redirect
 199                     module).
 200  M                  Blocks unregistered users from speaking (requires
 201                     services account module).
 202  N                  Prevents users on the channel from changing nick
 203                     (requires nonicks module).
 204  O                  Channel is IRCops only (can only be set by IRCops,
 205                     requires operchans module).
 206  P                  Makes the channel permanent; Bans, invites, the
 207                     topic, modes, and such will not be lost when it
 208                     empties (can only be set by IRCops, requires
 209                     permchannels module).
 210  Q                  Only ulined servers and their users can kick
 211                     (requires nokicks module)
 212  R                  Blocks unregistered users from joining (requires
 213                     services account module).
 214  S                  Strips mIRC color codes from messages to the
 215                     channel (requires stripcolor module).
 216  T                  Blocks /NOTICEs to the channel from users who are
 217                     not at least halfop (requires nonotice module).
 218
 219  g <mask>           Blocks messages matching the given glob mask
 220                     (requires chanfilter module).
 221  X <mode>           Makes channel operators immune to the specified
 222                     restrictive mode (requires exemptchanops module).
 223
 224 -------------
 225 NOTE: A large number of these modes are dependent upon server-side modules
 226 being loaded by a server/network administrator. The actual modes available
 227 on your network may be very different to this list. Please consult your
 228 help channel if you have any questions.">
 229
 230 <helpop key="snomasks" value="Server Notice Masks
 231
 232  a      Allows receipt of local announcement messages.
 233  A      Allows receipt of remote announcement messages.
 234  c      Allows receipt of local connect messages.
 235  C      Allows receipt of remote connect messages.
 236  d      Allows receipt of general (and sometimes random) debug
 237         messages.
 238  f      Allows receipt of flooding notices.
 239  g      Allows receipt of globops (requires globops module).
 240  j      Allows receipt of channel creation notices (requires
 241         chancreate module).
 242  J      Allows receipt of remote channel creation notices (requires
 243         chancreate module).
 244  k      Allows receipt of local kill messages.
 245  K      Allows receipt of remote kill messages.
 246  l      Allows receipt of local linking related
 247         messages.
 248  L      Allows receipt of remote linking related
 249         messages.
 250  n      See local nickname changes (requires seenicks module).
 251  N      See remote nickname changes (requires seenicks modules).
 252  o      Allows receipt of oper-up, oper-down, and oper-failure
 253         messages.
 254  O      Allows receipt of remote oper-up, oper-down, and oper-failure
 255         messages.
 256  q      Allows receipt of local quit messages.
 257  Q      Allows receipt of remote quit messages.
 258  t      Allows receipt of attempts to use /STATS (local and remote).
 259  v      Allows receipt of oper-override notices (requires override module).
 260  x      Allows receipt of local Xline notices (g/Z/q/k/e/R/shuns).
 261  X      Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns).">
 262
 263 <helpop key="extbans" value="Extended Bans
 264 ----------
 265
 266 Extbans are split into two types; matching extbans, which match on
 267 users in additional ways, and acting extbans, which restrict users
 268 in different ways to a standard ban.
 269
 270 To use an extban, simply set +b <ban> or +e <ban> with it as the ban,
 271 instead of a normal nick!user@host mask, to ban or exempt matching
 272 users. Ban exceptions on acting extbans exempt that user from matching
 273 an extban of that type, and from any channel mode corresponding to the
 274 restriction. Matching extbans may also be used for invite exceptions by
 275 setting +I <extban>.
 276
 277 Matching extbans:
 278
 279  j:<channel>   Matches anyone in the given channel. Does not support
 280                wildcards (requires channelban module).
 281  r:<realname>  Matches users with a matching realname (requires gecosban
 282                module).
 283  s:<server>    Matches users on a matching server (requires serverban
 284                module).
 285  z:<certfp>    Matches users having the given SSL certificate
 286                fingerprint (requires sslmodes module).
 287  O:<opertype>  Matches IRCops of a matching type, mostly useful as an
 288                an invite exception (requires operchans module).
 289  R:<account>   Matches users logged into a matching account (requires
 290                services account module).
 291
 292 Acting extbans:
 293
 294  c:<banmask>   Blocks any messages that contain color codes from
 295                matching users (requires blockcolor module).
 296  m:<banmask>   Blocks messages from matching users (requires muteban
 297                module). Users with +v or above are not affected.
 298  p:<banmask>   Blocks part messages from matching users (requires
 299                nopartmsg module).
 300  A:<banmask>   Blocks invites by matching users even when +A is set
 301                (requires allowinvite module).
 302  B:<banmask>   Blocks all capital or nearly all capital messages from
 303                matching users (requires blockcaps module).
 304  C:<banmask>   Blocks CTCPs from matching users (requires noctcp
 305                module).
 306  N:<banmask>   Blocks nick changes from matching users (requires
 307                nonicks module).
 308  Q:<banmask>   Blocks kicks by matching users (requires nokicks
 309                module).
 310  S:<banmask>   Strips color/bold/underline from messages from matching
 311                users (requires stripcolor module).
 312  T:<banmask>   Blocks notices from matching users (requires nonotice
 313                module).
 314  U:<banmask>   Blocks unregistered users matching the given banmask.
 315                (requires services account).
 316
 317 A ban given to an Acting extban may either be a nick!user@host mask
 318 (unless stated otherwise), matched against users as for a normal ban,
 319 or a Matching extban.
 320
 321 There is an additional special type of extended ban, a redirect ban:
 322
 323  Redirect      n!u@h#channel will redirect the banned user to #channel
 324                when they try to join (requires banredirect module).">