All Bot Commands (new version)

Updated 27 February, 2018

This is the help taken from the next major update of the bot.  Several commands have changed slightly.  The biggest change is that some commands have moved to more appropriate sections and the commands have been sorted.  Each command is now a function and in the code the functions are sorted.  The actual commands don't always match their function names so the sorting isn't perfect.

/reload code
Tell the bot to reload all external Lua scripts. This also happens shortly after restarting the bot and it can automatically detect if the scripts are not loaded and reload them.
Once the script have loaded, if you make any changes to them you need to run this command or restart the bot for your changes to take effect.

/pause bot
Temporarily disable the bot. It will still read the chat and can be enabled again.

Unslashed Commands:

Unslashed commands are simply words in normal chat that trigger a response from the bot.

Your bot will react to any player using the words hack, cheat, grief or flying. That triggers a special scan for hackers.
Any players with a non-zero hacker score found near the player will be immediately exiled. If you don't have the exile location set up, nothing will happen.

When feral. Like /day7, the bot will report how many days remain until a horde night.
When reboot. The bot will report how long until the next reboot.

restart bot
If your bot is launched from a custom script with the ability to restart itself, you can command your bot to restart.
All of Smegz0r's hosted bots have this feature. Contact Smeg if you need help adding it to your bot.

Info Commands:

/uptime
Reports the bot and server's running times.

/server or /info
Displays info mostly from the server config.

/next reboot
Reports the time remaining before the next scheduled reboot.

/fps
Displays the most recent output from the server mem command.

/server date
Displays the system clock of the game server.

/server stats
Displays various server totals for the last 24 hours or more days if you add a number.
eg./server stats 5 (gives you the last 5 days cummulative stats)

