Initial commit; bare-bones supybot configuration.
[zzz-dywypi.git] / dywypi.conf
1 ###
2 # Determines the bot's default nick.
3 #
4 # Default value: supybot
5 ###
6 supybot.nick: dywypi
7
8 ###
9 # Determines what alternative nicks will be used if the primary nick
10 # (supybot.nick) isn't available. A %s in this nick is replaced by the
11 # value of supybot.nick when used. If no alternates are given, or if all
12 # are used, the supybot.nick will be perturbed appropriately until an
13 # unused nick is found.
14 #
15 # Default value: %s` %s_
16 ###
17 supybot.nick.alternates: %s` %s_
18
19 ###
20 # Determines the bot's ident string, if the server doesn't provide one
21 # by default.
22 #
23 # Default value: supybot
24 ###
25 supybot.ident: supybot
26
27 ###
28 # Determines the user the bot sends to the server. A standard user using
29 # the current version of the bot will be generated if this is left
30 # empty.
31 #
32 # Default value: 
33 ###
34 supybot.user: 
35
36 ###
37 # Determines what networks the bot will connect to.
38 #
39 # Default value:  
40 ###
41 supybot.networks: veekun
42
43 ###
44 # Determines what password will be used on veekun. Yes, we know that
45 # technically passwords are server-specific and not network-specific,
46 # but this is the best we can do right now.
47 #
48 # Default value: 
49 ###
50 supybot.networks.veekun.password: 
51
52 ###
53 # Determines what servers the bot will connect to for veekun. Each will
54 # be tried in order, wrapping back to the first when the cycle is
55 # completed.
56 #
57 # Default value: 
58 ###
59 supybot.networks.veekun.servers: irc.veekun.com:6667
60
61 ###
62 # Determines what channels the bot will join only on veekun.
63 #
64 # Default value:  
65 ###
66 supybot.networks.veekun.channels: #bot
67
68 ###
69 # Determines what key (if any) will be used to join the channel.
70 #
71 # Default value: 
72 ###
73 supybot.networks.veekun.channels.key: 
74
75 ###
76 # Determines whether the bot will attempt to connect with SSL sockets to
77 # veekun.
78 #
79 # Default value: False
80 ###
81 supybot.networks.veekun.ssl: False
82
83 ###
84 # Determines how timestamps printed for human reading should be
85 # formatted. Refer to the Python documentation for the time module to
86 # see valid formatting characters for time formats.
87 #
88 # Default value: %I:%M %p, %B %d, %Y
89 ###
90 supybot.reply.format.time: %I:%M %p, %B %d, %Y
91
92 ###
93 # Determines whether elapsed times will be given as "1 day, 2 hours, 3
94 # minutes, and 15 seconds" or as "1d 2h 3m 15s".
95 #
96 # Default value: False
97 ###
98 supybot.reply.format.time.elapsed.short: False
99
100 ###
101 # Determines the absolute maximum length of the bot's reply -- no reply
102 # will be passed through the bot with a length greater than this.
103 #
104 # Default value: 131072
105 ###
106 supybot.reply.maximumLength: 131072
107
108 ###
109 # Determines whether the bot will break up long messages into chunks and
110 # allow users to use the 'more' command to get the remaining chunks.
111 #
112 # Default value: True
113 ###
114 supybot.reply.mores: True
115
116 ###
117 # Determines what the maximum number of chunks (for use with the 'more'
118 # command) will be.
119 #
120 # Default value: 50
121 ###
122 supybot.reply.mores.maximum: 50
123
124 ###
125 # Determines how long individual chunks will be. If set to 0, uses our
126 # super-tweaked, get-the-most-out-of-an-individual-message default.
127 #
128 # Default value: 0
129 ###
130 supybot.reply.mores.length: 0
131
132 ###
133 # Determines how many mores will be sent instantly (i.e., without the
134 # use of the more command, immediately when they are formed). Defaults
135 # to 1, which means that a more command will be required for all but the
136 # first chunk.
137 #
138 # Default value: 1
139 ###
140 supybot.reply.mores.instant: 1
141
142 ###
143 # Determines whether the bot will send multi-message replies in a single
144 # message or in multiple messages. For safety purposes (so the bot is
145 # less likely to flood) it will normally send everything in a single
146 # message, using mores if necessary.
147 #
148 # Default value: True
149 ###
150 supybot.reply.oneToOne: True
151
152 ###
153 # Determines whether the bot will reply with an error message when it is
154 # addressed but not given a valid command. If this value is False, the
155 # bot will remain silent, as long as no other plugins override the
156 # normal behavior.
157 #
158 # Default value: True
159 ###
160 supybot.reply.whenNotCommand: True
161
162 ###
163 # Determines whether error messages that result from bugs in the bot
164 # will show a detailed error message (the uncaught exception) or a
165 # generic error message.
166 #
167 # Default value: False
168 ###
169 supybot.reply.error.detailed: False
170
171 ###
172 # Determines whether the bot will send error messages to users in
173 # private. You might want to do this in order to keep channel traffic to
174 # minimum. This can be used in combination with
175 # supybot.reply.error.withNotice.
176 #
177 # Default value: False
178 ###
179 supybot.reply.error.inPrivate: False
180
181 ###
182 # Determines whether the bot will send error messages to users via
183 # NOTICE instead of PRIVMSG. You might want to do this so users can
184 # ignore NOTICEs from the bot and not have to see error messages; or you
185 # might want to use it in combination with supybot.reply.errorInPrivate
186 # so private errors don't open a query window in most IRC clients.
187 #
188 # Default value: False
189 ###
190 supybot.reply.error.withNotice: False
191
192 ###
193 # Determines whether the bot will send an error message to users who
194 # attempt to call a command for which they do not have the necessary
195 # capability. You may wish to make this True if you don't want users to
196 # understand the underlying security system preventing them from running
197 # certain commands.
198 #
199 # Default value: False
200 ###
201 supybot.reply.error.noCapability: False
202
203 ###
204 # Determines whether the bot will reply privately when replying in a
205 # channel, rather than replying to the whole channel.
206 #
207 # Default value: False
208 ###
209 supybot.reply.inPrivate: False
210
211 ###
212 # Determines whether the bot will reply with a notice when replying in a
213 # channel, rather than replying with a privmsg as normal.
214 #
215 # Default value: False
216 ###
217 supybot.reply.withNotice: False
218
219 ###
220 # Determines whether the bot will reply with a notice when it is sending
221 # a private message, in order not to open a /query window in clients.
222 # This can be overridden by individual users via the user configuration
223 # variable reply.withNoticeWhenPrivate.
224 #
225 # Default value: False
226 ###
227 supybot.reply.withNoticeWhenPrivate: False
228
229 ###
230 # Determines whether the bot will always prefix the user's nick to its
231 # reply to that user's command.
232 #
233 # Default value: True
234 ###
235 supybot.reply.withNickPrefix: True
236
237 ###
238 # Determines whether the bot should attempt to reply to all messages
239 # even if they don't address it (either via its nick or a prefix
240 # character). If you set this to True, you almost certainly want to set
241 # supybot.reply.whenNotCommand to False.
242 #
243 # Default value: False
244 ###
245 supybot.reply.whenNotAddressed: False
246
247 ###
248 # Determines whether the bot will allow you to send channel-related
249 # commands outside of that channel. Sometimes people find it confusing
250 # if a channel-related command (like Filter.outfilter) changes the
251 # behavior of the channel but was sent outside the channel itself.
252 #
253 # Default value: False
254 ###
255 supybot.reply.requireChannelCommandsToBeSentInChannel: False
256
257 ###
258 # Supybot normally replies with the full help whenever a user misuses a
259 # command. If this value is set to True, the bot will only reply with
260 # the syntax of the command (the first line of the help) rather than the
261 # full help.
262 #
263 # Default value: False
264 ###
265 supybot.reply.showSimpleSyntax: False
266
267 ###
268 # Determines what prefix characters the bot will reply to. A prefix
269 # character is a single character that the bot will use to determine
270 # what messages are addressed to it; when there are no prefix characters
271 # set, it just uses its nick. Each character in this string is
272 # interpreted individually; you can have multiple prefix chars
273 # simultaneously, and if any one of them is used as a prefix the bot
274 # will assume it is being addressed.
275 #
276 # Default value: 
277 ###
278 supybot.reply.whenAddressedBy.chars: 
279
280 ###
281 # Determines what strings the bot will reply to when they are at the
282 # beginning of the message. Whereas prefix.chars can only be one
283 # character (although there can be many of them), this variable is a
284 # space-separated list of strings, so you can set something like '@@ ??'
285 # and the bot will reply when a message is prefixed by either @@ or ??.
286 #
287 # Default value:  
288 ###
289 supybot.reply.whenAddressedBy.strings:  
290
291 ###
292 # Determines whether the bot will reply when people address it by its
293 # nick, rather than with a prefix character.
294 #
295 # Default value: True
296 ###
297 supybot.reply.whenAddressedBy.nick: True
298
299 ###
300 # Determines whether the bot will reply when people address it by its
301 # nick at the end of the message, rather than at the beginning.
302 #
303 # Default value: False
304 ###
305 supybot.reply.whenAddressedBy.nick.atEnd: False
306
307 ###
308 # Determines what extra nicks the bot will always respond to when
309 # addressed by, even if its current nick is something else.
310 #
311 # Default value:  
312 ###
313 supybot.reply.whenAddressedBy.nicks:  
314
315 ###
316 # Determines whether the bot will unidentify someone when that person
317 # changes his or her nick. Setting this to True will cause the bot to
318 # track such changes. It defaults to False for a little greater
319 # security.
320 #
321 # Default value: False
322 ###
323 supybot.followIdentificationThroughNickChanges: False
324
325 ###
326 # Determines whether the bot will always join a channel when it's
327 # invited. If this value is False, the bot will only join a channel if
328 # the user inviting it has the 'admin' capability (or if it's explicitly
329 # told to join the channel using the Admin.join command)
330 #
331 # Default value: False
332 ###
333 supybot.alwaysJoinOnInvite: False
334
335 ###
336 # Determines what message the bot replies with when a command succeeded.
337 # If this configuration variable is empty, no success message will be
338 # sent.
339 ###
340 supybot.replies.success: The operation succeeded.
341
342 ###
343 # Determines what error message the bot gives when it wants to be
344 # ambiguous.
345 ###
346 supybot.replies.error: An error has occurred and has been logged. Please\
347                        contact this bot's administrator for more\
348                        information.
349
350 ###
351 # Determines what message the bot replies with when someone tries to use
352 # a command that requires being identified or having a password and
353 # neither credential is correct.
354 ###
355 supybot.replies.incorrectAuthentication: Your hostmask doesn't match or your\
356                                          password is wrong.
357
358 ###
359 # Determines what error message the bot replies with when someone tries
360 # to accessing some information on a user the bot doesn't know about.
361 ###
362 supybot.replies.noUser: I can't find %s in my user database. If you didn't\
363                         give a user name, then I might not know what your\
364                         user is, and you'll need to identify before this\
365                         command might work.
366
367 ###
368 # Determines what error message the bot replies with when someone tries
369 # to do something that requires them to be registered but they're not
370 # currently recognized.
371 ###
372 supybot.replies.notRegistered: You must be registered to use this command.\
373                                If you are already registered, you must\
374                                either identify (using the identify command)\
375                                or add a hostmask matching your current\
376                                hostmask (using the "hostmask add" command).
377
378 ###
379 # Determines what error message is given when the bot is telling someone
380 # they aren't cool enough to use the command they tried to use.
381 ###
382 supybot.replies.noCapability: You don't have the %s capability. If you think\
383                               that you should have this capability, be sure\
384                               that you are identified before trying again.\
385                               The 'whoami' command can tell you if you're\
386                               identified.
387
388 ###
389 # Determines what generic error message is given when the bot is telling
390 # someone that they aren't cool enough to use the command they tried to
391 # use, and the author of the code calling errorNoCapability didn't
392 # provide an explicit capability for whatever reason.
393 ###
394 supybot.replies.genericNoCapability: You're missing some capability you\
395                                      need. This could be because you\
396                                      actually possess the anti-capability\
397                                      for the capability that's required of\
398                                      you, or because the channel provides\
399                                      that anti-capability by default, or\
400                                      because the global capabilities include\
401                                      that anti-capability. Or, it could be\
402                                      because the channel or\
403                                      supybot.capabilities.default is set to\
404                                      False, meaning that no commands are\
405                                      allowed unless explicitly in your\
406                                      capabilities. Either way, you can't do\
407                                      what you want to do.
408
409 ###
410 # Determines what error messages the bot sends to people who try to do
411 # things in a channel that really should be done in private.
412 ###
413 supybot.replies.requiresPrivacy: That operation cannot be done in a channel.
414
415 ###
416 # Determines what message the bot sends when it thinks you've
417 # encountered a bug that the developers don't know about.
418 ###
419 supybot.replies.possibleBug: This may be a bug. If you think it is, please\
420                              file a bug report at <http://sourceforge.net/tr\
421                              acker/?func=add&group_id=58965&atid=489447>.
422
423 ###
424 # A floating point number of seconds to throttle snarfed URLs, in order
425 # to prevent loops between two bots snarfing the same URLs and having
426 # the snarfed URL in the output of the snarf message.
427 #
428 # Default value: 10.0
429 ###
430 supybot.snarfThrottle: 10.0
431
432 ###
433 # Determines the number of seconds between running the upkeep function
434 # that flushes (commits) open databases, collects garbage, and records
435 # some useful statistics at the debugging level.
436 #
437 # Default value: 3600
438 ###
439 supybot.upkeepInterval: 3600
440
441 ###
442 # Determines whether the bot will periodically flush data and
443 # configuration files to disk. Generally, the only time you'll want to
444 # set this to False is when you want to modify those configuration files
445 # by hand and don't want the bot to flush its current version over your
446 # modifications. Do note that if you change this to False inside the
447 # bot, your changes won't be flushed. To make this change permanent, you
448 # must edit the registry yourself.
449 #
450 # Default value: True
451 ###
452 supybot.flush: True
453
454 ###
455 # Determines what characters are valid for quoting arguments to commands
456 # in order to prevent them from being tokenized.
457 #
458 # Default value: "
459 ###
460 supybot.commands.quotes: "
461
462 ###
463 # Determines whether the bot will allow nested commands, which rule. You
464 # definitely should keep this on.
465 #
466 # Default value: True
467 ###
468 supybot.commands.nested: True
469
470 ###
471 # Determines what the maximum number of nested commands will be; users
472 # will receive an error if they attempt commands more nested than this.
473 #
474 # Default value: 10
475 ###
476 supybot.commands.nested.maximum: 10
477
478 ###
479 # Supybot allows you to specify what brackets are used for your nested
480 # commands. Valid sets of brackets include [], <>, and {} (). [] has
481 # strong historical motivation, as well as being the brackets that don't
482 # require shift. <> or () might be slightly superior because they cannot
483 # occur in a nick. If this string is empty, nested commands will not be
484 # allowed in this channel.
485 #
486 # Default value: []
487 ###
488 supybot.commands.nested.brackets: []
489
490 ###
491 # Supybot allows nested commands. Enabling this option will allow nested
492 # commands with a syntax similar to UNIX pipes, for example: 'bot: foo |
493 # bar'.
494 #
495 # Default value: False
496 ###
497 supybot.commands.nested.pipeSyntax: False
498
499 ###
500 # Determines what commands have default plugins set, and which plugins
501 # are set to be the default for each of those commands.
502 ###
503 supybot.commands.defaultPlugins.addcapability: Admin
504 supybot.commands.defaultPlugins.capabilities: User
505 supybot.commands.defaultPlugins.disable: Owner
506 supybot.commands.defaultPlugins.enable: Owner
507 supybot.commands.defaultPlugins.help: Misc
508 supybot.commands.defaultPlugins.ignore: Admin
509
510 ###
511 # Determines what plugins automatically get precedence over all other
512 # plugins when selecting a default plugin for a command. By default,
513 # this includes the standard loaded plugins. You probably shouldn't
514 # change this if you don't know what you're doing; if you do know what
515 # you're doing, then also know that this set is case-sensitive.
516 #
517 # Default value: Plugin Admin Misc User Owner Config Channel
518 ###
519 supybot.commands.defaultPlugins.importantPlugins: Plugin Admin Misc User Owner Config Channel
520 supybot.commands.defaultPlugins.list: Misc
521 supybot.commands.defaultPlugins.reload: Owner
522 supybot.commands.defaultPlugins.removecapability: Admin
523 supybot.commands.defaultPlugins.unignore: Admin
524
525 ###
526 # Determines what commands are currently disabled. Such commands will
527 # not appear in command lists, etc. They will appear not even to exist.
528 #
529 # Default value:  
530 ###
531 supybot.commands.disabled:  
532
533 ###
534 # Determines whether the bot will defend itself against command-
535 # flooding.
536 #
537 # Default value: True
538 ###
539 supybot.abuse.flood.command: True
540
541 ###
542 # Determines how many commands users are allowed per minute. If a user
543 # sends more than this many commands in any 60 second period, he or she
544 # will be ignored for supybot.abuse.flood.command.punishment seconds.
545 #
546 # Default value: 12
547 ###
548 supybot.abuse.flood.command.maximum: 12
549
550 ###
551 # Determines how many seconds the bot will ignore users who flood it
552 # with commands.
553 #
554 # Default value: 300
555 ###
556 supybot.abuse.flood.command.punishment: 300
557
558 ###
559 # Determines whether the bot will defend itself against invalid command-
560 # flooding.
561 #
562 # Default value: True
563 ###
564 supybot.abuse.flood.command.invalid: True
565
566 ###
567 # Determines how many invalid commands users are allowed per minute. If
568 # a user sends more than this many invalid commands in any 60 second
569 # period, he or she will be ignored for
570 # supybot.abuse.flood.command.invalid.punishment seconds. Typically,
571 # this value is lower than supybot.abuse.flood.command.maximum, since
572 # it's far less likely (and far more annoying) for users to flood with
573 # invalid commands than for them to flood with valid commands.
574 #
575 # Default value: 5
576 ###
577 supybot.abuse.flood.command.invalid.maximum: 5
578
579 ###
580 # Determines how many seconds the bot will ignore users who flood it
581 # with invalid commands. Typically, this value is higher than
582 # supybot.abuse.flood.command.punishment, since it's far less likely
583 # (and far more annoying) for users to flood witih invalid commands than
584 # for them to flood with valid commands.
585 #
586 # Default value: 600
587 ###
588 supybot.abuse.flood.command.invalid.punishment: 600
589
590 ###
591 # Determines the default length of time a driver should block waiting
592 # for input.
593 #
594 # Default value: 1.0
595 ###
596 supybot.drivers.poll: 1.0
597
598 ###
599 # Determines what driver module the bot will use. Socket, a simple
600 # driver based on timeout sockets, is used by default because it's
601 # simple and stable. Twisted is very stable and simple, and if you've
602 # got Twisted installed, is probably your best bet.
603 #
604 # Default value: default
605 ###
606 supybot.drivers.module: default
607
608 ###
609 # Determines the maximum time the bot will wait before attempting to
610 # reconnect to an IRC server. The bot may, of course, reconnect earlier
611 # if possible.
612 #
613 # Default value: 300.0
614 ###
615 supybot.drivers.maxReconnectWait: 300.0
616
617 ###
618 # Determines what directory configuration data is put into.
619 #
620 # Default value: conf
621 ###
622 supybot.directories.conf: /home/eevee/dev/supybot/conf
623
624 ###
625 # Determines what directory data is put into.
626 #
627 # Default value: data
628 ###
629 supybot.directories.data: /home/eevee/dev/supybot/data
630
631 ###
632 # Determines what directory temporary files are put into.
633 #
634 # Default value: tmp
635 ###
636 supybot.directories.data.tmp: /home/eevee/dev/supybot/data/tmp
637
638 ###
639 # Determines what directory backup data is put into.
640 #
641 # Default value: backup
642 ###
643 supybot.directories.backup: /home/eevee/dev/supybot/backup
644
645 ###
646 # Determines what directories the bot will look for plugins in. Accepts
647 # a comma-separated list of strings. This means that to add another
648 # directory, you can nest the former value and add a new one. E.g. you
649 # can say: bot: 'config supybot.directories.plugins [config
650 # supybot.directories.plugins], newPluginDirectory'.
651 #
652 # Default value:  
653 ###
654 supybot.directories.plugins: /home/eevee/dev/supybot/plugins
655
656 ###
657 # Determines what directory the bot will store its logfiles in.
658 #
659 # Default value: logs
660 ###
661 supybot.directories.log: /home/eevee/dev/supybot/logs
662
663 ###
664 # Determines what plugins will be loaded.
665 #
666 # Default value:  
667 ###
668 supybot.plugins: Admin Misc User Owner Config Channel
669
670 ###
671 # Determines whether this plugin is loaded by default.
672 ###
673 supybot.plugins.Admin: True
674
675 ###
676 # Determines whether this plugin is publicly visible.
677 #
678 # Default value: True
679 ###
680 supybot.plugins.Admin.public: True
681
682 ###
683 # Determines whether this plugin is loaded by default.
684 ###
685 supybot.plugins.Channel: True
686
687 ###
688 # Determines whether this plugin is publicly visible.
689 #
690 # Default value: True
691 ###
692 supybot.plugins.Channel.public: True
693
694 ###
695 # Determines whether the bot will always try to rejoin a channel
696 # whenever it's kicked from the channel.
697 #
698 # Default value: True
699 ###
700 supybot.plugins.Channel.alwaysRejoin: True
701
702 ###
703 # Determines whether this plugin is loaded by default.
704 ###
705 supybot.plugins.Config: True
706
707 ###
708 # Determines whether this plugin is publicly visible.
709 #
710 # Default value: True
711 ###
712 supybot.plugins.Config.public: True
713
714 ###
715 # Determines whether this plugin is loaded by default.
716 ###
717 supybot.plugins.Misc: True
718
719 ###
720 # Determines whether this plugin is publicly visible.
721 #
722 # Default value: True
723 ###
724 supybot.plugins.Misc.public: True
725
726 ###
727 # Determines whether the bot will list private plugins with the list
728 # command if given the --private switch. If this is disabled, non-owner
729 # users should be unable to see what private plugins are loaded.
730 #
731 # Default value: True
732 ###
733 supybot.plugins.Misc.listPrivatePlugins: True
734
735 ###
736 # Determines the format string for timestamps in the Misc.last command.
737 # Refer to the Python documentation for the time module to see what
738 # formats are accepted. If you set this variable to the empty string,
739 # the timestamp will not be shown.
740 #
741 # Default value: [%H:%M:%S]
742 ###
743 supybot.plugins.Misc.timestampFormat: [%H:%M:%S]
744
745 ###
746 # Determines whether or not the timestamp will be included in the output
747 # of last when it is part of a nested command
748 #
749 # Default value: False
750 ###
751 supybot.plugins.Misc.last.nested.includeTimestamp: False
752
753 ###
754 # Determines whether or not the nick will be included in the output of
755 # last when it is part of a nested command
756 #
757 # Default value: False
758 ###
759 supybot.plugins.Misc.last.nested.includeNick: False
760
761 ###
762 # Determines whether this plugin is loaded by default.
763 ###
764 supybot.plugins.Owner: True
765
766 ###
767 # Determines whether this plugin is publicly visible.
768 #
769 # Default value: True
770 ###
771 supybot.plugins.Owner.public: True
772
773 ###
774 # Determines what quit message will be used by default. If the quit
775 # command is called without a quit message, this will be used. If this
776 # value is empty, the nick of the person giving the quit command will be
777 # used.
778 #
779 # Default value: 
780 ###
781 supybot.plugins.Owner.quitMsg: 
782
783 ###
784 # Determines whether this plugin is loaded by default.
785 ###
786 supybot.plugins.User: True
787
788 ###
789 # Determines whether this plugin is publicly visible.
790 #
791 # Default value: True
792 ###
793 supybot.plugins.User.public: True
794
795 ###
796 # Determines whether the bot will always load important plugins (Admin,
797 # Channel, Config, Misc, Owner, and User) regardless of what their
798 # configured state is. Generally, if these plugins are configured not to
799 # load, you didn't do it on purpose, and you still want them to load.
800 # Users who don't want to load these plugins are smart enough to change
801 # the value of this variable appropriately :)
802 #
803 # Default value: True
804 ###
805 supybot.plugins.alwaysLoadImportant: True
806
807 ###
808 # Determines what databases are available for use. If this value is not
809 # configured (that is, if its value is empty) then sane defaults will be
810 # provided.
811 #
812 # Default value: anydbm cdb flat pickle
813 ###
814 supybot.databases: 
815
816 ###
817 # Determines what filename will be used for the users database. This
818 # file will go into the directory specified by the
819 # supybot.directories.conf variable.
820 #
821 # Default value: users.conf
822 ###
823 supybot.databases.users.filename: users.conf
824
825 ###
826 # Determines how long it takes identification to time out. If the value
827 # is less than or equal to zero, identification never times out.
828 #
829 # Default value: 0
830 ###
831 supybot.databases.users.timeoutIdentification: 0
832
833 ###
834 # Determines whether the bot will allow users to unregister their users.
835 # This can wreak havoc with already-existing databases, so by default we
836 # don't allow it. Enable this at your own risk. (Do also note that this
837 # does not prevent the owner of the bot from using the unregister
838 # command.)
839 #
840 # Default value: False
841 ###
842 supybot.databases.users.allowUnregistration: False
843
844 ###
845 # Determines what filename will be used for the ignores database. This
846 # file will go into the directory specified by the
847 # supybot.directories.conf variable.
848 #
849 # Default value: ignores.conf
850 ###
851 supybot.databases.ignores.filename: ignores.conf
852
853 ###
854 # Determines what filename will be used for the channels database. This
855 # file will go into the directory specified by the
856 # supybot.directories.conf variable.
857 #
858 # Default value: channels.conf
859 ###
860 supybot.databases.channels.filename: channels.conf
861
862 ###
863 # Determines whether database-based plugins that can be channel-specific
864 # will be so. This can be overridden by individual channels. Do note
865 # that the bot needs to be restarted immediately after changing this
866 # variable or your db plugins may not work for your channel; also note
867 # that you may wish to set
868 # supybot.databases.plugins.channelSpecific.link appropriately if you
869 # wish to share a certain channel's databases globally.
870 #
871 # Default value: True
872 ###
873 supybot.databases.plugins.channelSpecific: True
874
875 ###
876 # Determines what channel global (non-channel-specific) databases will
877 # be considered a part of. This is helpful if you've been running
878 # channel-specific for awhile and want to turn the databases for your
879 # primary channel into global databases. If
880 # supybot.databases.plugins.channelSpecific.link.allow prevents linking,
881 # the current channel will be used. Do note that the bot needs to be
882 # restarted immediately after changing this variable or your db plugins
883 # may not work for your channel.
884 #
885 # Default value: #
886 ###
887 supybot.databases.plugins.channelSpecific.link: #
888
889 ###
890 # Determines whether another channel's global (non-channel-specific)
891 # databases will be allowed to link to this channel's databases. Do note
892 # that the bot needs to be restarted immediately after changing this
893 # variable or your db plugins may not work for your channel.
894 #
895 # Default value: True
896 ###
897 supybot.databases.plugins.channelSpecific.link.allow: True
898
899 ###
900 # Determines whether CDB databases will be allowed as a database
901 # implementation.
902 #
903 # Default value: True
904 ###
905 supybot.databases.types.cdb: True
906
907 ###
908 # Determines how often CDB databases will have their modifications
909 # flushed to disk. When the number of modified records is greater than
910 # this part of the number of unmodified records, the database will be
911 # entirely flushed to disk.
912 #
913 # Default value: 0.5
914 ###
915 supybot.databases.types.cdb.maximumModifications: 0.5
916
917 ###
918 # Determines what will be used as the default banmask style.
919 #
920 # Default value: host user
921 ###
922 supybot.protocols.irc.banmask: host user
923
924 ###
925 # Determines whether the bot will strictly follow the RFC; currently
926 # this only affects what strings are considered to be nicks. If you're
927 # using a server or a network that requires you to message a nick such
928 # as services@this.network.server then you you should set this to False.
929 #
930 # Default value: False
931 ###
932 supybot.protocols.irc.strictRfc: False
933
934 ###
935 # Determines what user modes the bot will request from the server when
936 # it first connects. Many people might choose +i; some networks allow
937 # +x, which indicates to the auth services on those networks that you
938 # should be given a fake host.
939 #
940 # Default value: 
941 ###
942 supybot.protocols.irc.umodes: 
943
944 ###
945 # Determines what vhost the bot will bind to before connecting to the
946 # IRC server.
947 #
948 # Default value: 
949 ###
950 supybot.protocols.irc.vhost: 
951
952 ###
953 # Determines how many old messages the bot will keep around in its
954 # history. Changing this variable will not take effect until the bot is
955 # restarted.
956 #
957 # Default value: 1000
958 ###
959 supybot.protocols.irc.maxHistoryLength: 1000
960
961 ###
962 # A floating point number of seconds to throttle queued messages -- that
963 # is, messages will not be sent faster than once per throttleTime
964 # seconds.
965 #
966 # Default value: 1.0
967 ###
968 supybot.protocols.irc.throttleTime: 1.0
969
970 ###
971 # Determines whether the bot will send PINGs to the server it's
972 # connected to in order to keep the connection alive and discover
973 # earlier when it breaks. Really, this option only exists for debugging
974 # purposes: you always should make it True unless you're testing some
975 # strange server issues.
976 #
977 # Default value: True
978 ###
979 supybot.protocols.irc.ping: True
980
981 ###
982 # Determines the number of seconds between sending pings to the server,
983 # if pings are being sent to the server.
984 #
985 # Default value: 120
986 ###
987 supybot.protocols.irc.ping.interval: 120
988
989 ###
990 # Determines whether the bot will refuse duplicate messages to be queued
991 # for delivery to the server. This is a safety mechanism put in place to
992 # prevent plugins from sending the same message multiple times; most of
993 # the time it doesn't matter, unless you're doing certain kinds of
994 # plugin hacking.
995 #
996 # Default value: False
997 ###
998 supybot.protocols.irc.queuing.duplicates: False
999
1000 ###
1001 # Determines how many seconds must elapse between JOINs sent to the
1002 # server.
1003 #
1004 # Default value: 0.0
1005 ###
1006 supybot.protocols.irc.queuing.rateLimit.join: 0.0
1007
1008 ###
1009 # Determines how many bytes the bot will 'peek' at when looking through
1010 # a URL for a doctype or title or something similar. It'll give up after
1011 # it reads this many bytes, even if it hasn't found what it was looking
1012 # for.
1013 #
1014 # Default value: 4096
1015 ###
1016 supybot.protocols.http.peekSize: 4096
1017
1018 ###
1019 # Determines what proxy all HTTP requests should go through. The value
1020 # should be of the form 'host:port'.
1021 #
1022 # Default value: 
1023 ###
1024 supybot.protocols.http.proxy: 
1025
1026 ###
1027 # Determines whether the bot will ignore unregistered users by default.
1028 # Of course, that'll make it particularly hard for those users to
1029 # register or identify with the bot, but that's your problem to solve.
1030 #
1031 # Default value: False
1032 ###
1033 supybot.defaultIgnore: False
1034
1035 ###
1036 # A string that is the external IP of the bot. If this is the empty
1037 # string, the bot will attempt to find out its IP dynamically (though
1038 # sometimes that doesn't work, hence this variable).
1039 #
1040 # Default value: 
1041 ###
1042 supybot.externalIP: 
1043
1044 ###
1045 # Determines what the default timeout for socket objects will be. This
1046 # means that *all* sockets will timeout when this many seconds has gone
1047 # by (unless otherwise modified by the author of the code that uses the
1048 # sockets).
1049 #
1050 # Default value: 10
1051 ###
1052 supybot.defaultSocketTimeout: 10
1053
1054 ###
1055 # Determines what file the bot should write its PID (Process ID) to, so
1056 # you can kill it more easily. If it's left unset (as is the default)
1057 # then no PID file will be written. A restart is required for changes to
1058 # this variable to take effect.
1059 #
1060 # Default value: 
1061 ###
1062 supybot.pidFile: 
1063
1064 ###
1065 # Determines whether the bot will automatically thread all commands.
1066 #
1067 # Default value: False
1068 ###
1069 supybot.debug.threadAllCommands: False
1070
1071 ###
1072 # Determines whether the bot will automatically flush all flushers
1073 # *very* often. Useful for debugging when you don't know what's breaking
1074 # or when, but think that it might be logged.
1075 #
1076 # Default value: False
1077 ###
1078 supybot.debug.flushVeryOften: False
1079
1080 ###
1081 # Determines what the bot's logging format will be. The relevant
1082 # documentation on the available formattings is Python's documentation
1083 # on its logging module.
1084 #
1085 # Default value: %(levelname)s %(asctime)s %(name)s %(message)s
1086 ###
1087 supybot.log.format: %(levelname)s %(asctime)s %(name)s %(message)s
1088
1089 ###
1090 # Determines what the minimum priority level logged to file will be. Do
1091 # note that this value does not affect the level logged to stdout; for
1092 # that, you should set the value of supybot.log.stdout.level. Valid
1093 # values are DEBUG, INFO, WARNING, ERROR, and CRITICAL, in order of
1094 # increasing priority.
1095 #
1096 # Default value: INFO
1097 ###
1098 supybot.log.level: INFO
1099
1100 ###
1101 # Determines the format string for timestamps in logfiles. Refer to the
1102 # Python documentation for the time module to see what formats are
1103 # accepted. If you set this variable to the empty string, times will be
1104 # logged in a simple seconds-since-epoch format.
1105 #
1106 # Default value: %Y-%m-%dT%H:%M:%S
1107 ###
1108 supybot.log.timestampFormat: %Y-%m-%dT%H:%M:%S
1109
1110 ###
1111 # Determines whether the bot will log to stdout.
1112 #
1113 # Default value: True
1114 ###
1115 supybot.log.stdout: True
1116
1117 ###
1118 # Determines whether the bot's logs to stdout (if enabled) will be
1119 # colorized with ANSI color.
1120 #
1121 # Default value: False
1122 ###
1123 supybot.log.stdout.colorized: False
1124
1125 ###
1126 # Determines whether the bot will wrap its logs when they're output to
1127 # stdout.
1128 #
1129 # Default value: True
1130 ###
1131 supybot.log.stdout.wrap: True
1132
1133 ###
1134 # Determines what the bot's logging format will be. The relevant
1135 # documentation on the available formattings is Python's documentation
1136 # on its logging module.
1137 #
1138 # Default value: %(levelname)s %(asctime)s %(message)s
1139 ###
1140 supybot.log.stdout.format: %(levelname)s %(asctime)s %(message)s
1141
1142 ###
1143 # Determines what the minimum priority level logged will be. Valid
1144 # values are DEBUG, INFO, WARNING, ERROR, and CRITICAL, in order of
1145 # increasing priority.
1146 #
1147 # Default value: INFO
1148 ###
1149 supybot.log.stdout.level: INFO
1150
1151 ###
1152 # Determines whether the bot will separate plugin logs into their own
1153 # individual logfiles.
1154 #
1155 # Default value: False
1156 ###
1157 supybot.log.plugins.individualLogfiles: False
1158
1159 ###
1160 # Determines what the bot's logging format will be. The relevant
1161 # documentation on the available formattings is Python's documentation
1162 # on its logging module.
1163 #
1164 # Default value: %(levelname)s %(asctime)s %(message)s
1165 ###
1166 supybot.log.plugins.format: %(levelname)s %(asctime)s %(message)s
1167
1168 ###
1169 # These are the capabilities that are given to everyone by default. If
1170 # they are normal capabilities, then the user will have to have the
1171 # appropriate anti-capability if you want to override these
1172 # capabilities; if they are anti-capabilities, then the user will have
1173 # to have the actual capability to override these capabilities. See
1174 # docs/CAPABILITIES if you don't understand why these default to what
1175 # they do.
1176 #
1177 # Default value: -owner -admin -trusted
1178 ###
1179 supybot.capabilities: -owner -admin -trusted
1180
1181 ###
1182 # Determines whether the bot by default will allow users to have a
1183 # capability. If this is disabled, a user must explicitly have the
1184 # capability for whatever command he wishes to run.
1185 #
1186 # Default value: True
1187 ###
1188 supybot.capabilities.default: True