Server Commands

Updated 17 August, 2017

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.


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

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

/set irc server
Use this command if you want players to know your IRC server's address.

/set irc main (or alerts, watch or tracker)
Change the bot's IRC channels. Note that the bot can only reside in the main channel which is currently hard-coded in Mudlet. If the bot is not in the channel you set here, you will have to /msg the bot or issue all commands in private chat with the bot.

/reboot
or /reboot 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 it.
Shutting down the bot will also cancel a reboot but any automatic (timed) reboots will reschedule if the server wasn't also restarted.

/set prison size
Depreciated. Use /location prison size

/set map size
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 base cooldown (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.

/motd
/motd (or /set motd)
/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 rules
Set the server rules. You can use supported bbcode tags, but only when setting the rules from IRC. All tags must be closed with [-].
To display the rules type /rules

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

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

/unpause (or resume) reboot
Resume a reboot.

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

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

/set chat colour
Set the colour of server messages. Player chat will be the default colour.

/set warn colour
Set the colour of server warning messages.

/set alert colour
Set the colour of server alert messages.

/set website
Tell the bot the URL of your website or steam group so your players can ask for it.

/set server ip
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 (or clear) max ping
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 (or clear) welcome message
You can set a custom welcome message that will override the default greeting message when a player joins.

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

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

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

/allow bad names
Allow numeric names or names that contain no letters such as ascii art.

/set max zombies
Change the server's max spawned zombies.

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

/set max animals
Change the server's max spawned animals.

info: /max uptime
set: /set max uptime
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.

info: /new player timer
set: /set new player timer (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 server group (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.

/allow 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 disable this feature

/disallow overstack
The bot will warn players that are overstacking and will eventually send them to timeout if they continue overstacking.

/blacklist action ban (or exile)
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.

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

/setup map
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

/northeast pve (or pvp)
Make northeast of 0,0 PVE or PVP.

/northwest pve (or pvp)
Make northwest of 0,0 PVE or PVP.

/southeast pve (or pvp)
Make southeast of 0,0 PVE or PVP.

/southwest pve (or pvp)
Make southwest of 0,0 PVE or PVP.

/north pve (or pvp)
Make north of 0,0 PVE or PVP.

/south pve (or pvp)
Make south of 0,0 PVE or PVP.

/east pve (or pvp)
Make east of 0,0 PVE or PVP.

/west pve (or pvp)
Make west of 0,0 PVE or PVP.

/allow flying
This disables the bot's hacker teleport detection. You would want to do this if you allow creative mode or at least allow players to fly.

/disallow flying
This enables the bot's hacker teleport detection.

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

/disable base protection
Base protection can be turned off server wide. It does not make sense to use base protection on a PVP server. Also it is not available anywhere that is set as a PVP zone on any server.

/enable base protection
Base protection is available by default but a player needs to set theirs up to use it.

/set pack cost
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 cooldown
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 base cost
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.

/enable bank
Enable Zennies and the bank. Zombie kills will earn Zennies and the shop and gambling will be available if also enabled.

/disable bank
You can disable Zennies and the bank. Zombie kills won't earn anything and the shop and gambling won't be available.

/set overstack (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.

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

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

/open lottery
Enable the daily lottery if it is currently disabled.

/close lottery
You can disable the lottery while keeping the shop and Zennies in the game.

/set lottery multiplier
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 zombie reward
Set how many Zennies a player earns for each zombie killed.

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

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

/disable teleporting
Set this if you do not want your players using teleport commands. Admins can still teleport.

/enable teleporting
Set this if you want your players using teleport commands. This is the default.

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

/disable hardcore mode
Allow players to use bot commands. This is the default.

/enable hardcore mode
Don't let players use any bot commands. Does not affect admins.

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

/allow 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.
This command makes the bot ignore these and do nothing to stop them.

/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.
This command makes the bot temp ban new players found to be relogging many times less than a minute apart.

/idle kick on (off 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.

/irc private (or /irc 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.

/set money name
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.

/set default base size
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.

/set reserved 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 bail
Set how many Zennies it costs to bail out of prison.
To disable bail set it to zero (the default)

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

/enable returns (the default)
/disable returns
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 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.

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

/enable entity scan
/disable entity scan (the 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.

/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 cbsm friendly
/set cbsm unfriendly
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)

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

/enable/disable updates
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

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

/set rolling delay
Set the delay in minutes between rolling announcements.


Server In-Game Only:

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

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

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

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