Admin Commands

Updated 18 Sept, 2016

The majority of commands are restricted to admins and some are restricted to owners.  If your access level is less than a command requires, the bot will respond with unknown command or might say "This command is restricted".  You will also see unknown command if you mis-type it.  The commands listed here are not all the admin commands.  Most commands categories include admin commands specific to the category.

All commands are typed in in-game chat and begin with a  /   Commands have access levels and won't work for you if your level is too low.

/read claims

Make the bot run llp so it knows where all the claims are and who owns them.

/reload admins
Make the bot run admin list to reload the admins from the server's list.

/reload bot
Make the bot read several things from the server including admin list, ban list, gg, lkp and others. If you have Coppi's Mod installed it will also detect that.

/timeout <player>
Send a player to timeout. You can use their steam or game id and part or all of their name. If you send the wrong player to timeout /return <player> to fix that.  While in timeout, the player will not be able to use any bot commands but they can chat.

/return <player>
/return <player> to <location or other player>
Return a player from timeout. You can use their steam or game id and part or all of their name.
You can return them to any player even offline ones or to any location. If you just return them, they will return to wherever they were when they were sent to timeout.  Your regular players can also return new players from timeout but only if a player sent them there.

/release <player>
/just release <player>
Release a player from prison. They are teleported back to where they were arrested.
Alternatively just release them so they do not teleport and have to walk back or use bot commands.  See also /release here.

/leave claims <player>
Stop the bot automatically removing a player's claims. They will still be removed if they are in a location that doesn't allow player claims.

/remove claims <player>
The bot will automatically remove the player's claims whenever possible. The chunk has to be loaded and the bot takes several minutes to remove them but it will remove them.

/claims <range> (range is optional and defaults to 50)
List all of the claims within range with who owns them.

/exile <player>
Bannish a player to a special location called /exile which must exist first.
While exiled, the player will not be able to command the bot.

/free <player>
Release the player from exile, however it does not return them. They can type /return or you can return them.

/player <player> is not new
Upgrade a new player to a regular without making them wait for the bot to upgrade them. They will no longer be as restricted as a new player.

/add donor <player> level <0 to 7> expires <number> week or month or year
Give a player donor status. This doesn't have to involve money. Donors get a few perks above other players but no items or Zennies.
Level and expiry are optional. The default is level 1 and expiry 10 years.  You can also temporarily raise everyone to donor level with /override access.

/remove donor <player>
Remove a player's donor status.

/give <item> <quantity>
Give everyone that is playing quantity of an item. The default is to give 1 of the item.

/disallow teleport <player>
Prevent a player from using any teleports. They won't be able to teleport themselves, but they can still be teleported. Also physical teleports won't work for them.

/allow teleport <player>
The player will be able to use teleport commands and physical teleports again.

/enable waypoints
Donors will be able to create, use and share waypoints.

/disable waypoints
Waypoints will not be available.

/close shop
The shop will not be available.

/open shop
The shop will be available.

/reset shop
Restock the shop to the max quantity of each item.

/set shop open < 0 - 23 >
Enter a number from 0 to 23 which will be the game hour that the shop opens.

/set shop close < 0 - 23 >
Enter a number from 0 to 23 which will be the game hour that the shop closes.

/set shop location <location name>
Tie the shop to a location. Buying from the shop will only be possible while in that location (excluding admins).

/clear shop location
The shop will be accessible from anywhere.

/whitelist add <player>
Add a player to the bot's whitelist. This is not the server's whitelist and it works differently.  It exempts the player from ping kicks and country blocks.

/whitelist remove <player>
Remove a player from the whitelist.

/ignore player <player>
Allowed the player to have uncraftable inventory and ignore hacker like activity such as teleporting and flying.

/include player <player>
Treat the player the same as other players. They will not be allowed uncraftable inventory and hacker like activity will be treated as such.

/block player <player>
/unblock player <player>
Prevent a player from using IRC. Other stuff may be blocked in the future.

/prisoner <player> arrested <reason for arrest>
/prisoner <player> (read the reason if one is recorded)
You can record or view the reason for a player being arrested. If they are released, this record is destroyed.

/arrest <player>
Send a player to prison. If the location prison does not exist they are put into timeout instead.

/resettimers <player>
Normally a player needs to wait a set time after /base before they can use it again. This zeroes that timer and also resets their gimmies.

/exclude admins
The normal rules that apply to players will not apply to admins. They can go anywhere they want.

