docs/conf/modules/unrealircd.conf.example

   1 <module name="md5">
   2 <module name="sha256">
   3 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
   4 # Alias module: Allows you to define server-side command aliases.
   5 <module name="alias">
   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="allowinvite">
  39 <module name="alltime">
  40 <module name="auditorium">
  41 <auditorium showops="yes" operoverride="yes">
  42 <module name="banexception">
  43 <module name="blockcaps">
  44 <blockcaps percent="50"
  45            minlen="5"
  46            capsmap="ABCDEFGHIJKLMNOPQRSTUVWXYZ! ">
  47 <module name="blockcolor">
  48 <module name="botmode">
  49 <module name="censor">
  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="cgiirc">
  56 #
  57 #-#-#-#-#-#-#-#-#-#-#-# CGIIRC  CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-#
  58 #
  59 # Optional - If you specify to use 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="chanfilter">
  94 <chanfilter hidemask="yes">
  95
  96 <module name="check">
  97 <module name="chghost">
  98 <hostname charmap="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-_/0123456789">
  99
 100 <module name="chgident">
 101 <module name="chgname">
 102 <module name="cloaking">
 103 <cloak mode="half"
 104        key="secret"
 105        prefix="net-">
 106
 107 <module name="close">
 108 <module name="clones">
 109 <module name="commonchans">
 110
 111 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 112 # Auto join on connect module: Allows you to force users to join one
 113 # or more channels automatically upon connecting to the server.
 114 #<module name="conn_join">
 115 #
 116 #-#-#-#-#-#-#-#-#-#-#-#- CONNJOIN CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#
 117 #
 118 # If you have the conn_join module loaded, you can configure it below:
 119 #
 120 #<autojoin channel="#one,#two,#three">
 121
 122 <module name="conn_umodes">
 123 <module name="cycle">
 124
 125 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 126 # Connection throttle module.
 127 #<module name="connflood">
 128 #
 129 #-#-#-#-#-#-#-#-#-#-#- CONTHROTTLE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
 130 #  seconds, maxconns -  Amount of connections per <seconds>.
 131 #
 132 #  timeout           -  Time to wait after the throttle was activated
 133 #                       before deactivating it. Be aware that the time
 134 #                       is seconds + timeout.
 135 #
 136 #  quitmsg           -  The message that users get if they attempt to
 137 #                       connect while the throttle is active.
 138 #
 139 #  bootwait          -  Amount of time to wait before enforcing the
 140 #                       throttling when the server just booted.
 141 #
 142 #<connflood seconds="30" maxconns="3" timeout="30"
 143 #   quitmsg="Throttled" bootwait="10">
 144
 145 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 146 # DCCALLOW module: Adds the /DCCALLOW command.
 147 <module name="dccallow">
 148 #
 149 #-#-#-#-#-#-#-#-#-#-#-  DCCALLOW CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 150 #  blockchat         - Whether to block DCC CHAT as well as DCC SEND
 151 #  length            - Default duration of entries in DCCALLOW list
 152 #  action            - Default action to take if no action is specified
 153 #                      can be 'block' or 'allow'
 154 #
 155 # File configuration:
 156 #  pattern           - The glob pattern to match against
 157 #  action            - Action to take if a user attempts to send a file
 158 #                      that matches this pattern, can be 'block' or 'allow'
 159 #
 160 #<dccallow blockchat="yes" length="5m" action="block">
 161 #<banfile pattern="*.exe" action="block">
 162 #<banfile pattern="*.txt" action="allow">
 163 #
 164 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 165
 166 <module name="deaf">
 167 <module name="denychans">
 168 #<badchan name="#gods*" allowopers="yes" reason="Tortoises!">         #
 169 #<badchan name="#heaven" redirect="#hell" reason="Nice try!">         #
 170
 171 <module name="devoice">
 172
 173 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 174 # Filter module: Provides message filtering, similar to SPAMFILTER.
 175 <module name="filter">
 176 #                                                                     #
 177 # This module depends upon a regex provider such as regex_pcre or     #
 178 # regex_glob to function. You must specify which of these you want    #
 179 # the filter module to use via the tag below.                         #
 180 #                                                                     #
 181 # Valid engines are:                                                  #
 182 #                                                                     #
 183 # glob   - Glob patterns, provided via regex_glob.                    #
 184 # pcre   - PCRE regexps, provided via regex_pcre, needs libpcre.      #
 185 # tre    - TRE regexps, provided via regex_tre, requires libtre.      #
 186 # posix  - POSIX regexps, provided via regex_posix, not available     #
 187 #          on Windows, no dependencies on other operating systems.    #
 188 # stdlib - stdlib regexps, provided via regex_stdlib, see comment     #
 189 #          at the <module> tag for info on availability.              #
 190 #                                                                     #
 191 <filteropts engine="glob">
 192 #                                                                     #
 193 # Your choice of regex engine must match on all servers network-wide.
 194 #
 195 # To learn more about the configuration of this module, read          #
 196 # examples/filter.conf.example, which covers the various types of     #
 197 # filters and shows how to add exemptions.                            #
 198 #
 199 #-#-#-#-#-#-#-#-#-#-#-  FILTER  CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#-#
 200 #                                                                     #
 201 # Optional - If you specify to use the filter module, then            #
 202 # specfiy below the path to the filter.conf file, or define some      #
 203 # <filter> tags.                                                      #
 204 #                                                                     #
 205 #<include file="filter.conf">
 206
 207 <module name="gecosban">
 208 <module name="globops">
 209 <module name="globalload">
 210 <module name="halfop">
 211 <module name="helpop">
 212 <include file="inspircd.helpop-full.example">
 213
 214 <module name="hidechans">
 215 <hidechans affectsopers="false">
 216
 217 <module name="hideoper">
 218 <module name="ident">
 219 <ident timeout="1">
 220 <module name="inviteexception">
 221 <module name="joinflood">
 222 <module name="jumpserver">
 223 <module name="knock">
 224 <module name="messageflood">
 225 <module name="namesx">
 226 <module name="nickflood">
 227 <module name="noctcp">
 228 <module name="nokicks">
 229 <module name="nonicks">
 230 <module name="nopartmsg">
 231 <module name="nonotice">
 232 <module name="operchans">
 233
 234 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 235 # Oper join module: Auto-joins opers to a channel upon oper-up.
 236 # This module is oper-only. For the user equivalent, see the conn_join
 237 # module.
 238 <module name="operjoin">
 239 #
 240 #-#-#-#-#-#-#-#-#-#-#   OPERJOIN CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 241 #                                                                     #
 242 # If you are using the operjoin module, specify options here:         #
 243 #                                                                     #
 244 # channel     -      The channel name to join, can also be a comma    #
 245 #                    separated list eg. "#channel1,#channel2".        #
 246 #                                                                     #
 247 # override    -      Lets the oper join walking thru any modes that   #
 248 #                    might be set, even bans. Use "yes" or "no".      #
 249 #                                                                     #
 250 #<operjoin channel="#channel" override="no">
 251 #
 252 # Alternatively you can use the autojoin="channellist" in a <type>    #
 253 # tag to set specific autojoins for a type of oper, for example:      #
 254 #
 255 #<type name="Helper" autojoin="#help" classes="...">
 256
 257 <module name="operlog">
 258
 259 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 260 # Oper MOTD module: Provides support for separate message of the day
 261 # on oper-up.
 262 # This module is oper-only.
 263 #<module name="opermotd">
 264 #
 265 #-#-#-#-#-#-#-#-#-#-#   OPERMOTD CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 266 #                                                                     #
 267 # If you are using the opermotd module, specify the motd here         #
 268 #                                                                     #
 269 # onoper        - If on, the message is sent on /OPER, otherwise it's #
 270 #                 only sent when /OPERMOTD is used.                   #
 271 #                                                                     #
 272 #<opermotd file="oper.motd" onoper="yes">
 273
 274 <module name="override">
 275 #-#-#-#-#-#-#-#-#-#-#   OVERRIDE CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#
 276 #                                                                     #
 277 # The override module is too complex to describe here, see the wiki:  #
 278 # http://wiki.inspircd.org/Modules/override                           #
 279
 280 <module name="operlevels">
 281 <module name="opermodes">
 282 <module name="password_hash">
 283 <module name="muteban">
 284
 285 <module name="redirect">
 286 <module name="regex_glob">
 287
 288 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 289 # Regular expression provider for PCRE (Perl-Compatible Regular
 290 # Expressions). You need libpcre installed to compile and load this
 291 # module. You must have at least 1 provider loaded to use the filter
 292 # or the rline module.
 293 #<module name="regex_pcre">
 294
 295 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 296 # Regular expression provider for POSIX Regular Expressions.
 297 # You shouldn't need any additional libraries on a POSIX-compatible
 298 # system (ie: any Linux, BSD, but not Windows). You must have at least
 299 # 1 provider loaded to use the filter or rline module.
 300 # On POSIX-compliant systems, regex syntax can be found by using the
 301 # command: 'man 7 regex'.
 302 #<module name="regex_posix">
 303
 304 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 305 # Regular expression provider for TRE Regular Expressions.
 306 # This is the same regular expression engine used by UnrealIRCd, so
 307 # if you are most familiar with the syntax of /spamfilter from there,
 308 # this is the provider you want. You need libtre installed in order
 309 # to compile and load this module.
 310 #<module name="regex_tre">
 311
 312 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 313 # Registered users only channel creation module. If enabled, only
 314 # registered users and opers can create new channels.
 315 #
 316 # You probably *DO NOT* want to load this module on a public network.
 317 #
 318 #<module name="regonlycreate">
 319
 320 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 321 # Restricted channels module: Allows only opers to create channels.
 322 #
 323 # You probably *DO NOT* want to load this module on a public network.
 324 #
 325 #<module name="restrictchans">
 326
 327 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 328 # Restrict message module: Allows users to only message opers.
 329 #
 330 # You probably *DO NOT* want to load this module on a public network.
 331 #
 332 #<module name="restrictmsg">
 333
 334 <module name="sajoin">
 335 <module name="sakick">
 336 <module name="samode">
 337 <module name="sanick">
 338 <module name="sapart">
 339 <module name="saquit">
 340 <module name="satopic">
 341 <module name="servprotect">
 342 <module name="seenicks">
 343 <module name="setidle">
 344 <module name="services_account">
 345 <module name="sethost">
 346 <module name="setident">
 347 <module name="setname">
 348 <module name="showwhois">
 349 <showwhois opersonly="yes" showfromopers="yes">
 350
 351 <module name="shun">
 352 <shun enabledcommands="PING PONG QUIT PART JOIN" notifyuser="no" affectopers="no">
 353
 354 <module name="sslmodes">
 355
 356 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 357 # GnuTLS SSL module: Adds support for SSL connections using GnuTLS,
 358 # if enabled. You must answer 'yes' in ./configure when asked or symlink
 359 # the source for this module from the directory src/modules/extra, if
 360 # you want to enable this, or it will not load.
 361 #<module name="ssl_gnutls">
 362 #
 363 #-#-#-#-#-#-#-#-#-#-#-  GNUTLS CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-#
 364 #                                                                     #
 365 # ssl_gnutls is too complex to describe here, see the wiki:           #
 366 # http://wiki.inspircd.org/Modules/ssl_gnutls                         #
 367
 368 <module name="sslinfo">
 369
 370 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 371 # OpenSSL SSL module: Adds support for SSL connections using OpenSSL,
 372 # if enabled. You must answer 'yes' in ./configure when asked or symlink
 373 # the source for this module from the directory src/modules/extra, if
 374 # you want to enable this, or it will not load.
 375 #<module name="ssl_openssl">
 376 #
 377 #-#-#-#-#-#-#-#-#-#-#- OPENSSL CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-#
 378 #                                                                     #
 379 # ssl_openssl is too complex to describe here, see the wiki:          #
 380 # http://wiki.inspircd.org/Modules/ssl_openssl                        #
 381
 382 <module name="stripcolor">
 383 <module name="svshold">
 384 <module name="swhois">
 385 <module name="tline">
 386 <module name="uhnames">
 387 <module name="userip">
 388 <module name="watch">
 389 <watch maxentries="32">
 390
 391 <module name="spanningtree">