Commands

This is a reference of wurstminebot commands. If you don't want to check this page every time, you can also use the  command.

General usage
There are 4 ways to execute a command. Let's say you want to execute the command  (which will give you the description for ). You can:


 * send  to wurstminebot in query,
 * send  to #wurstmineberg or any other channel with Wurstminebot in it,
 * send  to #wurstmineberg or any other channel with Wurstminebot in it, or
 * write  in the in-game chat.

All commands are case-insensitive, so for example  is the same command as.

You will usually get a reply in the same chat where you send the command (a notable exception being ), but note that replies sent to you in the in-game chat are not visible to other players. Commands and their replies are also not chatsynced, so for example commands sent to IRC will not show up in-game.

Permissions
Some commands can only be executed by people with a certain permission level. There are five levels of permissions:


 * level 0: command can be executed by anyone and everyone who found our IRC channels (but can also be executed in query or in-game). Aliases are always level 0 (except for command aliases).
 * level 1: to execute this command, you must be in the list of people. If you are executing these commands (or one with a higher permission level) from IRC, the bot also needs to know your IRC nick.
 * level 2: to execute this command, you must be either on the whitelist or invited to join (and not vetoed).
 * level 3: to execute this command, you must be on the whitelist.
 * level 4: to execute this command, you must be a bot op. Currently, the bot ops are, , , and.

AchievementTweet
''Permission level: 3 Usage: ''

With this command, you can control whether or not in-game achievements will be tweeted. It has different effects depending on arguments:


 * (no arguments): you get a reply saying whether or not achievement tweets are currently on.
 * : this will turn on achievement tweets.
 * (requires permission level 4): this will turn off achievement tweets.
 * : this will temporarily turn off achievement tweets.  needs to be replaced by a value like   for one hour and 20 minutes, which may not be longer than a day. This command uses real time.

Alias
''Permission level: 2 Usage: ''

There are 4 kinds of aliases:


 * aliases refer to another command. For example,  is an alias for.
 * aliases don't do anything. They can be used to disable commands with the same name.
 * aliases cause the bot to reply with a custom message. For example,  is a reply alias for.
 * aliases are substituted with a custom text. They are described in more detail below.

With this command, you can only create  aliases. Bot ops can also override existing aliases with a new  alias, and delete any alias. To delete an alias, leave out the  argument. Otherwise, the alias will be created (or edited) with that text. For example, to create the alias  with the text , write.

Aliases are used like commands. If you execute a say alias, the bot will show the alias text in your current chat, and will chatsync the alias text as if you had sent it as a regular message. For example, if were to send   to #wurstmineberg, the bot would reply with , and the same would appear in-game. Aliases can override commands, but creating an alias which is already a command requires permission level 4.

Backup
''Permission level: 4 Usage: ''

This commands creates a backup of the world directory, like those that are automatically created every hour.

Cloud
Usage: 

Wurstminebot will use and  to search for the given item's position in the Cloud, and reply with the floor, corridor, and row number where the item is located.

All Cloud positions have now been entered into cloud.json, and the bot will reply “ is not available in the Cloud” if it knows that the item is not available. If the item ID is not found, the bot will reply with a different error message.

Command
''Permission level: 4 Usage: ''

This command sends a command to the Minecraft server. For example, to execute the server command, you can execute the Wurstminebot command.

The bot will reply with any output the command generates. This is done by waiting a bit after the command is sent and regarding any server output generated during that time as belonging to the command. Because of this, some of the command output may be missed, or unrelated log messages may be included in the reply.

DeathGames
''Permission level: 3 Usage: ''

With this command, you can record a Death Games assassination attempt, and whether or not it was successful. means the attacker succeded in killing the target, and  means they did not and were killed by the target instead. If the attacker is omitted, it is assumed that the sender of the command attacked.

The log maintained by this command is visible on.

The bot may automatically record successful attempts if it sees a matching death message, so make sure you don't create duplicate entries.

