1 # DO NOT EDIT - This file is being maintained by Chef
4 # Determines the bot's default nick.
6 # Default value: supybot
11 # Determines what alternative nicks will be used if the primary nick
12 # (supybot.nick) isn't available. A %s in this nick is replaced by the
13 # value of supybot.nick when used. If no alternates are given, or if all
14 # are used, the supybot.nick will be perturbed appropriately until an
15 # unused nick is found.
17 # Default value: %s` %s_
19 supybot.nick.alternates: %s` %s_
22 # Determines the bot's ident string, if the server doesn't provide one
25 # Default value: supybot
27 supybot.ident: supybot
30 # Determines the user the bot sends to the server. A standard user using
31 # the current version of the bot will be generated if this is left
39 # Determines what networks the bot will connect to.
43 supybot.networks: oftc
46 # Determines what password will be used on oftc. Yes, we know that
47 # technically passwords are server-specific and not network-specific,
48 # but this is the best we can do right now.
52 supybot.networks.oftc.password:
55 # Determines what servers the bot will connect to for oftc. Each will be
56 # tried in order, wrapping back to the first when the cycle is
61 supybot.networks.oftc.servers: irc.oftc.net:6667
64 # Determines what channels the bot will join only on oftc.
68 supybot.networks.oftc.channels: #osm-dev
71 # Determines what key (if any) will be used to join the channel.
75 supybot.networks.oftc.channels.key:
78 # Determines whether the bot will attempt to connect with SSL sockets to
81 # Default value: False
83 supybot.networks.oftc.ssl: False
86 # Determines how timestamps printed for human reading should be
87 # formatted. Refer to the Python documentation for the time module to
88 # see valid formatting characters for time formats.
90 # Default value: %I:%M %p, %B %d, %Y
92 supybot.reply.format.time: %I:%M %p, %B %d, %Y
95 # Determines whether elapsed times will be given as "1 day, 2 hours, 3
96 # minutes, and 15 seconds" or as "1d 2h 3m 15s".
98 # Default value: False
100 supybot.reply.format.time.elapsed.short: False
103 # Determines the absolute maximum length of the bot's reply -- no reply
104 # will be passed through the bot with a length greater than this.
106 # Default value: 131072
108 supybot.reply.maximumLength: 131072
111 # Determines whether the bot will break up long messages into chunks and
112 # allow users to use the 'more' command to get the remaining chunks.
114 # Default value: True
116 supybot.reply.mores: True
119 # Determines what the maximum number of chunks (for use with the 'more'
124 supybot.reply.mores.maximum: 50
127 # Determines how long individual chunks will be. If set to 0, uses our
128 # super-tweaked, get-the-most-out-of-an-individual-message default.
132 supybot.reply.mores.length: 0
135 # Determines how many mores will be sent instantly (i.e., without the
136 # use of the more command, immediately when they are formed). Defaults
137 # to 1, which means that a more command will be required for all but the
142 supybot.reply.mores.instant: 1
145 # Determines whether the bot will send multi-message replies in a single
146 # message or in multiple messages. For safety purposes (so the bot is
147 # less likely to flood) it will normally send everything in a single
148 # message, using mores if necessary.
150 # Default value: True
152 supybot.reply.oneToOne: True
155 # Determines whether the bot will reply with an error message when it is
156 # addressed but not given a valid command. If this value is False, the
157 # bot will remain silent, as long as no other plugins override the
160 # Default value: True
162 supybot.reply.whenNotCommand: True
165 # Determines whether error messages that result from bugs in the bot
166 # will show a detailed error message (the uncaught exception) or a
167 # generic error message.
169 # Default value: False
171 supybot.reply.error.detailed: False
174 # Determines whether the bot will send error messages to users in
175 # private. You might want to do this in order to keep channel traffic to
176 # minimum. This can be used in combination with
177 # supybot.reply.error.withNotice.
179 # Default value: False
181 supybot.reply.error.inPrivate: False
184 # Determines whether the bot will send error messages to users via
185 # NOTICE instead of PRIVMSG. You might want to do this so users can
186 # ignore NOTICEs from the bot and not have to see error messages; or you
187 # might want to use it in combination with supybot.reply.errorInPrivate
188 # so private errors don't open a query window in most IRC clients.
190 # Default value: False
192 supybot.reply.error.withNotice: False
195 # Determines whether the bot will send an error message to users who
196 # attempt to call a command for which they do not have the necessary
197 # capability. You may wish to make this True if you don't want users to
198 # understand the underlying security system preventing them from running
201 # Default value: False
203 supybot.reply.error.noCapability: False
206 # Determines whether the bot will reply privately when replying in a
207 # channel, rather than replying to the whole channel.
209 # Default value: False
211 supybot.reply.inPrivate: False
214 # Determines whether the bot will reply with a notice when replying in a
215 # channel, rather than replying with a privmsg as normal.
217 # Default value: False
219 supybot.reply.withNotice: False
222 # Determines whether the bot will reply with a notice when it is sending
223 # a private message, in order not to open a /query window in clients.
224 # This can be overridden by individual users via the user configuration
225 # variable reply.withNoticeWhenPrivate.
227 # Default value: False
229 supybot.reply.withNoticeWhenPrivate: False
232 # Determines whether the bot will always prefix the user's nick to its
233 # reply to that user's command.
235 # Default value: True
237 supybot.reply.withNickPrefix: True
240 # Determines whether the bot should attempt to reply to all messages
241 # even if they don't address it (either via its nick or a prefix
242 # character). If you set this to True, you almost certainly want to set
243 # supybot.reply.whenNotCommand to False.
245 # Default value: False
247 supybot.reply.whenNotAddressed: False
250 # Determines whether the bot will allow you to send channel-related
251 # commands outside of that channel. Sometimes people find it confusing
252 # if a channel-related command (like Filter.outfilter) changes the
253 # behavior of the channel but was sent outside the channel itself.
255 # Default value: False
257 supybot.reply.requireChannelCommandsToBeSentInChannel: False
260 # Supybot normally replies with the full help whenever a user misuses a
261 # command. If this value is set to True, the bot will only reply with
262 # the syntax of the command (the first line of the help) rather than the
265 # Default value: False
267 supybot.reply.showSimpleSyntax: False
270 # Determines what prefix characters the bot will reply to. A prefix
271 # character is a single character that the bot will use to determine
272 # what messages are addressed to it; when there are no prefix characters
273 # set, it just uses its nick. Each character in this string is
274 # interpreted individually; you can have multiple prefix chars
275 # simultaneously, and if any one of them is used as a prefix the bot
276 # will assume it is being addressed.
280 supybot.reply.whenAddressedBy.chars: !
283 # Determines what strings the bot will reply to when they are at the
284 # beginning of the message. Whereas prefix.chars can only be one
285 # character (although there can be many of them), this variable is a
286 # space-separated list of strings, so you can set something like '@@ ??'
287 # and the bot will reply when a message is prefixed by either @@ or ??.
291 supybot.reply.whenAddressedBy.strings:
294 # Determines whether the bot will reply when people address it by its
295 # nick, rather than with a prefix character.
297 # Default value: True
299 supybot.reply.whenAddressedBy.nick: True
302 # Determines whether the bot will reply when people address it by its
303 # nick at the end of the message, rather than at the beginning.
305 # Default value: False
307 supybot.reply.whenAddressedBy.nick.atEnd: False
310 # Determines what extra nicks the bot will always respond to when
311 # addressed by, even if its current nick is something else.
315 supybot.reply.whenAddressedBy.nicks:
318 # Determines whether the bot will unidentify someone when that person
319 # changes his or her nick. Setting this to True will cause the bot to
320 # track such changes. It defaults to False for a little greater
323 # Default value: False
325 supybot.followIdentificationThroughNickChanges: False
328 # Determines whether the bot will always join a channel when it's
329 # invited. If this value is False, the bot will only join a channel if
330 # the user inviting it has the 'admin' capability (or if it's explicitly
331 # told to join the channel using the Admin.join command)
333 # Default value: False
335 supybot.alwaysJoinOnInvite: False
338 # Determines what message the bot replies with when a command succeeded.
339 # If this configuration variable is empty, no success message will be
342 supybot.replies.success: The operation succeeded.
345 # Determines what error message the bot gives when it wants to be
348 supybot.replies.error: An error has occurred and has been logged. Please\
349 contact this bot's administrator for more\
353 # Determines what message the bot replies with when someone tries to use
354 # a command that requires being identified or having a password and
355 # neither credential is correct.
357 supybot.replies.incorrectAuthentication: Your hostmask doesn't match or your\
361 # Determines what error message the bot replies with when someone tries
362 # to accessing some information on a user the bot doesn't know about.
364 supybot.replies.noUser: I can't find %s in my user database. If you didn't\
365 give a user name, then I might not know what your\
366 user is, and you'll need to identify before this\
370 # Determines what error message the bot replies with when someone tries
371 # to do something that requires them to be registered but they're not
372 # currently recognized.
374 supybot.replies.notRegistered: You must be registered to use this command.\
375 If you are already registered, you must\
376 either identify (using the identify command)\
377 or add a hostmask matching your current\
378 hostmask (using the "hostmask add" command).
381 # Determines what error message is given when the bot is telling someone
382 # they aren't cool enough to use the command they tried to use.
384 supybot.replies.noCapability: You don't have the %s capability. If you think\
385 that you should have this capability, be sure\
386 that you are identified before trying again.\
387 The 'whoami' command can tell you if you're\
391 # Determines what generic error message is given when the bot is telling
392 # someone that they aren't cool enough to use the command they tried to
393 # use, and the author of the code calling errorNoCapability didn't
394 # provide an explicit capability for whatever reason.
396 supybot.replies.genericNoCapability: You're missing some capability you\
397 need. This could be because you\
398 actually possess the anti-capability\
399 for the capability that's required of\
400 you, or because the channel provides\
401 that anti-capability by default, or\
402 because the global capabilities include\
403 that anti-capability. Or, it could be\
404 because the channel or\
405 supybot.capabilities.default is set to\
406 False, meaning that no commands are\
407 allowed unless explicitly in your\
408 capabilities. Either way, you can't do\
412 # Determines what error messages the bot sends to people who try to do
413 # things in a channel that really should be done in private.
415 supybot.replies.requiresPrivacy: That operation cannot be done in a channel.
418 # Determines what message the bot sends when it thinks you've
419 # encountered a bug that the developers don't know about.
421 supybot.replies.possibleBug: This may be a bug. If you think it is, please\
422 file a bug report at <http://sourceforge.net/tr\
423 acker/?func=add&group_id=58965&atid=489447>.
426 # A floating point number of seconds to throttle snarfed URLs, in order
427 # to prevent loops between two bots snarfing the same URLs and having
428 # the snarfed URL in the output of the snarf message.
430 # Default value: 10.0
432 supybot.snarfThrottle: 10.0
435 # Determines the number of seconds between running the upkeep function
436 # that flushes (commits) open databases, collects garbage, and records
437 # some useful statistics at the debugging level.
439 # Default value: 3600
441 supybot.upkeepInterval: 3600
444 # Determines whether the bot will periodically flush data and
445 # configuration files to disk. Generally, the only time you'll want to
446 # set this to False is when you want to modify those configuration files
447 # by hand and don't want the bot to flush its current version over your
448 # modifications. Do note that if you change this to False inside the
449 # bot, your changes won't be flushed. To make this change permanent, you
450 # must edit the registry yourself.
452 # Default value: True
457 # Determines what characters are valid for quoting arguments to commands
458 # in order to prevent them from being tokenized.
462 supybot.commands.quotes: "
465 # Determines whether the bot will allow nested commands, which rule. You
466 # definitely should keep this on.
468 # Default value: True
470 supybot.commands.nested: True
473 # Determines what the maximum number of nested commands will be; users
474 # will receive an error if they attempt commands more nested than this.
478 supybot.commands.nested.maximum: 10
481 # Supybot allows you to specify what brackets are used for your nested
482 # commands. Valid sets of brackets include [], <>, and {} (). [] has
483 # strong historical motivation, as well as being the brackets that don't
484 # require shift. <> or () might be slightly superior because they cannot
485 # occur in a nick. If this string is empty, nested commands will not be
486 # allowed in this channel.
490 supybot.commands.nested.brackets: []
493 # Supybot allows nested commands. Enabling this option will allow nested
494 # commands with a syntax similar to UNIX pipes, for example: 'bot: foo |
497 # Default value: False
499 supybot.commands.nested.pipeSyntax: False
502 # Determines what commands have default plugins set, and which plugins
503 # are set to be the default for each of those commands.
505 supybot.commands.defaultPlugins.addcapability: Admin
506 supybot.commands.defaultPlugins.capabilities: User
507 supybot.commands.defaultPlugins.disable: Owner
508 supybot.commands.defaultPlugins.enable: Owner
509 supybot.commands.defaultPlugins.help: Misc
510 supybot.commands.defaultPlugins.ignore: Admin
513 # Determines what plugins automatically get precedence over all other
514 # plugins when selecting a default plugin for a command. By default,
515 # this includes the standard loaded plugins. You probably shouldn't
516 # change this if you don't know what you're doing; if you do know what
517 # you're doing, then also know that this set is case-sensitive.
519 # Default value: Plugin Admin Misc User Owner Config Channel
521 supybot.commands.defaultPlugins.importantPlugins: Plugin Admin Misc User Owner Config Channel
522 supybot.commands.defaultPlugins.list: Misc
523 supybot.commands.defaultPlugins.reload: Owner
524 supybot.commands.defaultPlugins.removecapability: Admin
525 supybot.commands.defaultPlugins.unignore: Admin
528 # Determines what commands are currently disabled. Such commands will
529 # not appear in command lists, etc. They will appear not even to exist.
533 supybot.commands.disabled:
536 # Determines whether the bot will defend itself against command-
539 # Default value: True
541 supybot.abuse.flood.command: True
544 # Determines how many commands users are allowed per minute. If a user
545 # sends more than this many commands in any 60 second period, he or she
546 # will be ignored for supybot.abuse.flood.command.punishment seconds.
550 supybot.abuse.flood.command.maximum: 12
553 # Determines how many seconds the bot will ignore users who flood it
558 supybot.abuse.flood.command.punishment: 300
561 # Determines whether the bot will defend itself against invalid command-
564 # Default value: True
566 supybot.abuse.flood.command.invalid: True
569 # Determines how many invalid commands users are allowed per minute. If
570 # a user sends more than this many invalid commands in any 60 second
571 # period, he or she will be ignored for
572 # supybot.abuse.flood.command.invalid.punishment seconds. Typically,
573 # this value is lower than supybot.abuse.flood.command.maximum, since
574 # it's far less likely (and far more annoying) for users to flood with
575 # invalid commands than for them to flood with valid commands.
579 supybot.abuse.flood.command.invalid.maximum: 5
582 # Determines how many seconds the bot will ignore users who flood it
583 # with invalid commands. Typically, this value is higher than
584 # supybot.abuse.flood.command.punishment, since it's far less likely
585 # (and far more annoying) for users to flood witih invalid commands than
586 # for them to flood with valid commands.
590 supybot.abuse.flood.command.invalid.punishment: 600
593 # Determines the default length of time a driver should block waiting
598 supybot.drivers.poll: 1.0
601 # Determines what driver module the bot will use. Socket, a simple
602 # driver based on timeout sockets, is used by default because it's
603 # simple and stable. Twisted is very stable and simple, and if you've
604 # got Twisted installed, is probably your best bet.
606 # Default value: default
608 supybot.drivers.module: default
611 # Determines the maximum time the bot will wait before attempting to
612 # reconnect to an IRC server. The bot may, of course, reconnect earlier
615 # Default value: 300.0
617 supybot.drivers.maxReconnectWait: 300.0
620 # Determines what directory configuration data is put into.
622 # Default value: conf
624 supybot.directories.conf: /etc/supybot
627 # Determines what directory data is put into.
629 # Default value: data
631 supybot.directories.data: /var/lib/supybot/data
634 # Determines what directory temporary files are put into.
638 supybot.directories.data.tmp: /var/lib/supybot/data/tmp
641 # Determines what directory files of the web server (templates, custom images, ...) are put into.
645 supybot.directories.data.web: /var/lib/supybot/data/web
648 # Determines what directory backup data is put into.
650 # Default value: backup
652 supybot.directories.backup: /var/lib/supybot/backup
655 # Determines what directories the bot will look for plugins in. Accepts
656 # a comma-separated list of strings. This means that to add another
657 # directory, you can nest the former value and add a new one. E.g. you
658 # can say: bot: 'config supybot.directories.plugins [config
659 # supybot.directories.plugins], newPluginDirectory'.
663 supybot.directories.plugins: /usr/local/lib/supybot/plugins
666 # Determines what directory the bot will store its logfiles in.
668 # Default value: logs
670 supybot.directories.log: /var/log/supybot
673 # Determines what plugins will be loaded.
677 supybot.plugins: Git Admin Misc Owner User Services Config Channel
680 # Determines whether this plugin is loaded by default.
682 supybot.plugins.Admin: True
685 # Determines whether this plugin is publicly visible.
687 # Default value: True
689 supybot.plugins.Admin.public: True
692 # Determines whether this plugin is loaded by default.
694 supybot.plugins.Channel: True
697 # Determines whether this plugin is publicly visible.
699 # Default value: True
701 supybot.plugins.Channel.public: True
704 # Determines whether the bot will always try to rejoin a channel
705 # whenever it's kicked from the channel.
707 # Default value: True
709 supybot.plugins.Channel.alwaysRejoin: True
712 # Determines whether this plugin is loaded by default.
714 supybot.plugins.Config: True
717 # Determines whether this plugin is publicly visible.
719 # Default value: True
721 supybot.plugins.Config.public: True
724 # Determines whether this plugin is loaded by default.
726 supybot.plugins.Git: True
729 # Determines whether this plugin is publicly visible.
731 # Default value: True
733 supybot.plugins.Git.public: True
736 # The path to the repository configuration file.
738 # Default value: git.ini
740 supybot.plugins.Git.configFile: /etc/supybot/git.conf
743 # The path where local copies of repositories will be kept.
745 # Default value: git_repositories
747 supybot.plugins.Git.repoDir: /var/lib/supybot/git
750 # The frequency (in seconds) repositories will be polled for changes.
751 # Set to zero to disable polling.
755 supybot.plugins.Git.pollPeriod: 120
758 # How many commits are displayed at once from each repository.
762 supybot.plugins.Git.maxCommitsAtOnce: 10
765 # Look for SHAs in user messages written to the channel, and reply with
766 # the commit description if one is found.
768 # Default value: True
770 supybot.plugins.Git.shaSnarfing: True
773 # Determines whether this plugin is loaded by default.
775 supybot.plugins.Misc: True
778 # Determines whether this plugin is publicly visible.
780 # Default value: True
782 supybot.plugins.Misc.public: True
785 # Determines whether the bot will list private plugins with the list
786 # command if given the --private switch. If this is disabled, non-owner
787 # users should be unable to see what private plugins are loaded.
789 # Default value: True
791 supybot.plugins.Misc.listPrivatePlugins: True
794 # Determines the format string for timestamps in the Misc.last command.
795 # Refer to the Python documentation for the time module to see what
796 # formats are accepted. If you set this variable to the empty string,
797 # the timestamp will not be shown.
799 # Default value: [%H:%M:%S]
801 supybot.plugins.Misc.timestampFormat: [%H:%M:%S]
804 # Determines whether or not the timestamp will be included in the output
805 # of last when it is part of a nested command
807 # Default value: False
809 supybot.plugins.Misc.last.nested.includeTimestamp: False
812 # Determines whether or not the nick will be included in the output of
813 # last when it is part of a nested command
815 # Default value: False
817 supybot.plugins.Misc.last.nested.includeNick: False
820 # Determines whether this plugin is loaded by default.
822 supybot.plugins.Owner: True
825 # Determines whether this plugin is publicly visible.
827 # Default value: True
829 supybot.plugins.Owner.public: True
832 # Determines what quit message will be used by default. If the quit
833 # command is called without a quit message, this will be used. If this
834 # value is empty, the nick of the person giving the quit command will be
839 supybot.plugins.Owner.quitMsg:
842 # Determines whether this plugin is loaded by default.
844 supybot.plugins.Services: True
847 # Determines whether this plugin is publicly visible.
849 # Default value: True
851 supybot.plugins.Services.public: True
854 # Determines what nicks the bot will use with services.
858 supybot.plugins.Services.nicks: osmbot
861 # Determines what networks this plugin will be disabled on.
863 # Default value: QuakeNet
865 supybot.plugins.Services.disabledNetworks: QuakeNet
868 # Determines whether the bot will not join any channels until it is
869 # identified. This may be useful, for instances, if you have a vhost
870 # that isn't set until you're identified, or if you're joining +r
871 # channels that won't allow you to join unless you identify.
873 # Default value: False
875 supybot.plugins.Services.noJoinsUntilIdentified: False
878 # Determines how many seconds the bot will wait between successive GHOST
883 supybot.plugins.Services.ghostDelay: 60
886 # Determines what nick the 'NickServ' service has.
890 supybot.plugins.Services.NickServ: NickServ
893 # Determines what password the bot will use with NickServ.
897 supybot.plugins.Services.NickServ.password: <%= @passwords["nickserv"] %>
898 supybot.plugins.Services.NickServ.password.osmbot: <%= @passwords["nickserv"] %>
901 # Determines what nick the 'ChanServ' service has.
905 supybot.plugins.Services.ChanServ:
908 # Determines what password the bot will use with ChanServ.
912 supybot.plugins.Services.ChanServ.password:
915 # Determines whether the bot will request to get opped by the ChanServ
916 # when it joins the channel.
918 # Default value: False
920 supybot.plugins.Services.ChanServ.op: False
923 # Determines whether the bot will request to get half-opped by the
924 # ChanServ when it joins the channel.
926 # Default value: False
928 supybot.plugins.Services.ChanServ.halfop: False
931 # Determines whether the bot will request to get voiced by the ChanServ
932 # when it joins the channel.
934 # Default value: False
936 supybot.plugins.Services.ChanServ.voice: False
939 # Determines whether this plugin is loaded by default.
941 supybot.plugins.User: True
944 # Determines whether this plugin is publicly visible.
946 # Default value: True
948 supybot.plugins.User.public: True
951 # Determines whether the bot will always load important plugins (Admin,
952 # Channel, Config, Misc, Owner, and User) regardless of what their
953 # configured state is. Generally, if these plugins are configured not to
954 # load, you didn't do it on purpose, and you still want them to load.
955 # Users who don't want to load these plugins are smart enough to change
956 # the value of this variable appropriately :)
958 # Default value: True
960 supybot.plugins.alwaysLoadImportant: True
963 # Determines what databases are available for use. If this value is not
964 # configured (that is, if its value is empty) then sane defaults will be
967 # Default value: anydbm cdb flat pickle
972 # Determines what filename will be used for the users database. This
973 # file will go into the directory specified by the
974 # supybot.directories.conf variable.
976 # Default value: users.conf
978 supybot.databases.users.filename: users.conf
981 # Determines how long it takes identification to time out. If the value
982 # is less than or equal to zero, identification never times out.
986 supybot.databases.users.timeoutIdentification: 0
989 # Determines whether the bot will allow users to unregister their users.
990 # This can wreak havoc with already-existing databases, so by default we
991 # don't allow it. Enable this at your own risk. (Do also note that this
992 # does not prevent the owner of the bot from using the unregister
995 # Default value: False
997 supybot.databases.users.allowUnregistration: False
1000 # Determines what filename will be used for the ignores database. This
1001 # file will go into the directory specified by the
1002 # supybot.directories.conf variable.
1004 # Default value: ignores.conf
1006 supybot.databases.ignores.filename: ignores.conf
1009 # Determines what filename will be used for the channels database. This
1010 # file will go into the directory specified by the
1011 # supybot.directories.conf variable.
1013 # Default value: channels.conf
1015 supybot.databases.channels.filename: channels.conf
1018 # Determines whether database-based plugins that can be channel-specific
1019 # will be so. This can be overridden by individual channels. Do note
1020 # that the bot needs to be restarted immediately after changing this
1021 # variable or your db plugins may not work for your channel; also note
1022 # that you may wish to set
1023 # supybot.databases.plugins.channelSpecific.link appropriately if you
1024 # wish to share a certain channel's databases globally.
1026 # Default value: True
1028 supybot.databases.plugins.channelSpecific: True
1031 # Determines what channel global (non-channel-specific) databases will
1032 # be considered a part of. This is helpful if you've been running
1033 # channel-specific for awhile and want to turn the databases for your
1034 # primary channel into global databases. If
1035 # supybot.databases.plugins.channelSpecific.link.allow prevents linking,
1036 # the current channel will be used. Do note that the bot needs to be
1037 # restarted immediately after changing this variable or your db plugins
1038 # may not work for your channel.
1042 supybot.databases.plugins.channelSpecific.link: #
1045 # Determines whether another channel's global (non-channel-specific)
1046 # databases will be allowed to link to this channel's databases. Do note
1047 # that the bot needs to be restarted immediately after changing this
1048 # variable or your db plugins may not work for your channel.
1050 # Default value: True
1052 supybot.databases.plugins.channelSpecific.link.allow: True
1055 # Determines whether CDB databases will be allowed as a database
1058 # Default value: True
1060 supybot.databases.types.cdb: True
1063 # Determines how often CDB databases will have their modifications
1064 # flushed to disk. When the number of modified records is greater than
1065 # this part of the number of unmodified records, the database will be
1066 # entirely flushed to disk.
1068 # Default value: 0.5
1070 supybot.databases.types.cdb.maximumModifications: 0.5
1073 # Determines what will be used as the default banmask style.
1075 # Default value: host user
1077 supybot.protocols.irc.banmask: host user
1080 # Determines whether the bot will strictly follow the RFC; currently
1081 # this only affects what strings are considered to be nicks. If you're
1082 # using a server or a network that requires you to message a nick such
1083 # as services@this.network.server then you you should set this to False.
1085 # Default value: False
1087 supybot.protocols.irc.strictRfc: False
1090 # Determines what user modes the bot will request from the server when
1091 # it first connects. Many people might choose +i; some networks allow
1092 # +x, which indicates to the auth services on those networks that you
1093 # should be given a fake host.
1097 supybot.protocols.irc.umodes:
1100 # Determines what vhost the bot will bind to before connecting to the
1105 supybot.protocols.irc.vhost:
1108 # Determines how many old messages the bot will keep around in its
1109 # history. Changing this variable will not take effect until the bot is
1112 # Default value: 1000
1114 supybot.protocols.irc.maxHistoryLength: 1000
1117 # A floating point number of seconds to throttle queued messages -- that
1118 # is, messages will not be sent faster than once per throttleTime
1121 # Default value: 1.0
1123 supybot.protocols.irc.throttleTime: 1.0
1126 # Determines whether the bot will send PINGs to the server it's
1127 # connected to in order to keep the connection alive and discover
1128 # earlier when it breaks. Really, this option only exists for debugging
1129 # purposes: you always should make it True unless you're testing some
1130 # strange server issues.
1132 # Default value: True
1134 supybot.protocols.irc.ping: True
1137 # Determines the number of seconds between sending pings to the server,
1138 # if pings are being sent to the server.
1140 # Default value: 120
1142 supybot.protocols.irc.ping.interval: 120
1145 # Determines whether the bot will refuse duplicate messages to be queued
1146 # for delivery to the server. This is a safety mechanism put in place to
1147 # prevent plugins from sending the same message multiple times; most of
1148 # the time it doesn't matter, unless you're doing certain kinds of
1151 # Default value: False
1153 supybot.protocols.irc.queuing.duplicates: False
1156 # Determines how many seconds must elapse between JOINs sent to the
1159 # Default value: 0.0
1161 supybot.protocols.irc.queuing.rateLimit.join: 0.0
1164 # Determines how many bytes the bot will 'peek' at when looking through
1165 # a URL for a doctype or title or something similar. It'll give up after
1166 # it reads this many bytes, even if it hasn't found what it was looking
1169 # Default value: 4096
1171 supybot.protocols.http.peekSize: 4096
1174 # Determines what proxy all HTTP requests should go through. The value
1175 # should be of the form 'host:port'.
1179 supybot.protocols.http.proxy:
1182 # Determines whether the bot will ignore unregistered users by default.
1183 # Of course, that'll make it particularly hard for those users to
1184 # register or identify with the bot, but that's your problem to solve.
1186 # Default value: False
1188 supybot.defaultIgnore: False
1191 # A string that is the external IP of the bot. If this is the empty
1192 # string, the bot will attempt to find out its IP dynamically (though
1193 # sometimes that doesn't work, hence this variable).
1200 # Determines what the default timeout for socket objects will be. This
1201 # means that *all* sockets will timeout when this many seconds has gone
1202 # by (unless otherwise modified by the author of the code that uses the
1207 supybot.defaultSocketTimeout: 10
1210 # Determines what file the bot should write its PID (Process ID) to, so
1211 # you can kill it more easily. If it's left unset (as is the default)
1212 # then no PID file will be written. A restart is required for changes to
1213 # this variable to take effect.
1220 # Determines whether the bot will automatically thread all commands.
1222 # Default value: False
1224 supybot.debug.threadAllCommands: False
1227 # Determines whether the bot will automatically flush all flushers
1228 # *very* often. Useful for debugging when you don't know what's breaking
1229 # or when, but think that it might be logged.
1231 # Default value: False
1233 supybot.debug.flushVeryOften: False
1236 # Determines what the bot's logging format will be. The relevant
1237 # documentation on the available formattings is Python's documentation
1238 # on its logging module.
1240 # Default value: %(levelname)s %(asctime)s %(name)s %(message)s
1242 supybot.log.format: %(levelname)s %(asctime)s %(name)s %(message)s
1245 # Determines what the minimum priority level logged to file will be. Do
1246 # note that this value does not affect the level logged to stdout; for
1247 # that, you should set the value of supybot.log.stdout.level. Valid
1248 # values are DEBUG, INFO, WARNING, ERROR, and CRITICAL, in order of
1249 # increasing priority.
1251 # Default value: INFO
1253 supybot.log.level: INFO
1256 # Determines the format string for timestamps in logfiles. Refer to the
1257 # Python documentation for the time module to see what formats are
1258 # accepted. If you set this variable to the empty string, times will be
1259 # logged in a simple seconds-since-epoch format.
1261 # Default value: %Y-%m-%dT%H:%M:%S
1263 supybot.log.timestampFormat: %Y-%m-%dT%H:%M:%S
1266 # Determines whether the bot will log to stdout.
1268 # Default value: True
1270 supybot.log.stdout: True
1273 # Determines whether the bot's logs to stdout (if enabled) will be
1274 # colorized with ANSI color.
1276 # Default value: False
1278 supybot.log.stdout.colorized: False
1281 # Determines whether the bot will wrap its logs when they're output to
1284 # Default value: True
1286 supybot.log.stdout.wrap: True
1289 # Determines what the bot's logging format will be. The relevant
1290 # documentation on the available formattings is Python's documentation
1291 # on its logging module.
1293 # Default value: %(levelname)s %(asctime)s %(message)s
1295 supybot.log.stdout.format: %(levelname)s %(asctime)s %(message)s
1298 # Determines what the minimum priority level logged will be. Valid
1299 # values are DEBUG, INFO, WARNING, ERROR, and CRITICAL, in order of
1300 # increasing priority.
1302 # Default value: INFO
1304 supybot.log.stdout.level: INFO
1307 # Determines whether the bot will separate plugin logs into their own
1308 # individual logfiles.
1310 # Default value: False
1312 supybot.log.plugins.individualLogfiles: False
1315 # Determines what the bot's logging format will be. The relevant
1316 # documentation on the available formattings is Python's documentation
1317 # on its logging module.
1319 # Default value: %(levelname)s %(asctime)s %(message)s
1321 supybot.log.plugins.format: %(levelname)s %(asctime)s %(message)s
1324 # These are the capabilities that are given to everyone by default. If
1325 # they are normal capabilities, then the user will have to have the
1326 # appropriate anti-capability if you want to override these
1327 # capabilities; if they are anti-capabilities, then the user will have
1328 # to have the actual capability to override these capabilities. See
1329 # docs/CAPABILITIES if you don't understand why these default to what
1332 # Default value: -owner -admin -trusted
1334 supybot.capabilities: -owner -admin -trusted
1337 # Determines whether the bot by default will allow users to have a
1338 # capability. If this is disabled, a user must explicitly have the
1339 # capability for whatever command he wishes to run.
1341 # Default value: True
1343 supybot.capabilities.default: True