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
  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
  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> (this mode can
 118                     be disabled).
 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 chanprotect module).
 123  q <nickname>       Gives owner status to <nickname>, preventing them
 124                     from being kicked (Services or only, requires
 125                     chanprotect 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  F <changes>:<sec>  Blocks nick changes when they equal or exceed the
 183                     specified rate (requires nickflood module).
 184  G                  Censors messages to the channel based on the
 185                     network configuration (requires censor module).
 186  J <seconds>        Prevents rejoin after kick for the specified
 187                     number of seconds. This prevents auto-rejoin
 188                     (requires kicknorejoin module).
 189  K                  Blocks /KNOCK on the channel.
 190  L <channel>        If the channel reaches its limit set by +l,
 191                     redirect users to <channel> (requires redirect
 192                     module).
 193  M                  Blocks unregistered users from speaking (requires
 194                     services account module).
 195  N                  Prevents users on the channel from chainging nick
 196                     (requires nonicks module).
 197  O                  Channel is IRCops only (can only be set by IRCops,
 198                     requires operchans module).
 199  P                  Makes the channel permanent; Bans, invites, the
 200                     topic, modes, and such will not be lost when it
 201                     empties (can only be set by IRCops, requires
 202                     permchannels module).
 203  Q                  Only ulined servers and their users can kick
 204                     (requires nokicks module)
 205  R                  Blocks unregistered users from joining (requires
 206                     services account module).
 207  S                  Strips mIRC color codes from messages to the
 208                     channel (requires stripcolor module).
 209  T                  Blocks /NOTICEs to the channel from users who are
 210                     not at least halfop (requires nonotice module).
 211
 212  g <mask>           Blocks messages matching the given glob mask
 213                     (requires chanfilter module).
 214  X <mode>           Makes channel operators immune to the specified
 215                     restrictive mode (requires exemptchanops module).
 216
 217 -------------
 218 NOTE: A large number of these modes are dependent upon server-side modules
 219 being loaded by a server/network administrator. The actual modes available
 220 on your network may be very different to this list. Please consult your
 221 help channel if you have any questions.">
 222
 223 <helpop key="snomasks" value="Server Notice Masks
 224
 225  a      Allows receipt of local announcement messages.
 226  A      Allows receipt of remote announcement messages.
 227  c      Allows receipt of local connect messages.
 228  C      Allows receipt of remote connect messages.
 229  d      Allows receipt of general (and sometimes random) debug
 230         messages.
 231  f      Allows receipt of flooding notices.
 232  g      Allows receipt of globops (requires globops module).
 233  j      Allows receipt of channel creation notices (requires
 234         chancreate module).
 235  J      Allows receipt of remote channel creation notices (requires
 236         chancreate module).
 237  k      Allows receipt of local kill messages.
 238  K      Allows receipt of remote kill messages.
 239  l      Allows receipt of local linking related
 240         messages.
 241  L      Allows receipt of remote linking related
 242         messages.
 243  n      See local nickname changes (requires seenicks module).
 244  N      See remote nickname changes (requires seenicks modules).
 245  o      Allows receipt of oper-up, oper-down, and oper-failure
 246         messages.
 247  O      Allows receipt of remote oper-up, oper-down, and oper-failure
 248         messages.
 249  q      Allows receipt of local quit messages.
 250  Q      Allows receipt of remote quit messages.
 251  t      Allows receipt of attempts to use /STATS (local and remote).
 252  v      Allows receipt of oper-override notices (requires override module).
 253  x      Allows receipt of local Xline notices (g/Z/q/k/e/R/shuns).
 254  X      Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns).">
 255
 256 <helpop key="extbans" value="Extended Bans
 257 ----------
 258
 259 Extbans are split into two types; matching extbans, which match on
 260 users in additional ways, and acting extbans, which restrict users
 261 in different ways to a standard ban.
 262
 263 To use an extban, simply set +b <ban> or +e <ban> with it as the ban,
 264 instead of a normal nick!user@host mask, to ban or exempt matching
 265 users. Ban exceptions on acting extbans exempt that user from matching
 266 an extban of that type, and from any channel mode corresponding to the
 267 restriction. Matching extbans may also be used for invite exceptions by
 268 setting +I <extban>.
 269
 270 Matching extbans:
 271
 272  j:<channel>   Matches anyone in the given channel. Does not support
 273                wildcards (requires channelban module).
 274  r:<realname>  Matches users with a matching realname (requires gecosban
 275                module).
 276  s:<server>    Matches users on a matching server (requires serverban
 277                module).
 278  z:<certfp>    Matches users having the given SSL certificate
 279                fingerprint (requires sslmodes module).
 280  O:<opertype>  Matches IRCops of a matching type, mostly useful as an
 281                an invite exception (requires operchans module).
 282  R:<account>   Matches users logged into a matching account (requires
 283                services account module).
 284
 285 Acting extbans:
 286
 287  c:<banmask>   Blocks any messages that contain color codes from
 288                matching users (requires blockcolor module).
 289  m:<banmask>   Blocks messages from matching users (requires muteban
 290                module). Users with +v or above are not affected.
 291  p:<banmask>   Blocks part messages from matching users (requires
 292                nopartmsg module).
 293  A:<banmask>   Blocks invites by matching users even when +A is set
 294                (requires allowinvite module).
 295  B:<banmask>   Blocks all capital or nearly all capital messages from
 296                matching users (requires blockcaps module).
 297  C:<banmask>   Blocks CTCPs from matching users (requires noctcp
 298                module).
 299  M:<account>   Blocks messages from users logged into a matching
 300                account (requires services account module).
 301  N:<banmask>   Blocks nick changes from matching users (requires
 302                nonicks module).
 303  Q:<banmask>   Blocks kicks by matching users (requires nokicks
 304                module).
 305  S:<banmask>   Strips color/bold/underline from messages from matching
 306                users (requires stripcolor module).
 307  T:<banmask>   Blocks notices from matching users (requires nonotice
 308                module).
 309  U:<banmask>   Blocks unregistered users matching the given banmask.
 310                (requires services account).
 311
 312 A ban given to an Acting extban may either be a nick!user@host mask
 313 (unless stated otherwise, for example M: taking an account name),
 314 matched against users as for a normal ban, or a Matching extban.
 315
 316 There is an additional special type of extended ban, a redirect ban:
 317
 318  Redirect      n!u@h#channel will redirect the banned user to #channel
 319                when they try to join (requires banredirect module).">