DeathTweet
''Permission level: 3 Usage: ''

With this command, you can control whether or not deaths will be tweeted. It has different effects depending on arguments:


 * (no arguments): you get a reply saying whether or not death tweets are currently on.
 * : this will turn on death tweets.
 * (requires permission level 4): this will turn off death tweets.
 * : this will temporarily turn off death tweets.  needs to be replaced by a value like   for one hour and 20 minutes, which may not be longer than a day. This command uses real time.

EnableWorld
''Permission level: 4 Usage: ''

This command can be used to switch between different configured Minecraft worlds.

The world must be located at  if it already exists, and there must be a   which uses the correct.

The bot will stop the server if it is running, then symlink the  to , and if the server was running it will then restart the server.

FixStatus
Usage: 

When you execute this command, wurstminebot:


 * updates the used on the website,
 * rebuilds the whitelist from people.json,
 * reloads the whitelist into Minecraft, and
 * updates the topic in #wurstmineberg.

Help
Usage: 

When you execute this command, wurstminebot will reply with information in private. The contents of the reply depend on the arguments:


 * (no arguments): a quick intro on what wurstminebot is.
 * : a list of currently defined aliases.
 * : the full list of commands, not including aliases. Note that some commands listed there may be disabled or overridden by aliases of the same name.
 * or : a short summary on what the command or alias does, including permission level and usage pattern, and a link to the relevant section on this page. The command descriptions on this article are usually more detailed, but do not include aliases.

Invite
''Permission level: 3 Usage: ''

With this command, you can invite a new player to be whitelisted. Please note the rules and ask them first! The command arguments work like with.

Join
''Permission level: 4 Usage: ''

This command makes the bot join an IRC channel. The channel will also be added to the bot's configuration file if it wasn't listed already.

LastSeen
Usage: 

If  is currently on the server, the bot will say so.

Otherwise, the bot will search backwards through the logs to find the last time the player left the game, and reply with that date. If the Minecraft server is not logging in UTC, the date may be wrong.

Leak
''Permission level: 2 Usage: ''

When this command is executed, the bot will tweet the last  lines from the chatsync's log. Commands and their replies are not logged, so they are not included in the tweet. defaults to 1. If there is room, the hashtag #ircleaks will be added to the end of the tweet.

MinecraftWiki
Usage: 

With this command, you can look something up in the. Just type the article name and a link will show.

When used in-game, the reply will just be “Article”, which is a clickable link to the article.

Option
''Permission level: 1 Usage: ''

With this command, you can set options for yourself. Bot ops can edit anyone's options. Options are boolean values stored in people.json and used by the bot and the website. You can set any option with this command, but only a few actually do anything:


 * °: When this option is off, the bot will refrain from @mentioning you in achievement and death tweets (this feature is not yet implemented).
 * °: When this option is off, your messages to the in-game chat will be synced to IRC with a U+200C ZERO WIDTH NON-JOINER inserted between the first and second letter of your IRC nick, to avoid highlighting you every time you write something in-game. This will not work if your IRC nick is not entered into people.json.
 * °: When this option is on, the bot will send you a tweet after a random time (between 1 and 6 months) of inactivity (this feature is not yet implemented, see here for the feature request) and on your whitelisting anniversary (not yet implemented either, see here for the feature request). When it's off, it will still tweet about your anniversary, but without @mentioning you.
 * : Whether or not your profile page should show your inventory. Example:,.
 * : When this option is on, you will see when people join or leave IRC channels the bot is in. Because of a bug in Python-IRC-Bot-Framework, this option currently only works sometimes.
 * : When this option is on, you will see when people in IRC channels the bot is in change their nick. Because of a bug in Python-IRC-Bot-Framework, this option currently doesn't work.

Options marked with a ° are on by default, all other options are off by default. However, the option  is automatically set to   for new players.

When used in the form  (no second argument), the bot will reply with  's value of the given option. All options are case-insensitive.

removes the option from 's people.json entry, reverting it to the default value.