/new players {optional number (days)
List the new players and basic info about them in the last day or more.

/seen {player name}
Reports when the player was last on the server.

/rules
Reports the server rules.

Info Commands (In-Game Only):

/where
Gives info about where you are in the world and the rules that apply there.

/who {optional number distance}
Reports who is around you. Donors and staff can see distances.
Donors can see 300 metres and other players can see 200. New and watched players can't see staff near them.

/alert {message}
Whatever is typed after/alert is recorded to the database and displayed on irc.
You can recall the alerts with the irc command view alerts {optional days}

/info {player}
Displays info about a player. Only staff can specify a player. Players just see their own info.

/who visited {player name} days {days} hours {hrs} range {dist} height {ht}
See who visited a player location or base.
Example with defaults: /who visited player smeg days 1 hours 0 range 10 height 5
/who visited bed smeg
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.

Bot Commands:

These commands are for bot specific settings.

/clear whitelist
Remove everyone from the bot's whitelist.

/quick reset bot
Tell the bot to forget only some things, some player info, locations, bases etc. You will be asked to confirm this, answer with yes. Say anything else to abort.
Use this command after wiping the server. The bot will detect the day change and will ask if you want to reset the bot too.

/rejoin irc
Sometimes the bot can fall off IRC and fail to reconnect. This command forces it to reconnect.

/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.

/reset bot
/reset bot keep money
Tell the bot to forget only some things, some player info, locations, bases etc. You will be asked to confirm this, answer with yes. Say anything else to abort.
Use this command after wiping the server. The bot will detect the day change and will ask if you want to reset the bot too.

/restore backup
The bot saves its Lua tables daily at midnight (server time) and each time the server is shut down.
If the bot gets messed up, you can try to fix it with this command. Other timestamped backups are made before the bot is reset but you will first need to strip the date part off them to restore with this command.

/blacklist action ban (or exile or 'nothing')
Set what happens to blacklisted players. The default is to ban them 10 years but if you create a location called exile, the bot can bannish them to there instead. It acts like a prison.
To disable the blacklist, set action to the word nothing.
NOTE: If blacklist action is nothing, proxies won't trigger a ban or exile response either.

/set alert colour {hex code}
Set the colour of server alert messages.

/set chat colour {hex code}
Set the colour of server messages. Player chat will be the default colour.

/name bot {some cool name}
The default name is Bot. Help give your bot a personality by giving it a name.

/set bot restart {0+} (total bot days running)
The bot can automatically restart itself after running for days. The restart helps fix issues and keeps the bot fresh.
The default is 7 days between bot restarts. You can disable it by setting it to 0. Also it will only activate if bot restarts are enabled.

/set warn colour {hex code}
Set the colour of server warning messages.

/set command prefix / (or no symbol or any symbol except \ )
Change bot commands from using/ to using nothing or another symbol.

/set master password {secret password up to 50 characters}
Protect important commands such as/reset bot with a password.
This will prevent you or another server owner from accidentally doing something stupid (hopefully).
To remove it use/clear master password.

/set update branch
Bot updates are released in two branches, stable and testing. The stable branch will not update as often and should have less issues than testing.
New and trial features will release to testing before stable. Important fixes will be ported to stable from testing whenever possible.
You can switch between branches as often as you want. Any changes in testing that are not in stable will never break stable should you switch back to it.
/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.

/enable/disable bot restart
Using a launcher script or some other monitoring process you can have the bot automatically restart itself every time it terminates.
Periodically restarting the bot helps to keep it running at its best.
This feature is disabled by default. A restart script can be downloaded from http://botman.nz/shellscripts.zip
You will need to inspect and modify some paths in the scripts to match your setup.

/enable/disable updates (disabled by default)
Allow the bot to automatically update itself by downloading scripts. It will check daily, but you can also command it to check immediately with/update bot

/disable hacker tp detection
/enable hacker tp detection
Some mods or managers don't report legit teleports to telnet which breaks the bot's hacker teleport detection.
If the bot doesn't automatically disable/enable hacker tp detection, you can manually change it.

/enable/disable lag check (enabled by default)
Every 10 seconds while connected to the server, the bot sends a special lag check command to the server and times the response.
If the bot detects more than 10 seconds delay, it will automatically suspend several bot functions to reduce the number of commands that it sends to the server.
You can disable this check, but your bot won't pause for lag and the server could get significantly behind during busy times.

/update code
Make the bot check for script updates. They will be installed if you have set/enable updates

/whitelist all
You can add everyone except blacklisted players to the bot's whitelist.

Bot In-Game Only:

/no reset
If the bot detects that the server days have rolled back, it will ask you if you want to reset the bot. Type/no reset if you don't want the bot to reset itself.

/reset server
Tell the bot to forget everything it knows about the server. You will be asked to confirm this, answer with yes. Say anything else to abort.
Usually you only need to use/reset bot. This reset goes further.

Fun Commands:

/bounty {player name}
See the player kills and current bounty on a player's head.

/gimme gimme
/gimme peace
Make gimme messages appear in public chat or as private messages (with some exceptions).

/fix gimme
Force the bot to rescan the list of zombies and animals.

/reset gimmehell
Cancel a gimmehell game in progress.

/gimme raincheck {seconds}
Set a time delay between gimmes. The default is 0 seconds.

/gimme reset
Reset gimme counters for everyone so they can play gimme again. The bot does this every 2 hours automatically.

/gimme on/off
Enable/disable the gimme game.

/gimme zombies
/gimme no zombies
Allow or block zombies as gimme prizes.

/gimme reset time {number} (In minutes. Default is 120)
Reset everyone's gimme counter after (n) minutes.

Base Commands:

/delbase
/delbase {player name}
Tell the bot to forget about a base. Players can only remove their own bases.

/delbase2
/delbase2 {player name}
Tell the bot to forget about a base. Players can only remove their own bases.

/sethome (or sethome2)
/setbase (or setbase2)
Tell the bot where your first or second base is for base protection, raid alerting and the ability to teleport home.

/set base cooldown {number in seconds} (default is 2400 or 40 minutes)
The/base or/home command can have a time delay between uses. Donors wait half as long. If you set it to 0 there is no wait time.

/set base cost {number}
By default players can type/base to return to their base. You can set a delay and/or a cost before the command is available.

/set base size {number} {player name}
/set base2 size {number} {player name}
Set the base protection size for a player's first or second base.

/setbed
/clearbed
When you die, the bot can automatically return you to your first or second base.
Set within 50 metres of your base. The closest base will become your new spawn point after death.

/set default base size {number in metres or blocks}
The default base protection size is 32 blocks (64 diameter). This default only applies to new players joining the server for the first time.
Existing base sizes are not changed with this command.

/protect (or protect2)
Set up the bot's base protection. The bot will tell the player to move towards or away from their base and will
automatically set protection outside of their base protected area. Players should not set traps in this area.

/disable base protection
Base protection can be turned off server wide. Players can still use claim blocks for protection.
Not the same as/enable/disable pvp protect which is specifically for allowing the bot's base protection in PVP rules.

/enable/disable pvp protect
By default base protection is disabled where pvp rules apply. You can change that by enabling it.

/enable base (or home) teleport
/disable base (or home) teleport
Enable or disable the home or base teleport command (except for staff).

/unprotectbase {player name}
/unprotectbase2 {player name}
Disable base protection for a player.

Base In-Game Only:

/home (or base)
/home2 (or base2)
Teleport back to your first or second base. A timer and/or a cost may apply.

/pause
Pause your base protection.
Only works on your base(s) if you are within 100 metres of them and automatically resumes if you move away or leave the server.
This allows players who you haven't friended access to your base with you present.

/setbase {player name}
/sethome {player name}
Set a player's first base for them where you are standing.

/setbase2 {player name}
/sethome2 {player name}
Set a player's second base for them where you are standing.

/test base
Turn your own base protection against you for 30 seconds to test that it works.

/resume or unpause
Re-activate your base protection.

Admin Commands:

/admin add {player or steam or game ID} level {0-2}
/admin remove {player or steam or game ID}
Give a player admin status and a level, or take it away.
Server owners are level 0, admins are level 1 and moderators level 2. The bot does not currently recognise other admin levels.

Or 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.

/add/remove bad item {item}
Add or remove an item to/from the list of bad items. The default action is to timeout the player.
See also/ignore player {name} and/include player {name}

/add blacklist country {US}
/remove blacklist country {US}
Add or remove a country to/from the blacklist. Note: Use 2 letter country codes only.

/add donor {player name} level {0 to 7} expires {number} week or month or year
/remove donor {player name}
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.

/add restricted item {item name} qty {count} action {action} access {level}
/remove restricted item {item name}
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.

/add whitelist country {US}
/remove whitelist country {US}
Add or remove a country to/from the whitelist. Note: Use 2 letter country codes.

/arrest {player name}
/arrest {player name} reason {why arrested}
Send a player to prison. If the location prison does not exist they are temp-banned instead.

/ban {player name} (ban for 10 years with the reason 'banned')
/ban {player name} reason {reason for ban} (ban for 10 years with the reason you provided)
/ban {player name} time {number} hour or day or month or year reason {reason for ban}
/unban {player name}

/gblban {player name} reason {reason for ban}
Global bans are vetted before they become active. If the player is later caught hacking by a bot and they have pending global bans, a new active global ban is added automatically.
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'.

/block {name}
/unblock {name}
Block/Unblock a player from using any bot commands or command the bot from IRC.

/burn {player name}
Set a player on fire. It usually kills them.

/clear country blacklist
Remove all countries from the blacklist. (yay?)

/clear country whitelist
Remove all countries from the whitelist.

/cool {player name}
Cool a player or yourself if no name given.

/cure {player name}
Cure a player or yourself if no name given.

/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.

/exile {player name}
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 name}
Release the player from exile, however it does not return them. They can type/return or you can return them.

