docs/conf/modules/unrealircd.conf.example

   1 <module name="m_md5.so">
   2 <module name="m_sha256.so">
   3 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
   4 # Alias module: Allows you to define server-side command aliases.
   5 <module name="m_alias.so">
   6 <fantasy prefix="!" allowbots="no">
   7 # Aliases
   8 <alias text="NICKSERV" replace="PRIVMSG NickServ :$2-" requires="NickServ" uline="yes">
   9 <alias text="CHANSERV" replace="PRIVMSG ChanServ :$2-" requires="ChanServ" uline="yes">
  10 <alias text="OPERSERV" replace="PRIVMSG OperServ :$2-" requires="OperServ" uline="yes" operonly="yes">
  11 <alias text="BOTSERV" replace="PRIVMSG BotServ :$2-" requires="BotServ" uline="yes">
  12 <alias text="HOSTSERV" replace="PRIVMSG HostServ :$2-" requires="HostServ" uline="yes">
  13 <alias text="MEMOSERV" replace="PRIVMSG MemoServ :$2-" requires="MemoServ" uline="yes">
  14 <alias text="NS" replace="PRIVMSG NickServ :$2-" requires="NickServ" uline="yes">
  15 <alias text="CS" replace="PRIVMSG ChanServ :$2-" requires="ChanServ" uline="yes">
  16 <alias text="OS" replace="PRIVMSG OperServ :$2-" requires="OperServ" uline="yes" operonly="yes">
  17 <alias text="BS" replace="PRIVMSG BotServ :$2-" requires="BotServ" uline="yes">
  18 <alias text="HS" replace="PRIVMSG HostServ :$2-" requires="HostServ" uline="yes">
  19 <alias text="MS" replace="PRIVMSG MemoServ :$2-" requires="MemoServ" uline="yes">
  20 #
  21 # An example of using the format value to create an alias with two
  22 # different behaviours depending on the format of the parameters.
  23 #
  24 #<alias text="ID" format="#*" replace="PRIVMSG ChanServ :IDENTIFY $2 $3"
  25 #  requires="ChanServ" uline="yes">
  26 #
  27 #<alias text="ID" replace="PRIVMSG NickServ :IDENTIFY $2"
  28 #  requires="NickServ" uline="yes">
  29 #
  30 # This alias fixes a glitch in xchat 2.6.x and above and the way it
  31 # assumes IDENTIFY must be prefixed by a colon (:) character. It should
  32 # be placed ABOVE the default NICKSERV alias (the first example) listed
  33 # above.
  34 #
  35 #<alias text="NICKSERV" format=":IDENTIFY *" replace="PRIVMSG NickServ :IDENTIFY $3-"
  36 #  requires="NickServ" uline="yes">
  37
  38 <module name="m_allowinvite.so">
  39 <module name="m_alltime.so">
  40 <module name="m_auditorium.so">
  41 <auditorium showops="yes" operoverride="yes">
  42 <module name="m_banexception.so">
  43 <module name="m_blockcaps.so">
  44 <blockcaps percent="50"
  45            minlen="5"
  46            capsmap="ABCDEFGHIJKLMNOPQRSTUVWXYZ! ">
  47 <module name="m_blockcolor.so">
  48 <module name="m_botmode.so">
  49 <module name="m_censor.so">
  50 <include file="inspircd.censor.example">
  51
  52 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
  53 # CGI:IRC module: Adds support for automatic host changing in CGI:IRC
  54 # (http://cgiirc.sourceforge.net).
  55 #<module name="m_cgiirc.so">
  56 #
  57 #-#-#-#-#-#-#-#-#-#-#-# CGIIRC  CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-#
  58 #
  59 # Optional - If you specify to use m_cgiirc, then you must specify one
  60 # or more cgihost tags which indicate authorised CGI:IRC servers which
  61 # will be connecting to your network, and an optional cgiirc tag.
  62 # For more information see: http://wiki.inspircd.org/Modules/cgiirc
  63 #
  64 # Set to yes if you want to notice opers when CGI clients connect
  65 # <cgiirc opernotice="no">
  66 #
  67 # The type field indicates where the module should get the real
  68 # client's IP address from, for further information, please see the
  69 # CGI:IRC documentation.
  70 #
  71 # Old style:
  72 # <cgihost type="pass" mask="www.mysite.com">       # Get IP from PASS
  73 # <cgihost type="ident" mask="otherbox.mysite.com"> # Get IP from ident
  74 # <cgihost type="passfirst" mask="www.mysite.com">  # See the docs
  75 # New style:
  76 # <cgihost type="webirc" password="foobar"
  77 #   mask="somebox.mysite.com">                      # Get IP from WEBIRC
  78 #
  79 # IMPORTANT NOTE:
  80 # ---------------
  81 #
  82 # When you connect CGI:IRC clients, there are two connect classes which
  83 # apply to these clients. When the client initially connects, the connect
  84 # class which matches the cgi:irc site's host is checked. Therefore you
  85 # must raise the maximum local/global clients for this ip as high as you
  86 # want to allow cgi clients. After the client has connected and is
  87 # determined to be a cgi:irc client, the class which matches the client's
  88 # real IP is then checked. You may set this class to a lower value, so that
  89 # the real IP of the client can still be restricted to, for example, 3
  90 # sessions maximum.
  91 #
  92
  93 <module name="m_chanfilter.so">
  94 <chanfilter hidemask="yes">
  95
  96 <module name="m_chanprotect.so">
  97
  98 <chanprotect
  99         noservices="no"
 100         qprefix="~"
 101         aprefix="&amp;"
 102         deprotectself="yes"
 103         deprotectothers="yes">
 104
 105 <module name="m_check.so">
 106 <module name="m_chghost.so">
 107 <hostname charmap="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-_/0123456789">
 108
 109 <module name="m_chgident.so">
 110 <module name="m_chgname.so">
 111 <module name="m_cloaking.so">
 112 <cloak mode="half"
 113        key="secret"
 114        prefix="net-">
 115
 116 <module name="m_close.so">
 117 <module name="m_clones.so">
 118 <module name="m_commonchans.so">
 119
 120 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 121 # Auto join on connect module: Allows you to force users to join one
 122 # or more channels automatically upon connecting to the server.
 123 #<module name="m_conn_join.so">
 124 #
 125 #-#-#-#-#-#-#-#-#-#-#-#- CONNJOIN CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#
 126 #
 127 # If you have m_conn_join.so loaded, you can configure it using the
 128 # follow values:
 129 #
 130 #<autojoin channel="#one,#two,#three">
 131
 132 <module name="m_conn_umodes.so">
 133 <module name="m_cycle.so">
 134
 135 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 136 # Connection throttle module.
 137 #<module name="m_connflood.so">
 138 #
 139 #-#-#-#-#-#-#-#-#-#-#- CONTHROTTLE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
 140 #  seconds, maxconns -  Amount of connections per <seconds>.
 141 #
 142 #  timeout           -  Time to wait after the throttle was activated
 143 #                       before deactivating it. Be aware that the time
 144 #                       is seconds + timeout.
 145 #
 146 #  quitmsg           -  The message that users get if they attempt to
 147 #                       connect while the throttle is active.
 148 #
 149 #  bootwait          -  Amount of time to wait before enforcing the
 150 #                       throttling when the server just booted.
 151 #
 152 #<connflood seconds="30" maxconns="3" timeout="30"
 153 #   quitmsg="Throttled" bootwait="10">
 154
 155 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 156 # DCCALLOW module: Adds the /DCCALLOW command.
 157 <module name="m_dccallow.so">
 158 #
 159 #-#-#-#-#-#-#-#-#-#-#-  DCCALLOW CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 160 #  blockchat         - Whether to block DCC CHAT as well as DCC SEND
 161 #  length            - Default duration of entries in DCCALLOW list
 162 #  action            - Default action to take if no action is specified
 163 #                      can be 'block' or 'allow'
 164 #
 165 # File configuration:
 166 #  pattern           - The glob pattern to match against
 167 #  action            - Action to take if a user attempts to send a file
 168 #                      that matches this pattern, can be 'block' or 'allow'
 169 #
 170 #<dccallow blockchat="yes" length="5m" action="block">
 171 #<banfile pattern="*.exe" action="block">
 172 #<banfile pattern="*.txt" action="allow">
 173 #
 174 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 175
 176 <module name="m_deaf.so">
 177 <module name="m_denychans.so">
 178 #<badchan name="#gods*" allowopers="yes" reason="Tortoises!">         #
 179 #<badchan name="#heaven" redirect="#hell" reason="Nice try!">         #
 180
 181 <module name="m_devoice.so">
 182
 183 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 184 # Filter module: Provides message filtering, similar to SPAMFILTER.
 185 <module name="m_filter.so">
 186 #                                                                     #
 187 # This module depends upon a regex provider such as m_regex_pcre or   #
 188 # m_regex_glob to function. You must specify which of these you want  #
 189 # m_filter to use via the tag below.                                  #
 190 #                                                                     #
 191 # Valid engines are:                                                  #
 192 #                                                                     #
 193 # glob   - Glob patterns, provided via m_regex_glob.                  #
 194 # pcre   - PCRE regexps, provided via m_regex_pcre, needs libpcre.    #
 195 # tre    - TRE regexps, provided via m_regex_tre, requires libtre.    #
 196 # posix  - POSIX regexps, provided via m_regex_posix, not available   #
 197 #          on Windows, no dependencies on other operating systems.    #
 198 # stdlib - stdlib regexps, provided via m_regex_stdlib, see comment   #
 199 #          at the <module> tag for info on availability.              #
 200 #                                                                     #
 201 <filteropts engine="glob">
 202 #                                                                     #
 203 # Your choice of regex engine must match on all servers network-wide.
 204 #
 205 # You may specify specific channels that are exempt from being filtered:
 206 #<exemptfromfilter channel="#blah">
 207 #
 208 #-#-#-#-#-#-#-#-#-#-#-  FILTER  CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#-#
 209 #                                                                     #
 210 # Optional - If you specify to use the m_filter module, then          #
 211 # specfiy below the path to the filter.conf file, or define some      #
 212 # <filter> tags.                                                      #
 213 #                                                                     #
 214 #<include file="filter.conf">
 215
 216 <module name="m_gecosban.so">
 217 <module name="m_globops.so">
 218 <module name="m_globalload.so">
 219 <module name="m_halfop.so">
 220 <module name="m_helpop.so">
 221 <include file="inspircd.helpop-full.example">
 222
 223 <module name="m_hidechans.so">
 224 <hidechans affectsopers="false">
 225
 226 <module name="m_hideoper.so">
 227 <module name="m_ident.so">
 228 <ident timeout="1">
 229 <module name="m_inviteexception.so">
 230 <module name="m_joinflood.so">
 231 <module name="m_jumpserver.so">
 232 <module name="m_knock.so">
 233 <module name="m_messageflood.so">
 234 <module name="m_namesx.so">
 235 <module name="m_nickflood.so">
 236 <module name="m_noctcp.so">
 237 <module name="m_nokicks.so">
 238 <module name="m_nonicks.so">
 239 <module name="m_nopartmsg.so">
 240 <module name="m_nonotice.so">
 241 <module name="m_operchans.so">
 242
 243 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 244 # Oper join module: Auto-joins opers to a channel upon oper-up.
 245 # This module is oper-only. For the user equivalent, see m_conn_join.
 246 <module name="m_operjoin.so">
 247 #
 248 #-#-#-#-#-#-#-#-#-#-#   OPERJOIN CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 249 #                                                                     #
 250 # If you are using the m_operjoin.so module, specify options here:    #
 251 #                                                                     #
 252 # channel     -      The channel name to join, can also be a comma    #
 253 #                    separated list eg. "#channel1,#channel2".        #
 254 #                                                                     #
 255 # override    -      Lets the oper join walking thru any modes that   #
 256 #                    might be set, even bans. Use "yes" or "no".      #
 257 #                                                                     #
 258 #<operjoin channel="#channel" override="no">
 259 #
 260 # Alternatively you can use the autojoin="channellist" in a <type>    #
 261 # tag to set specific autojoins for a type of oper, for example:      #
 262 #
 263 #<type name="Helper" autojoin="#help" classes="...">
 264
 265 <module name="m_operlog.so">
 266
 267 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 268 # Oper MOTD module: Provides support for separate message of the day
 269 # on oper-up.
 270 # This module is oper-only.
 271 #<module name="m_opermotd.so">
 272 #
 273 #-#-#-#-#-#-#-#-#-#-#   OPERMOTD CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 274 #                                                                     #
 275 # If you are using the m_opermotd.so module, specify the motd here    #
 276 #                                                                     #
 277 # onoper        - If on, the message is sent on /OPER, otherwise it's #
 278 #                 only sent when /OPERMOTD is used.                   #
 279 #                                                                     #
 280 #<opermotd file="oper.motd" onoper="yes">
 281
 282 <module name="m_override.so">
 283 #-#-#-#-#-#-#-#-#-#-#   OVERRIDE CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 284 #                                                                     #
 285 # m_override.so is too complex to describe here, see the wiki:        #
 286 # http://wiki.inspircd.org/Modules/override                           #
 287
 288 <module name="m_operlevels.so">
 289 <module name="m_opermodes.so">
 290 <module name="m_password_hash.so">
 291 <module name="m_muteban.so">
 292
 293 <module name="m_redirect.so">
 294 <module name="m_regex_glob.so">
 295
 296 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 297 # Regular expression provider for PCRE (Perl-Compatible Regular
 298 # Expressions). You need libpcre installed to compile and load this
 299 # module. You must have at least 1 provider loaded to use m_filter or
 300 # m_rline.
 301 #<module name="m_regex_pcre.so">
 302
 303 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 304 # Regular expression provider for POSIX Regular Expressions.
 305 # You shouldn't need any additional libraries on a POSIX-compatible
 306 # system (ie: any Linux, BSD, but not Windows). You must have at least
 307 # 1 provider loaded to use m_filter or m_rline.
 308 # On POSIX-compliant systems, regex syntax can be found by using the
 309 # command: 'man 7 regex'.
 310 #<module name="m_regex_posix.so">
 311
 312 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 313 # Regular expression provider for TRE Regular Expressions.
 314 # This is the same regular expression engine used by UnrealIRCd, so
 315 # if you are most familiar with the syntax of /spamfilter from there,
 316 # this is the provider you want. You need libtre installed in order
 317 # to compile and load this module.
 318 #<module name="m_regex_tre.so">
 319
 320 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 321 # Registered users only channel creation module. If enabled, only
 322 # registered users and opers can create new channels.
 323 #
 324 # You probably *DO NOT* want to load this module on a public network.
 325 #
 326 #<module name="m_regonlycreate.so">
 327
 328 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 329 # Restricted channels module: Allows only opers to create channels.
 330 #
 331 # You probably *DO NOT* want to load this module on a public network.
 332 #
 333 #<module name="m_restrictchans.so">
 334
 335 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 336 # Restrict message module: Allows users to only message opers.
 337 #
 338 # You probably *DO NOT* want to load this module on a public network.
 339 #
 340 #<module name="m_restrictmsg.so">
 341
 342 <module name="m_sajoin.so">
 343 <module name="m_sakick.so">
 344 <module name="m_samode.so">
 345 <module name="m_sanick.so">
 346 <module name="m_sapart.so">
 347 <module name="m_saquit.so">
 348 <module name="m_satopic.so">
 349 <module name="m_servprotect.so">
 350 <module name="m_seenicks.so">
 351 <module name="m_setidle.so">
 352 <module name="m_services_account.so">
 353 <module name="m_sethost.so">
 354 <module name="m_setident.so">
 355 <module name="m_setname.so">
 356 <module name="m_showwhois.so">
 357 <showwhois opersonly="yes" showfromopers="yes">
 358
 359 <module name="m_shun.so">
 360 <shun enabledcommands="PING PONG QUIT PART JOIN" notifyuser="no" affectopers="no">
 361
 362 <module name="m_sslmodes.so">
 363
 364 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 365 # GnuTLS SSL module: Adds support for SSL connections using GnuTLS,
 366 # if enabled. You must answer 'yes' in ./configure when asked or symlink
 367 # the source for this module from the directory src/modules/extra, if
 368 # you want to enable this, or it will not load.
 369 #<module name="m_ssl_gnutls.so">
 370 #
 371 #-#-#-#-#-#-#-#-#-#-#-  GNUTLS CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-#
 372 #                                                                     #
 373 # m_ssl_gnutls.so is too complex to describe here, see the wiki:      #
 374 # http://wiki.inspircd.org/Modules/ssl_gnutls                         #
 375
 376 <module name="m_sslinfo.so">
 377
 378 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 379 # OpenSSL SSL module: Adds support for SSL connections using OpenSSL,
 380 # if enabled. You must answer 'yes' in ./configure when asked or symlink
 381 # the source for this module from the directory src/modules/extra, if
 382 # you want to enable this, or it will not load.
 383 #<module name="m_ssl_openssl.so">
 384 #
 385 #-#-#-#-#-#-#-#-#-#-#- OPENSSL CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-#
 386 #                                                                     #
 387 # m_ssl_openssl.so is too complex to describe here, see the wiki:     #
 388 # http://wiki.inspircd.org/Modules/ssl_openssl                        #
 389
 390 <module name="m_stripcolor.so">
 391 <module name="m_svshold.so">
 392 <module name="m_swhois.so">
 393 <module name="m_tline.so">
 394 <module name="m_uhnames.so">
 395 <module name="m_userip.so">
 396 <module name="m_watch.so">
 397 <watch maxentries="32">
 398
 399 <module name="m_spanningtree.so">