defaults to the person executing the command.

PasteMojira
Usage: 

This command pastes the title of an issue on Mojira, Mojang's bug tracker.

is the key of the project the issue was reported to, and defaults to  (Minecraft). The list of projects on Mojira and their keys can be found here.

As with other commands, the reply to  is not chatsynced. A similar result but with chatsyncing can be achieved by simply pasting a Mojira issue's URL to the in-game chat or an IRC channel with wurstminebot in it.

to be continued

PasteTweet
Usage: 

This command pastes the contents of a tweet.

As with other commands, the reply to  is not chatsynced. A similar result but with chatsyncing can be achieved by simply pasting a tweet's URL to the in-game chat or an IRC channel with wurstminebot in it.

People
Usage: 

This command lets you edit your account info (aka people.json). Bot ops can edit anyone's info.

is the Wurstmineberg ID of the person whose info you want to edit.

The following attributes are currently accessible through the command:


 * : Your description. This will be used on the website in the and on your profile page. May include HTML.
 * : Your favorite color, used for . Must be in red, green, blue format with values from 0 to 255 either separated by spaces or in hexadecimal format without spaces (and with an optional  prefix).
 * : Your Gravatar email address. Can be deleted using a  of   or.
 * : Your display name. This is the name you want to be addressed by. If you don't have a display name set, your Wurstmineberg ID will usually be used instead. On Twitter and in Minecraft and IRC, your nickname on that service will be used, falling back to this display name if it is unknown.
 * : Your reddit username. Will be displayed on your profile page.
 * : Your Twitter username. Will be displayed on your profile page, and @wurstmineberg will follow you and add you to a list.
 * : The URL to your website. Will be displayed on your profile page.
 * : Your username on this wiki. Will be displayed on your profile page.

To have other attributes changed, you need to ask an admin to edit your people.json entry.

If  is omitted, the bot will reply with the current value of the. Since all account info is public, this also works for other people, even if you're not a bot op.

If  is also omitted, the bot will reply with the  's Wurstmineberg ID and display name (if any). In the in-game chat, this reply is a clickable link to their profile page.

If  is also omitted, the bot will reply with a link to the  page. This is just a leftover legacy feature.

Quit
''Permission level: 4 Usage: ''

This command stops the bot with a custom quit message.

The shutdown will be announced in the in-game chat with the message “Shutting down the bot: ”, or “Shutting down the bot...” if   is omitted.

The  (or “bye” if not specified) is also used as the quit message for the IRC   command.

Other than this, the behavior is the same as.

Raw
''Permission level: 4 Usage: ''

The bot will send  as a raw command to the IRC network. See this Wikipedia article for an overview of commands.

Restart
''Permission level: 4 Usage: ''

With this command, the bot can restart the Minecraft server or itself. The default behavior when this command is executed without any arguments is to restart the bot.

When the bot restarts itself, it will announce this (as well as its return) in both the main IRC channel and the in-game chat.

Restarting the Minecraft server will occur after a warning to the in-game chat and a 10 second wait during which the world is saved. If the Minecraft server was not running, the bot will say so and simply start it up (there is no dedicated  command). If the  command was executed from IRC, the bot will reply with status updates during the restart.

For both modes, a special notice will be added to the main channel's topic in place of the list of online players until the restart is complete.

is one of the mutually exclusive commands that control server status. If one of these is already running, the command cannot be started.

Retweet
''Permission level: 4 Usage: ''

The bot will retweet the given status from its configured twitter account, @wurstmineberg. This will be a native retweet, retweets with comments (aka quoted tweets) are not currently supported.

If  is specified, the bot will reply with the URL to the retweet. Otherwise, the retweet will be pasted to chatsync.

Status
Usage: 

The bot will reply with the following info:


 * If the command was not executed from the in-game chat, the players who are currently online.
 * The Minecraft version the server is currently running, including a link to the Minecraft Wiki's article on the version. (When executed from the in-game chat, click on the version number for the wiki article.)

