Admin commands

These are commands that require elevated access in order to execute (either by being owner, admin, or 'ed the command). Some commands only work in debug mode by default but can be enabled for normal mode by editing  in your. Parameters wrapped in angle brackets  are required. Parameters wrapped in square brackets  are optional. A pipe character  indicates multiple valid options. The prefix  is used here, as it is the default, but it will obviously be whatever prefix you set for your instance.

Admin commands
These commands require either admin or owner access in botconfig.py or can be 'ed to a user.

Causes the bot to action message to target (a la /me). If used by a non-admin, the only allowed target is the main channel, otherwise can be used to target anything.

Causes the given  to be executed after the current game is finished. You must still have permission to execute whatever command that is. Only one faftergame command will apply, future uses on the same game will overwrite what was previously set. (Note: this is due to how this command works internally, and may change eventually.)

Forces the night to end immediately. Any night commands that were given before  was used still take effect (such as killing, giving out totems, etc.).

Causes the bot to  IRC and then shutdown (terminating the bot's process). If a reason is specified, it will be included in the quit message.

Aliases:

Forces the gamemode to be selected and disables voting on game modes by players. In addition to regular modes, the special  mode is available which can be used to set arbitrary roles. The syntax for the roles mode looks like so:. Example:.

This command is only enabled for debug mode unless it is added to  in.

Causes a goat to wander by and violently kick or headbutt the phrase passed in. This gets around any restrictions on  in that it can be used an unlimited number of times at any point (not just during day).

Causes the bot to treat every nick in the list of parameters as if they executed a  command. If any given nick has 1 game of stasis, the stasis will be removed and they will join. If any given nick has more than 1 game of stasis, they will not be joined by this command -- the stasis will need to be removed with  first.

If debug mode is enabled, fake nicks can be joined this way. A fake nick is a nickname that contains only numbers.

Disables starting new games, and optionally runs command after the current game is complete as if you executed  command. The bot must be restarted (via, the command line, killing and restarting the process or similar) before new games may commence.

Causes the bot to treat every nick in the list of parameters as if they executed a  command. This will not cause the effected nicks to get stasis, even if a game is currently running.

Aliases:

Forces the day to end immediately as if it had reached its maximum time. If any votes are currently in place, they will be counted for a lynch (with nobody being lynched on a tie).

Forces the chosen nick to execute the given command. A special nick of  will force everyone currently playing to execute the command. The command may not be an admin command unless the person using  is an actual admin. Owner-only commands may never be forced. This command must be used in-channel, it cannot be used in pm.

This command is only enabled for debug mode unless it is added to  in.

Causes the bot to  the given channel. This command cannot be used to force the bot to leave the main channel (the  setting in  ).

Causes the bot to update its source code using. Assuming you set up the bot by cloning the lykos repository here, this will cause you to get the latest version of the source. After  is ran, you should   or   to make the changes take effect.

Causes the bot to  and then restart (forking off to a new process). This will make it pick up on any code changes that were made to the bot's code, such as changes obtained from editing  or executing. If a reason is specified, it will be included in the quit message. If any players are currently joined, they will be highlighted by the bot after it rejoins the channel.

Changes the nick's role to role or adds/removes a template from nick. If used on someone not currently playing, causes them to join the game on a player and then sets their role accordingly. Certain roles and templates can take a parameter. For example, you can specify what totem a shaman has by  or how many bullets a gunner has by.

This command is only enabled for debug mode unless it is added to  in.

Causes the bot to say message to target. If used by a non-admin, the only allowed target is the main channel, otherwise can be used to target anything.

Lets you spectate wolfchat or deadchat, or removes you from spectating such. Users in the chat are not alerted that you are spectating, and you will be relayed everything that is said in that chat. If in debug mode, this has no restrictions on use and can be used in-channel. If in normal mode, this command may only be used by dead or unjoined players and will always respond in PM. Active vengeful ghosts are not counted as &quot;dead&quot; for the purpose of using this command.

Forces the game to start, ignoring any wait time that is currently in effect. All other conditions for starting (e.g. maximum and minimum players) must still be met.

Gets or sets the stasis on someone. If used without an amount, shows how much stasis is currently on the specified nick, account, or host. If used with an amount, sets the stasis for that nick, account, or host to the specified amount. Stasis prevents that person from ing that number of games, and is reduced by 1 each time a game is started. To remove stasis from someone entirely, set the amount to 0.

Stops any game currently in progress. The game will not count towards any statistics.

Forces the bot to sync up channel modes with what it currently expects, useful if a game is running during netsplits and the servers mess up the modes. It will cause the bot to voice all alive players, devoice everyone else, and set  if a game is running or   if a game is not running.

Adds or removes a number of seconds from the wait time.

Reveals all information about the game in progress, including who has what role and role-specific information such as who has which totems, who assassins are targeting, etc. If in debug mode, this has no restrictions on use and can be used in-channel. If in normal mode, this command may only be used by dead or unjoined players and will always respond in PM. Active vengeful ghosts are not counted as &quot;dead&quot; for the purpose of using this command.

This command is only enabled for debug mode unless it is added to  in.

Forces everyone that is the chosen role to execute the given command. A special role of  will force everyone currently playing to execute the command. The command may not be an admin command unless the person using  is an actual admin. Owner-only commands may never be forced. This command must be used in-channel, it cannot be used in pm.

This command is only enabled for debug mode unless it is added to  in.

Admin-only commands
These commands require either admin or owner access in  and cannot be  'ed to a user.

In the first mode, views or sets the allow list for the given nick, account, or host. If specified without any commands, views the current list for that person. If commands are specified, any commands prefixed with  are removed and all other commands are added to the allow list for that person. If  is given, it will remove all commands from the allow list of that person. In the second mode, shows everyone who is allowed the given command. In the third mode, prints out the entire allow list broken up by command.

is used to give access to all of the commands above that are listed as &quot;Admin commands.&quot; Use the  variant to remove commands from the allow list. The deny list (see  below) is not the opposite of , they are two separate lists. If a command is both denied and allowed, the deny takes precedence.

In the first mode, views or sets the deny list for the given nick, account, or host. If specified without any commands, views the current list for that person. If commands are specified, any commands prefixed with  are removed and all other commands are added to the deny list for that person. If  is given, it will remove all commands from the deny list of that person. In the second mode, shows everyone who is denied the given command. In the third mode, prints out the entire deny list broken up by command.

is used to deny access to any non-role command (such as  or , but not   or  ). Use the  variant to remove commands from the deny list. The allow list (see  above) is not the opposite of , they are two separate lists. If a command is both denied and allowed, the deny takes precedence. Admins and owners bypass the deny list and are given access to all commands according to their access level.

Causes the bot to send any arbitrary raw IRC command to the server. This must follow all IRC specifications, for example.

Owner-only commands
These commands require owner access in  and cannot be  'ed to a user.

Evaluates expression as a Python expression and prints the result. Warning: This is dangerous and has the potential to do a lot of harm! You will often not need this, as this is used mainly for testing and debugging.

This command is only enabled for debug mode unless it is added to  in.

Executes arbitrary Python code. Warning: This is dangerous and has the potential to do a lot of harm! You will often not need this, as this is used mainly for testing and debugging.

This command is only enabled for debug mode unless it is added to  in.