/give claim/key/lcb
The bot can despawn player placed claims in reset zones. This command is for them to request them back from the bot.
It will only return the number that it took away. If it isn't holding any, it won't give any back.

/give everyone {item} {amount} {quality}
Give everyone that is playing on the server right now an amount of an item. The default is to give 1 item.
If quality is not given, it will have a random quality for each player.
Anyone not currently playing will not receive the item.

/give player {joe} item {item} {amount} {quality}
/give player {joe} item {item} {amount} {quality} message {say something here}
Give a specific player amount of an item. The default is to give 1 item.
The player does not need to be on the server. They will receive the item and optional message when they next join.
You can give more items but only 1 item type per command. Items are given in the same order so you could include a message with the first item and they will read that first.

/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.

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

/heal {player name}
Apply big firstaid buff to a player or yourself if no name given.

/kick {Player name|Steam ID|Game ID} reason {optional reason}
Is Joe annoying you? Kick his ass right out of the server! >:D

/leave claims {player name}
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.

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

/bases (or homes)
/bases range {number}
/bases near {player name} 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.

/list blacklist
List the countries that are not allowed to play on the server.

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

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

/prisoners
List all the players who are prisoners.

/list staff (or admins)
Lists the server staff and shows who if any are playing.

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

/list whitelist
List the countries that are allowed to play on the server.

/load botman ini
Make the bot reload the botman.ini file. It only reloads when told to.

/mend {player name}
Remove the brokenLeg buff from a player or yourself if no name given.

/move {player name} 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.