/include admins
Admins are treated the same as normal players and the bot will punish or block them as it would the players. This is mainly used to test the bot while still being an admin.

/freeze <player>
Bind a player to their current position. They get teleported back if they move.

/unfreeze <player>
Allow the player to move again.

/move <player> to <location>
Teleport a player to a location. To teleport them to another player use the send command.  If the player is offline, they will be moved to the location when they next join.

/sendhome <player> or /sendhome2 <player>
Teleport a player to their first or second base.

/watch <player>
/watch new players
Flag a player or all current new players for extra attention and logging. New players are watched by default.

/stop watching <player>
/stop watching everyone
Stop watching a player or stop watching everyone. Activity will still be recorded but admins won't see private messages about it.

/send <player1> to <player2>
Teleport a player to another player even if the other player is offline.

/burn <player>
Set a player on fire. It usually kills them.

/shutdown bot
While not essential as it seems to work just fine, you can tell the bot to save all pending player data, before you quit Mudlet.

/reset stack
If you have changed stack sizes and the bot is mistakenly abusing players for overstacking, you can make the bot forget the stack sizes.
It will re-learn them from the server as players overstack beyond the new stack limits.

/unban <player>
Remove a player from the server's ban list.

/ban <player> (ban for 10 years with the reason 'banned')
/ban <player> reason <reason for ban> (ban for 10 years with the reason you provided)
/ban <player> time <number> hour or day or month or year reason <reason for ban>
Ban a player from the server. You can optionally give a reason and a duration. The default is a 10 year ban with the reason 'banned'.

/list owners
Lists the server owners and shows who if any are playing.

/list admins
Lists the server admins and shows who if any are playing.

/list mods
Lists the server mods and shows who if any are playing.

/list staff
Lists the server staff and shows who if any are playing.

/add bad item <item>
Add an item to the list of bad items. The default action is to timeout the player.
See also /ignore player <name> and /include player <name>

/remove bad item <item>
Remove an item to the list of bad items.

/bad items
List the items that are not allowed in player inventories and what action is taken.

/add restricted item <item name> qty <count> action <action> access <level>
Add an item to the list of restricted items.
Valid actions are timeout, ban, exile and watch
eg. /add restricted item tnt qty 5 action timeout access 90
Players with access > 90 will be sent to timeout for more than 5 tnt.

/remove restricted item <item name>
Remove an item from the list of restricted items.

/restricted items
List the items that new players are not allowed to have in inventory and what action is taken.

/reserve slot <player>
Give a player the right to take a reserved slot when the server is full.

/unreserve slot <player>
Remove a player's right to take a reserved slot when the server is full.


Admin In-Game Only:

/who visited <player> days <days> hours <hrs> range <dist> height <ht>
See who visited a player location or base.
Example with defaults: /who visited smeg days 1 hours 1 range 10 height 4
Add base to just see base visitors. Setting hours will reset days to zero.
Use this command to discover who's been at the player's location.

/bases (or homes)
/bases range <number>
/bases near <player> range <number>
See what player bases are nearby. You can use it on yourself or on a player.
Range and player are optional. The default range is 200 metres.

/admin add <player or steam or game ID> level <0-2>
Give a player admin status and a level.
Server owners are level 0, admins are level 1 and moderators level 2.

/admin remove <player or steam or game ID>
Remove an admin so they become a regular player.
This does not stop them using god mode etc if they are ingame and already have dm enabled. They must leave the server or disable dm themselves.

/goto <player or steam or game ID>
Teleport to the current position of a player.  This works with offline players too.

/offline players nearby
/offline players nearby range <number>
List all offline players near your position. The default range is 200 metres.

/crimescene <prisoner>
Teleport to the coords where a player was when they got arrested.

/near <player> <optional number>
Teleport below and a short distance away from a player. You must be flying for this or you will just fall all the time.
You arrive 20 metres below the player and 10 metres to the side. If you give a number after the player name you will be that number metres off to the side.  The bot will keep you near the player, teleporting you close to them if they get away from you.
To stop following them type /stop.

/prisoners
List all the players who are prisoners.

/equip admin
Spawn various items on you. The bot checks your inventory and will top you up instead of doubling up if you repeat this command later.

/supplies
Spawn various items on you like equip admin does but no armour or guns. The bot checks your inventory and will top you up instead of doubling up if you repeat this command later.

/release here <prisoner>
Release a player from prison and move them to your location.

/playerbase <player>
/playerhome <player>
/playerbase2 <player>
/playerhome2 <player>
Teleport yourself to the first or second base of a player.