KazTron - Introduction | /r/Worldbuilding Network

KazTron is the /r/worldbuilding Discord server’s resident helper bot! It mostly helps the moderators manage the community and run features like the World Spotlight, with a few automation features that happen behind the scenes, and a few commands of use to our members.

This website documents the usage of the various commands, organised by module. Note that not all modules may be loaded, depending on needs as judged by the moderation team.

Note: Setting up a copy of KazTron is outside the scope of this manual. For any inquiries, you can get in touch with us via Reddit modmail or the #meta channel of our Discord server.

Important: KazTron is designed for use on one Discord server at a time. It is not possible to invite it to other Discord servers: you would need to host it yourself on a separate bot account and on your own server/VPS.

How to use KazTron commands

KazTron is always monitoring all text channels for commands. The structure of a command is as follows:

<prefix><command_name> [arg1 [arg2 [arg3...]]]

The prefix, in this case ., is how KazTron identifies a command intended for it, versus any normal message. This is followed by the command name, a space, and then any number of arguments separated by spaces (very similarly to command line tools, IRC bots, and IRC NickServ/ChanServ commands). If an argument contains spaces, you should enclose it in quotes to ensure it gets interpreted as a single argument.

Tip: If you see your command message instantly disappear, don’t panic—check your PMs! For some commands, this is done to avoid channel spam.

Examples

If you want to be notified about World Spotlight events and updates, you can type this command in any channel:

.spotlight join

If you want to roll dice, say three 20-sided dice, you could type the following message in any channel:

.roll 3d20

Getting Help

In addition to this manual, you can always get contextual help from within Discord. To get a list of commands you can use, type .help into any channel on the server. To get help on specific commands, you can type .help <command>, or even get help with subcommands using .help <command> <subcommand>.

For example, .help spotlight will give you general information on the spotlight bot features, whereas .help spotlight join will specifically tell you about the “join” subcommand and its syntax. (In this case, the commands are both very simple, though!)

Tip: Ask for .help in the same channel that you want to use commands in. KazTron only shows commands you’re allowed to use based on your account and the channel you ask in.