/near {player name} {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 30 metres to the south. If you give a number after the player name you will be that number metres south of them.
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 or use any teleport command or relog.

/player {player name} 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.

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

/release {player name}
/just release {player name}
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

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

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

/remove claims {player name}
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.

/resettimers {player name}
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.

/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.

/return {player name}
/return {player name} 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.

/sendhome {player name} or/sendhome2 {player name}
Teleport a player to their first or second base.

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

/feral reboot delay {minutes}
Set how many minutes after day 7 that the bot will wait before rebooting if a reboot is scheduled for day 7.
To disable this feature, set it to 0. The bot will wait a full game day instead.

/max tracking days {days}
Set how many days to keep tracking data before deleting it. The default it 28.

/set return cooldown {seconds} (default 0)
You can add a delay to the return command. Does not affect staff.

/prisoner {player name} arrested {reason for arrest}
/prisoner {player name} (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.

/shit {player name}
Give a player the shits for shits and giggles.

/test as player
Remove your admin status for 5 minutes. It will be automatically restored.

/timeout {player name}
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 name} to fix that.
While in timeout, the player will not be able to use any bot commands but they can chat.

/disable (or enable) airdrop alert
By default the bot will inform players when an airdrop occurs near them. You can disable the message.

/disable (or enable) bounty
Normally a small bounty is awarded for a player's first pvp kill in pvp rules. You can disable the automatic bounty.
Players will still be able to manually place bounties, but those come out of their Zennies.

/disable (or enable) claim scan
Every 45 seconds the bot reads the claims of all ingame players. This can be a lot of data and could impact server performance.
If the bot is reporting server lag frequently, you can disable the timed claim scan.
It will still scan when a player leaves the server and can be commanded to do a scan.

/ignore/punish friendly pvp
By default if a player PVPs where the rules don't permit it, they can get jailed.
You can tell the bot to ignore friendly kills. Players must have friended the victim before the PVP occurs.

/block player {player name}
/unblock player {player name}
Prevent a player from using IRC. Other stuff may be blocked in the future.

/freeze/unfreeze {player name}
Bind a player to their current position. They get teleported back if they move.

/exclude/include admins
Normally the bot ignores admins when checking inventory and other stuff. If admins are included, all of the rules that apply to players will also apply to admins.
This is useful for testing the bot. You can also use/test as player (for 5 minutes)
This setting is not stored and will revert to excluding admins the next time the bot runs.

/ignore/include player {player name}
An ignored player can have uncraftable inventory and do hacker like activity such as teleporting and flying.
An included player is checked for these things and can be punished or temp banned for them.

/enable/disable pack/revive
Players can teleport close to where they last died to retrieve their pack.
You can disable the pack and revive commands. They are enabled by default.

/reserve/unreserve slot {player name}
Give a player the right to take a reserved slot when the server is full.
Reserved slots are auto assigned for donors and staff.

/disable (or enable) screamer alert
By default the bot will warn players when screamers are approaching. You can disable that warning.

/allow/disallow teleport {player name}
Allow or prevent a player from using any teleports. When disabled, they won't be able to teleport themselves, but they can still be teleported. Also physical teleports won't work for them.

/watch {player name}
/watch new players
/stop watching {player name}
/stop watching everyone
Flag a player or all current new players for extra attention and logging. New players are watched by default.

/enable/disable waypoints
Donors will be able to create, use and share waypoints. To enable them for other players, set waypoints public.

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

/warm {player name}
Warm a player or yourself if no name given.

/whitelist add/remove {player name}
Add (or remove) a player to the bot's whitelist. This is not the server's whitelist and it works differently.
It exempts the player from bot restrictions such as ping kicks and the country blacklist.

Hotspot Commands (in-game only):

/hotspot {message}
Create a hotspot at your current position with a message.

/delete hotspot {hotspot number from list}
Delete a hotspot by its number.

/delete hotspots {player name}
Players can only delete their own hotspots but admins can add a player name or id to delete the player's hotspots.

/hotspots {player name}
List your own hotspots. Admins can list another player's hotspots.

/move hotspot {hotspot number from list}
Move a hotspot to your current position.

/resize hotspot {hotspot number from list} size {size}
Change a hotspot's radius to a max of 10 (no max size for admins).
eg./resize hotspot 3 size 5. See/hotspots to get the list of hotspots.

/hotspot {hotspot number from list} action {action from list: pm, tele, drop, spawn}
/hotspot {hotspot number from list} action {action from list: pm, tele, drop, spawn}
NOTE: This command is not finished. Setting it won't do anything yet.
Change a hotspot's action. The deafault is to just pm the player but it can also teleport them somewhere, spawn something or buff/debuff the player.
eg./hotspot {number of hotspot} action {pm/tele/drop/spawn} {location name/spawn list}
If spawning items or entities use the format item name,quantity|item name,quantity|etc or entity id, entity id, entity id, etc

Reset Zone Commands:

Regions can be marked as reset zones to warn players not to build in them.
It will block setbase and sethome and any claims placed by players are removed.
Currently the bot does not have the ability to physically delete region files but it can provide a list of reset zones for manual deletion.

/clear reset zones
The bot will forget all the reset zones so you can start over marking new ones.

/reset zones
List all of the regions that are reset zones.

/add reset zone
/remove reset zone
Flag or unflag an entire region as a reset zone.

/fix shop
Attempt to automatically fix the shop. It reloads the shop categories, checks for any missing categories in shop items and assigns them to misc then reindexes the shop.
This fix is experimental and might not actually fix whatever is wrong with your shop.

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

/set/clear shop location {location name (for set only)}
Tie the shop to a location. Buying from the shop will only be possible while in that location (excluding admins).
Or clear the location so that the shop can be accessed server wide. (the default)

/set lottery multiplier {number}
Every zombie killed adds 1 x the lottery multiplier to the lottery total. The higher the number, the faster the lottery rises. The default is 2.

/set lottery prize {number}
You can set or reset the lottery prize to any number. Useful if it gets too large.

/set lottery ticket price {number}
The default cost of a lottery ticket is 25 Zennies. You can change it to anything above 0.

/set shop reset days {number}
Restock the shop to the max quantity of each item every {number} of real days.
A setting of 0 disables the automatic restock. To manually restock it use/reset shop.

/set shop open/close {0 - 23}
Enter a number from 0 to 23 which will be the game hour that the shop opens or closes.

/open/close lottery
/enable/disable lottery
Turn on or off the daily lottery.

/set playtime reward {Zennies}
Set how many Zennies a player earns for each minutes played. (excludes new players)

/set zombie reward {Zennies}
Set how many Zennies a player earns for each zombie killed.

/enable/disable bank
Players can earn Zennies if the bank is enabled.

/open/close shop
Enable or disable the shop feature.

/set money name {singular} {plural}
The default money name is the Zenny and the plural is Zennies. Both names must be one word each.
eg/set money name Chip Chips.

Tracker Commands:

/track {player name} session {number} (session is optional and defaults to the latest)
/next (track the next session)
/last (track the previous session)
Track the movements of a player. If a session is given, you will track their movements from that session.

/skip {number}
Skip {number} of steps. Instead of tracking each recorded step, you will skip {number} steps for faster but less precise tracking.

/speed {number>
The default pause between each tracked step is 3 seconds. Change it to any number of seconds from 1 to whatever.

/jump {number}
Jump forward {number} steps or backwards if given a negative number.

/goto start
Move to the start of the current track.

/goto end
Move to the end of the current track.

/stop
Stop tracking. Resume it with/go

/go
Resume tracking.

/stop tracking
Stops tracking and clears the tracking data from memory. This happens when you exit the server anyway so you don't have to do this.

Teleport Commands:

/tele {name} delete
Delete a teleport.

/enabletp {player name}
/disabletp {player name}
Allows a player to use teleport commands. Only staff can specify a player, otherwise it defaults to whoever issued the command.
Note: Players can set/unset this on themselves too.

/tele {name} enable
/tele {name} disable
Enable or disable a teleport.

/tele {name} one way
/tele {name} two way
Teleports are a pair of coordinates and the second coordinate placed is the destination.
You can make it work in one direction only or both ways (loop). They are two way teleports by default.

/tele {teleport name} private
/tele {teleport name} public
Make the teleport private or public. New teleports are private by default.

/tele {name} owner {player name}
Assign ownership of a teleport to a player. Only they and their friends can use it (and staff)

/set teleport cost {number}
Set a price for all private teleporting (excludes public locations). Players must have sufficient Zennies to teleport.

/set teleport delay {number}
Set a time delay for player initiated teleport commands. The player will see a PM informing them that their teleport will happen in x seconds. The default is 0 and no PM will be sent.

/tele {name} access min {minimum access level} max {maximum access level}
/tele {name} access min {minimum access level}
/tele {name} access max {maximum access level}
Set a player access level requirement to activate a teleport.
Teleports are not access level restricted by default and the min and max are both 0. Set them to 0 to remove an access restriction.
Note: Access levels are not player levels. See/help access
eg. To limit to donors/tele test access min 10. No need to set max as only admins are higher.
eg. To limit to new players/tele newbies access min 99 max 99.

/enable/disable p2p
Allow or block players teleporting to other players via shared waypoints or teleporting to friends.

/show/hide teleports
If bot commands are hidden from chat, you can have the bot announce whenever a player teleports to a location (except/home).

/enable/disable teleporting
Toggle ability of players using teleport commands. Admins can still teleport.

/enable/disable return (enabled is default)
After being teleported somewhere, players can type/return to be sent back to where they came from.
This is enabled by default but you can disable them. Admins are not affected by this setting.

/enable stuck
/disable stuck
Enable or disable the/stuck command.

/set pack cooldown {number in seconds}
By default players can type/pack when they respawn after a death to return to close to their pack. You can set a delay and/or a cost before the command is available after a death.

/set pack cost {number}
By default players can type/pack or/revive when they respawn after a death to return to close to their pack. You can set a delay and/or a cost before the command is available after a death.

Teleport In-Game Only:

/tp {player name}
/tp {X coord} {Y coord} {Z coord}
Teleport yourself to a player or to an coordinate.

/tele {name} end
Complete a teleport ending at your location or move an existing teleport's end to you.

/tele {name} start
Create a teleport starting at your location or move an existing teleport's start to you.

/teleports
List the teleports. Players can only see public teleports.

/pack
Teleport close to where you last died.

/return
Teleport back to where you came from before your last teleport command. Locations support a 2nd return if you teleport within the location more than once without leaving it.

/tele {name} end size {radius in blocks}
Set the size of the exit point of a pair of teleports. The default is 3 wide (1.5 radius)

/tele {name} start size {radius in blocks}
Set the size of the starting point of a pair of teleports. The default is 3 wide (1.5 radius)

/stuck
Teleport 2 metres up. If /stuck is repeated the bot will try to teleport you nearby.

Village Commands:

Villages work like protected bases except that they can have many players (villagers) and a mayor.
Just like a base, a village can have protection enabled. Villages work best when they are much larger than the area of the village so that an effective barrier against invading players exists.

/add member {player name} village {village}
Make a player a member of a village.

/elect {player name} village {village}
Elect a player as mayor of a village. Democratically of course :)

/villages (or villagers)
List villages or villagers.

/remove village {village}
Delete a village and everything associated with it.

/remove member {player name} village {village}
Remove a player from a village.

/village {village} size {metres}
Resize a village. Note that this removes village protection to prevent teleport loops.

/add village {village name}
Create a new village.

/protect village {village name}
Set village protection and follow the prompt from the bot, just like setting base protection.

/unprotect village {village name}
Remove protection on a village.

Waypoint Commands:

Waypoints are player managed personal teleports.
You can specify how many waypoints individuals or groups of players can have and apply other restrictions on their use.
Pairs of waypoints can be linked to create a portal. Portals differ in that the player steps into them to activate them.
Waypoints can be shared with a players friends and they can step into their portals as well. Portals can be unlinked which reverts them to waypoints.

/clear all waypoints {optional player name}
Delete all your waypoints (anyone can do this) or those of a named player (only admins)

/waypoints {player name} (list a player's waypoints)
/waypoints range {distance} (list all waypoints within range of your position)
/waypoints near {player or location} range {distance} (list all waypoints within range of a player or location)
List the waypoints of a player or within {distance} of your current position or the location of another player or location.

/set max waypoints {number} (server wide)
/set max waypoints {player name} number {number} (for a specific player)
/set max waypoints donors {number} (for donors)
Set the max number of waypoints players can have or a specific player can have.

/set waypoint cooldown {number} (seconds)
Set how long in seconds players must wait between uses of waypoints

/set waypoint cost {number}
Set a price to use waypoints. Players must have sufficient Zennies to teleport.

/set waypoint create cost {number}
Set a price to create waypoints. Players must have sufficient Zennies

/set waypoints public/private
Make waypoints accessible to all (except new players) or restricted to donors only.

Waypoint Commands (In-Game Only):

/clear wp {name}
Delete a named waypoint. If they are linked, this also unlinks them.

/close wp {waypoint name}
Make a waypoint private again. This is its default state.

/set wp {waypoint name}
Create or move your first waypoint where you are standing. It retains its current status if it already exists.

/link wp {name of wp1} to {name of wp2}
Link your waypoints to create a portal instead. In this mode you cannot teleport to them, instead you activate them by stepping into them.

/unlink wp {name of waypoint}
Close your portal and convert each end back into two waypoints which you can then teleport to as normal.

/wp or/wp1 or/{your name}
Teleport to your first waypoint.

Location Commands:

/lobby {player name}
If the lobby location exists, send the player to it. You can also do this to offline players, they will be moved to the lobby when they rejoin.

/location clear reset {location name}
Remove the reset zone flag. Unless otherwise restricted, players will be allowed to place claims and setbase.

/location set reset {name}
Flag the location as a reset zone. The bot will warn players not to build in it and will block/setbase and will remove placed claims of non-staff.

/location remove {name}
Delete the location and all of its spawnpoints.

/location allow base {location name}
/location disallow/deny/block base {location name}
Allow players to/setbase in the location or block that.

/location enable/disable {name}
Flag the location as enabled or disabled. Currently this flag isn't used and you can ignore this command.

/location {name} pvp
/location {name} pve
Change the rules at a location to pvp or pve.

/location private/public {name} (default is private)
Flag the location as private or public. Players can only use public locations.

/location safe/unsafe {location name}
Flag/unflag the location as a safe zone. The bot will automatically kill zombies in the location if players are in it.
To prevent this feature spamming the server it is triggered every 30 seconds. When there are more than 10 players it changes to every minute.
If you have StompyNZ's Bad Company mod, the bot will instantly despawn zombies that spawn inside the zone. Walk-in zombies are detected as above.

/show/hide locations
Normally when you enter and leave a location you will see a private message informing you of this.
You can disable this message.

/location {name} enable (or disable) returns
Enable or disable the return command for a location.

/location {name} enable (or disable) waypoints
Block or allow players to set waypoints in the location.

/location {name} access {minimum access level}
Set the minimum access level required to teleport to the location.

/location {name} close {0-23}
Block and remove players from the location from a set hour.

/location {name} cost {number}
Require the player to have {number} Zennies to teleport there. The Zennies are removed from the player afterwards.

/location {name} day closed {0-7}
Block and remove players from the location on a set day. 7 = day 7

/location {name} minigame {game type}
Flag the location as part of a minigame such as capture the flag. The minigame is an unfinished idea so this command doesn't do much yet.

/location {name} open {0-23}
Allow players inside the location from a set hour.

/location owner {player name}
Assign ownership of a location to a player. They will be able to set protect on it and players not friended to them won't be able to teleport there.

/location {name} min level {minimum player level}
/location {name} max level {maximum player level}
/location {name} min level {minimum player level} max level {maximum player level}
Set a player level requirement to teleport to a location.

/location {name} size {number}
Set the size of the location measured from its centre. To make a 200 metre location set it to 100.

Location In-Game Only:

/location add {name}
Create a location where you are standing. Unless you add random spawns, any player teleporting to the location will arrive at your current position. If you are not on the ground, make sure the players can survive the landing.

/locations
List the locations and basic info about them.

/location {name} ends here
Set the size of the location as the difference between your position and the centre of the location. Handy for setting it visually.

/location {name}
See detailed information about a location including a list of players currently in it.

/location {name} random
Start setting random spawn points for the location. The bot uses your position which it samples every 3 seconds or so. It only records a new coordinate when you have moved more than 2 metres from the last recorded spot.
Unless you intend players to fall, do not fly or clip through objects while recording. To stop recording just type stop.
You can record random spawns anywhere and more than once but remember to type stop after each recording or the bot will continue recording your movement and making spawn points from them.
The spawns do not have to be inside the location and you can make groups of spawns anywhere in the world for the location.

/location move {name}
Move an existing location to where you are standing. Unless you add random spawns, any player teleporting to the location will arrive at your current position.
If you are not on the ground, make sure the players can survive the landing. If there are existing random spawns for the location, moving it will not move them.
You should clear them and redo them using/location {name} clear and/location {name} random.

/protect location
Tell the bot to protect the location that you are in. It will instruct you what to do and will tell you when the location is protected.

/set tp {optional location}
Create a single random teleport for the location you are in or if you are recording random teleports, it will set for that location.
If you provide a location name you will create 1 random TP for that location where you are standing.

/unprotect location {optional name}
Remove bot protection from the location. You can leave out the location name if you are in the location.

Server Commands:

/cancel reboot
Cancel a scheduled reboot.
You may not be able to stop a forced or automatically scheduled reboot but you can pause it instead.

/join server {ip} port {telnet port} pass {telnet password}
Tell the bot to join a different game server. If the bot does not find the server, it will automatically return after 5 minutes.

/pause reboot
Pause a scheduled reboot.
It will stay paused until you unpause it or restart the bot.

/run command {a console command}
Sometimes you need to make the bot run a specific console command.
This can be used to force the bot re-parse a list.
Only server owners can do this.

/reboot
or/reboot {n} minute (or hour) (optional: forced)
or/reboot now
Schedule a timed or immediate server reboot. The actual restart must be handled externally by something else.
Just before the reboot happens, the bot issues a save command. If you add forced, only a level 0 admin can stop the reboot.
Shutting down the bot will also cancel a reboot but any automatic (timed) reboots will reschedule if the server wasn't also restarted.

/override access {number from 99 to 4}
All players have an access level which governs what they can do. You can override it for everyone to temporarily raise their access.
eg./overide access 10 would make all players donors until you restore it. To do that type/override access 99. This is faster than giving individual players donor access if you just want to do a free donor weekend.

/set bail {number}
Set how many Zennies it costs to bail out of prison.
To disable bail set it to zero (the default)

/motd
/motd (or/set motd) {your message here}
/motd clear
Display the current message of the day. If an admin types anything after/motd the typed text becomes the new MOTD.
To remove it type/motd clear

/set irc main (or alerts or watch) {channel name without a # sign}
Change the bot's IRC channels.

/set irc nick {bot name}
Change the bot's IRC nickname. Sometimes it can have a nick collision with itself and it gets an underscore appended to it.

/set irc server {IP or URL and optional port}
Use this command if you want players to know your IRC server's address.

/set map size {number}
Set the maximum distance from 0,0 that players are allowed to travel. Any players already outside this limit will be teleported to 0,0 and may get stuck under the map. They can relog.
Size is in metres (blocks) and be careful not to set it too small. The default map size is 10000 but the bot's default is 20000.
Whatever size you set, donors will be able to travel 5km futher out so the true boundary is +5000.

/set max animals {number}
Change the server's max spawned animals.

/set (or clear) max ping {number}
To kick high ping players set a max ping. It will only be applied to new players. You can also whitelist a new player to make them exempt.
The bot doesn't immediately kick for high ping, it samples ping over 30 seconds and will only kick for a sustained high ping.

/set max players {number}
Change the server's max players. Admins can always join using the automated reserved slots feature.

info:/max uptime
set:/set max uptime {number}
Set how long (in hours) that the server can be running before the bot schedules a reboot. The bot will always add 15 minutes as the reboot is only scheduled at that time.

/set max zombies {number}
Change the server's max spawned zombies.

info:/new player timer
set:/set new player timer {number} (in minutes)
By default a new player is treated differently from regulars and has some restrictions placed on them mainly concerning inventory.
Set it to 0 to disable this feature.

/set overstack {number} (default 1000)
Sets the maximum stack size before the bot will warn a player about overstacking. Usually the bot learns this directly from the server as stack sizes are exceeded.

/set ping kick target {new or all}
By default if a ping kick is set it only applies to new players. Set to all to have it applied to everyone.
Note: Does not apply to exempt players which includes admins, donors and individuals that have been bot whitelisted.

/set prison timer {number} (in minutes)
Set how long someone stays in prison when jailed by the bot.
To not have a time limit, set this to 0 which is the default.

/set pvp cooldown {seconds}
Set how long after a pvp kill before the player can use teleport commands again.

/set reserved slots {number of slots}
You can have a number of server slots reserved for admins and selected players.
Anyone can join but if the server becomes full, players who aren't staff or allowed to reserve a slot will be randomly selected and kicked if an admin or authorised player joins.
To disable, set reserved slots to 0.

/set rolling delay {minutes}
Set the delay in minutes between rolling announcements.
/set rules {new rules}
Set the server rules. You can use supported bbcode tags, but only when setting the rules from IRC. Each tag must be closed with this tag [-] or colours will bleed into the next line.
To display the rules type/rules

/set server api {api key from 7daystodie-servers.com}
Your API key is not recorded in logs or the databases and no bot command reports it.
Your server API key is used to determine if a player has voted for your server today.

/set server group {group name} (one word)
This is used by the bots database which could be a cloud database. It is used to identify this bot as belonging to a group if you have more than one server. You do not need to set this.

/set server ip {IP of your 7 Days to Die server}
The bot is unable to read the IP from its own profile for the server so enter it here. It will display in the/info command and be used if a few other places.

/set reboot hour {0 to 23}
Reboot the server when the server time matches the hour (24 hour time)
To disable clock based reboots set this to -1 or don't enter a number.

/set reboot minute {0 to 59}
Reboot the server when the server time matches the hour and minute (24 hour time)
To disable clock based reboots use/set reboot hour (without a number)

/set server pve (or pvp, creative or contest)
Set the entire server to be PVE, PVP, Creative or Contest.
Contest mode is not implemented yet and all setting it creative does is stop the bot pestering players about their inventory.

/setup map
Optional extras after setup map: no hostiles, no animals, show players, show claims, show inventory
eg./setup map no hostiles no animals show players show claims show inventory

The bot can fix your server map's permissions with some nice settings. If you use this command, the following permissions are set:
web.map 2000
webapi.getlandclaims 1000
webapi.viewallplayers 2
webapi.viewallclaims 2
webapi.getplayerinventory 2
webapi.getplayerslocation 2
webapi.getplayersOnline 2000
webapi.getstats 2000
webapi.gethostilelocation 2000
webapi.getanimalslocation 2000

If setting no hostiles and/or no animals:
webapi.gethostilelocation 2
webapi.getanimalslocation 2

If setting show players, show claims, show inventory:
webapi.viewallplayers 2000
webapi.viewallclaims 2000
webapi.getplayerinventory 2000
/set website {your website or steam group}
Tell the bot the URL of your website or steam group so your players can ask for it.

/set (or clear) welcome message {your message here}
You can set a custom welcome message that will override the default greeting message when a player joins.

/allow/disallow/kick bad names
Auto-kick players with numeric names or names that contain no letters such as ascii art crap.
They will see a kick message asking them to change their name.

/set cbsm friendly (the default)
/set cbsm unfriendly
If set to friendly, the bot will automatically switch from/ commands to using the ! since CBSM uses the/
Set to anything else and the bot will use/ commands whether CBSM is present or not.

/enable/disable entity scan (disabled by default)
Scan for entities server wide every 30 seconds.
The resulting list is copied to the entities Lua table where it can be further processed for other bot features.

/enable/disable error scan (disabled by default)
The bot can automatically scan for and fix some errors using console commands.
The scan happens automatically every 2 minutes. You can disable the scan if you suspect it is creating lag.

/enable/disable hardcore mode
Allow players to use bot commands. This is the default.
Players can still talk to the bot and use info commands such as/rules.

/enable/disable idle kick (disabled is default)
When the server is full, if idle kick is on players will get kick warnings for 15 minutes of no movement then they get kicked.

/allow/disallow flying
Toggle the bot's player flying detection. You would want to do this if players can use debug mode on your server.

/set irc private/public
If IRC is private, the bot won't share the url or info with players and players can't invite anyone to irc using the invite command.
When public, players can find the IRC info with/help irc and they can create irc invites for themselves and others.

/enable noclip scan (the default)
/disable noclip scan
Using Coppi's mod version 2.5+ you can detect players that are noclipping under the map.
It can false flag but it is still a useful early warning of a possible hacker. Currently this feature only alerts to IRC. It does not punish.

/allow/disallow overstack
/enable/disable overstack
By default the bot reads overstack warnings coming from the server to learn what the stack limits are and it will pester players with excessive stack sizes and can send them to timeout for non-compliance.
Use this command to toggle this feature

/northeast pve/pvp
/northwest pve/pvp
/southeast pve/pvp
/southwest pve/pvp
/north pve/pvp
/south pve/pvp
/east pve/pvp
/west pve/pvp
Make northeast/northwest/southeast/southwest/north/south/east/west of 0,0 PVE or PVP.

/allow/disallow rapid relog
New players who want to cheat often relog rapidly in order to spawn lots of items into the server using cheats or bugs.
If enabled, the bot will temp ban (10 minutes) players caught relogging several times in short order.

/enable/disable region pm
A PM for admins that tells them the region name when they move to a new region.

/enable (or disable) reboot
By default the bot does not manage server reboots.
See also/set max uptime (default 12 hours)

/disable watch alerts
/enable watch alerts
Enable or disable ingame private messages about watched player inventory and base raiding. Alerts will still go to IRC.

/unpause (or resume) reboot
Resume a reboot.

Coppi's Mod Commands:

/mute {player name}
/unmute {player name}
Prevent a player using text chat or allow them to chat.

/spawn horde {optional player or location name} {number of zombies}
Spawn a horde around a player or location or at a marked coordinate. See/set horde.

/hide commands
/show commands
Hide commands from ingame chat which makes them all PM's or show them which makes them public.

/set new player/player/donor/prisoner/mod/admin/owner chat colour FFFFFF
/reset chat colour
To disable automatic chat colouring, set it to white which is FFFFFF
Set the default chat colour for a class of player. You can also set chat colour for a named player.
eg./set player joe chat colour B0E0E6
To reset everyone to white type/reset chat colour

/make maze
Optional parts: wall {block name} fill {air block} width {number} length {number} height {number} x {x coord} y {y coord} z {z coord}
Default values: wall steelBlock fill air width 20 length 20 height 3. It uses your current position for x, y and z if not given.
Generate and build a random maze.
It is very slow and someone must stay with it or it won't work. Cancel it with/stop maze

/stop maze
Aborts any maze(s) that you have told the bot to create.

/set/clear horde
Marks your current position to spawn a horde ther with/spawn horde.
Clear horde doesn't remove the horde. It only clears the saved coordinate.

/add prefab {name}
You can copy an area of blocks to later recall them or to fill the area with a block.
This requires the latest Coppi's Additions and are not currently in Alloc's Mod. You can give it any name but you can't reuse a name that is already defined by you.

/undo
The block commands prender, pdup and pblock allow for the last command to be undone, however since more than one person can command the bot to do block commands
it is possible that other block commands have been done by the bot since your last block command. If the last block command came from you, the bot will undo it.

/list saves {optional player name}
List all your saved prefabs or those of someone else. This list is coordinate pairs of places in the world that you have marked for some block command.
You can use a named save with the block commands.

/mark {name} start
/mark {name} end
Mark two opposite corners of the area you wish to copy. Move up or down between corners to add volume.

/save {name}
Now that you have marked out the area you want to copy, you can save it.

/load prefab {name} at {x} {y} {z} face {0-3}
Everything after the prefab name is optional and if not given, the stored coords and rotation will be used.
Restore a saved prefab in place or place it somewhere else.
If you provide coords and an optional rotation (default is 0 - north), you will make a new copy of the prefab at those coords.
If you instead add here, it will load on your current position with optional rotation.
If you only provide the name of the saved prefab, it will restore the prefab in place which replaces the original with the copy.
For perfect placement, start from a south corner.

/list (or/li) {partial name of an item or block}
List all items containing the text you are searching for.

/move block {name of saved prefab} here
/move block {name of saved prefab} {x} {y} {z}
/move block {name of saved prefab} up (or down) {number}
Fills a saved block with air then renders it at the new position and updates the block's coordinates.

/copy block {name of saved prefab} here
/copy block {name of saved prefab} {x} {y} {z}
Renders a saved block at your position or the coordinates you specify

/rotate (or/spin) block {name of saved prefab}
Spins a block around its first XYZ

/rotate (or/spin) block {name of saved prefab}
Spins a block around its first XYZ

/set mark {optional player}
Temp store your current position for use in block commands which you use later. It is only stored in memory.
If you add a player name it will record their current position instead.

/set p1
Temp store your current position for use in block commands which you use later. It is only stored in memory.

/set p2
Temp store your current position for use in block commands which you use later. It is only stored in memory.

/erase {optional number} (default 5)
Replace an area around you with air blocks. Add a number to change the size. Default is 5.

/dig (or fill) {optional number} (default 5)
Dig a hole or fill a hole. Default is 5.
This can also be used to make tunnels and walls.
When not digging or filling up or down, a compass direction is needed (north, south, east, west)
There are several optional parts, wide, block, tall, base and long.
Default block is air, base is at your feet and the others default to 5.
Examples:
/dig north wide 3 tall 3 long 100
/dig bedrock wide 1
/dig up (makes a 5x5 room)
/dig up (or room) wide 5 tall 10 (makes a 10x10 room)
/fill east base 70 wide 2 tall 10 long 50 block steelBlock
/fill bedrock wide 2 block 1

You can repeat the last command with/again and change direction with/again west

/fix bedrock {distance}
You can replace the bedrock layer below you up to {distance} away from your position.
You only need to be over the area to be fixed. No other layers are touched.

/fill {name of saved prefab} {block ID} face {north, south, east, west or n, s, e, w}
Now that you have marked out the area you replace every block with 1 type of block.
eg./fill wall 8 south (default facing is north. 8 is the block id for sand.)