]> git.netwichtig.de Git - user/henk/code/inspircd.git/blob - docs/conf/helpop.conf.example
Merge insp20
[user/henk/code/inspircd.git] / 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  RELOAD       CLOSE
72 LOCKSERV       UNLOCKSERV   JUMPSERVER">
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 /allow, 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  f [*][lines]:[sec] Kicks on text flood equal to or above the
137                     specified rate. With *, the user is banned
138                     (requires messageflood module).
139  g [mask]           Blocks messages matching the given blob mask
140                     (requires chanfilter module).
141  i                  Makes the channel invite-only.
142                     Users can only join if an operator
143                     uses /INVITE to invite them.
144  j [joins]:[sec]    Limits joins to the specified rate (requires
145                     joinflood module).
146  k [key]            Set the channel key (password) to [key].
147  l [limit]          Set the maximum allowed users to [limit].
148  m                  Enable moderation. Only users with +v, +h, or +o
149                     can speak.
150  n                  Blocks users who are not members of the channel
151                     from messaging it.
152  p                  Make channel private, hiding it in user's whoises
153                     and replacing it with * in /LIST.
154  r                  Marks the channel as registered with Services
155                     (requires services account module).
156  s                  Make channel secret, hiding it in user's whoises
157                     and /LIST.
158  t                  Prevents users without +h or +o from changing the
159                     topic.
160  u                  Makes the channel an auditorium; normal users only
161                     see themselves or themselves and the operators,
162                     while operators see all the users (requires
163                     auditorium module).
164  w [flag]:[banmask] Adds basic channel access controls of [flag] to
165                     [banmask], via the +w listmode.
166                     For example, +w o:R:Brain will op anyone identified
167                     to the account 'Brain' on join.
168                     (requires autoop module)
169  z                  Blocks non-SSL clients from joining the channel.
170
171  A                  Allows anyone to invite users to the channel
172                     (normally only chanops can invite, requires
173                     allowinvite module).
174  B                  Blocks messages with too many capital letters,
175                     as determined by the network configuration
176                     (requires blockcaps module).
177  C                  Blocks any CTCPs to the channel (requires noctcp
178                     module).
179  D                  Delays join messages from users until they
180                     message the channel (requires delayjoin module).
181  E [~*][lines]:[sec]{[:difference]}{[:backlog]} Allows blocking of similiar messages.
182                     Kicks as default, blocks with ~ and bans with *
183                     The last two parameters are optional.
184  F [changes]:[sec]  Blocks nick changes when they equal or exceed the
185                     specified rate (requires nickflood module).
186  G                  Censors messages to the channel based on the
187                     network configuration (requires censor module).
188  J [seconds]        Prevents rejoin after kick for the specified
189                     number of seconds. This prevents auto-rejoin
190                     (requires kicknorejoin module).
191  K                  Blocks /KNOCK on the channel.
192  L [channel]        If the channel reaches its limit set by +l,
193                     redirect users to [channel] (requires redirect
194                     module).
195  M                  Blocks unregistered users from speaking (requires
196                     services account module).
197  N                  Prevents users on the channel from chainging nick
198                     (requires nonicks module).
199  O                  Channel is IRCops only (can only be set by IRCops,
200                     requires operchans module).
201  P                  Makes the channel permanent; Bans, invites, the
202                     topic, modes, and such will not be lost when it
203                     empties (can only be set by IRCops, requires
204                     permchannels module).
205  Q                  Only ulined servers and their users can kick
206                     (requires nokicks module)
207  R                  Blocks unregistered users from joining (requires
208                     services account module).
209  S                  Strips mIRC color codes from messages to the
210                     channel (requirs stripcolor module).
211  T                  Blocks /NOTICEs to the channel from users who are
212                     not at least halfop (requires nonotice module).
213
214 -------------
215 NOTE: A large number of these modes are dependent upon server-side modules
216 being loaded by a server/network administrator. The actual modes available
217 on your network may be very different to this list. Please consult your
218 help channel if you have any questions.">
219
220 <helpop key="snomasks" value="Server Notice Masks
221
222  a      Allows receipt of local announcement messages.
223  A      Allows receipt of remote announcement messages.
224  c      Allows receipt of local connect messages.
225  C      Allows receipt of remote connect messages.
226  d      Allows receipt of general (and sometimes random) debug
227         messages.
228  f      Allows receipt of flooding notices.
229  g      Allows receipt of globops (requires globops module).
230  j      Allows receipt of channel creation notices (requires
231         chancreate module).
232  J      Allows receipt of remote channel creation notices (requires
233         chancreate module).
234  k      Allows receipt of local kill messages.
235  K      Allows receipt of remote kill messages.
236  l      Allows receipt of local linking related
237         messages.
238  L      Allows receipt of remote linking related
239         messages.
240  n      See local nickname changes (requires seenicks module).
241  N      See remote nickname changes (requires seenicks modules).
242  o      Allows receipt of oper-up, oper-down, and oper-failure
243         messages.
244  O      Allows receipt of remote oper-up, oper-down, and oper-failure
245         messages.
246  q      Allows receipt of local quit messages.
247  Q      Allows receipt of remote quit messages.
248  t      Allows receipt of attempts to use /STATS (local and remote).
249  v      Allows receipt of oper-override notices (requires override module).
250  x      Allows receipt of local Xline notices (g/Z/q/k/e/R/shuns).
251  X      Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns).">
252
253 <helpop key="extbans" value="Extended Bans
254 ----------
255
256  c:n!u@h      Blocks any messages that contain color codes from
257               matching users (requires blockcolor module).
258  j:#channel   Prevents anyone in #channel from joining the channel
259               (requires channelban module).
260  m:n!u@h      Blocks messages from matching users (requires muteban
261               module).
262  p:n!u@h      Blocks part messages from matching users (requires
263               nopartmsg module).
264  r:realname   Prevents users with a matching realname from joining
265               the channel (requires gecosban module).
266  s:server     Prevents users on a matching server from joining the
267               channel (requires services account).
268
269  A:n!u@h      Blocks invites by matching users even when +A is set
270               (requires allowinvite module).
271  B:n!u@h      Blocks all capital or nearly all capital messages from
272               matching users (requires blockcaps module).
273  C:n!u@h      Blocks CTCPs from matching users (requires noctcp
274               module).
275  M:account    Blocks messages from users logged into a matching
276               account (requires services account module).
277  N:n!u@h      Blocks nick changes from matching users (requires
278               nonicks module).
279  O:opertype   Prevents IRCops of the specified opertype from joining
280               the channel, mostly useful as an invite exception (IRCop
281               only, requires operchans module).
282  Q:n!u@h      Blocks kicks by matching users (requires nokicks
283               module).
284  R:account    Prevents users logged into a matching account from
285               joining the channel (requires services account module).
286  S:n!u@h      Strips color/bold/underline from messages from matching
287               users (requires stripcolor module).
288  T:n!u@h      Blocks notices from matching users (requires nonotice
289               module).
290  U:n!u@h      Blocks unregistered users matching the given ban.
291               (requires m_services_account)
292  z:certfp     Blocks users having the given certificate fingerprint
293               (requires m_sslmodes)
294
295  Redirect     n!u@h#channel will redirect the banned user to #channel
296               when they try to join (requires banredirect module).
297
298 All extbans that prevent users from joining may by used for ban
299 exceptions and invite exceptions (invex), and extbans blocking
300 specific actions may be used for ban exceptions to exempt people from
301 either wider extbans or the restrictive mode matching the extban,
302 where one exists.">