If the server is offline, the bot will say so instead.

Additionally, the bot will check http://status.mojang.com/check and reply with any items which are not.

Stop
''Permission level: 4 Usage: ''

With this command, the bot can stop the Minecraft server or itself. The default behavior when this command is executed without any arguments is to stop the bot.

When the bot stops itself, it will announce this in both the main IRC channel and the in-game chat.

Stopping the Minecraft server will occur after a warning to the in-game chat and a 10 second wait during which the world is saved. If the  command was executed from IRC, the bot will reply with status updates during the shutdown.

For both modes, a special notice will be added to the main channel's topic in place of the list of online players until the topic is changed manually, is executed, or the bot or server are restarted.

is one of the mutually exclusive commands that control server status. If one of these is already running, the command cannot be started.

Time
Usage: 

The bot replies with the current time, in both UTC and the server's system timezone.

There is a feature request for this command to also output Minecraft in-game time, but it is not implemented yet.

Topic
''Permission level: 4 Usage: ''

The bot changes the main topic to. The main topic is used in the main IRC channel's topic, with a list of online players or special server status (if any) appended. The main topic is also saved in wurstminebot's config file.

Tweet
''Permission level: 4 Usage: ''

The bot will post a status update with  as the text from the configured Twitter account (@wurstmineberg for our instance of the bot).

If the tweet is sent successfully, its link will be pasted where the command was executed, and the full tweet will be pasted in the remaining parts of chatsync.

If the status update fails, the bot will reply with the error message from the Twitter API.

UltraSoftcore
''Permission level: 0 Usage: ''

Warning: This command is currently highly experimental.


 * shuts down the server and enables the USC world. It also sets the appropriate config entries for the bot to turn off chatsync, etc. The  and   arguments are currently ignored, they may be used to let the bot announce upcoming USCs in future updates.
 * currently does nothing, since the server is already stopped when  is run.
 * restarts the server and sets a special IRC topic with an announcement that the lobby is open.
 * resets the server to normal operation.
 * gives the doodle URL for the next USC date. This is available to all users (permission level 0). Subcommands require permission level 4:
 * changes the doodle URL to the given value. This currently doesn't validate the URL at all, so handle with care.
 * removes the doodle URL.

If no subcommand is specified, the next one in order is run, depending on the current state, as tracked in the config.

is one of the mutually exclusive commands that control server status. If one of these is already running, the command cannot be started.

Update
''Permission level: 4 Usage: ''

If the appropriate init-minecraft config entry is defined, the bot will back up the world to a file at, where   is the version that was running before the update. It will then shut down the Minecraft server, update minecraft_server.jar to the specified version, and restart the server.

The version that is loaded depends on the arguments:


 * : the latest snapshot or release of Minecraft, whichever is newer.
 * : the latest released version of Minecraft.
 * : the snapshot for the current week with the specified snapshot ID. For example, if the current week is calendar week 3 of 2014, and  is , the bot will update to snapshot.
 * : the bot will attempt to get the specified version or snapshot.

As with, the bot will add a notice to the IRC channel topic and reply with status updates about the update process. After the update is finished, it will also post a tweet about the update.

is one of the mutually exclusive commands that control server status. If one of these is already running, the command cannot be started.

Version
Usage: 

The bot replies with its own version number and the version number of init-minecraft it is running on. The bot's version number will be the short commit hash if it is not running on the master branch.

Whitelist
''Permission level: 4 Usage: ''

With this command, you can add someone to the Minecraft server whitelist. The  can be one of two things:


 * The Wurstmineberg ID of someone who is already invited but not whitelisted yet, or
 * a new Wurstmineberg ID, for adding a new player to people.json and whitelisting them right away. (This would normally be against the invitation rules and guidelines, but you're a bot op so I hope you know what you're doing.)

The  is only optional when it's already specified for the person.

If  is specified and the bot has its twitter feature configured, it will also follow the new player and add them to the members list.