Botman Commands
This command help is taken directly from the bot with some edits and formatting added. It is not a manual but you will learn a lot just exploring this text. Note that each bot generates its own copy of this document which will always be 100% accurate for you bot. It will reflect changes such as using whatever you have assigned for your bot's command prefix and any custom changes to command access levels that you have made.
This command help is also available as a downloadable PDF document here.
Found a broken command? Need a command/function or feature added? Let me know. I fix stuff :D
This document begins with in-game chat commands. Each command is listed with the command prefix (a slash in this case) followed by the command, then a description and ending with a note about any command restrictions that apply.
Some command restrictions are listed as an access code eg ACL: 2 Here is a table of these codes and their meaning.
If a player's access level is too low, they will not be able to use the command. A player can use all commands that are at or below their access level. For example an admin with ACL: 1 cannot do ACL: 0 commands but can do all commands in ACL 1, 2, 3, 90 and 99. Commands that every player can use are listed as unrestricted.
Command Access Levels
Access levels control who can do what. Commands that are above a players level return unknown command.
Level 0 server owners
Level 1 admins
Level 2 mods
Level 3 - 89 custom admin levels
Level 90 Regular players
Level 99 New players
Info Commands:
Info commands show players information about specific things such as rules, when the next horde night is, etc.
/bot info
Displays info about the bot.
Unrestricted command, in-game only
/uptime
Reports the bot and server's running times.
Unrestricted command, in-game and IRC
/server or /info
Displays info mostly from the server config.
Unrestricted command, in-game only
/next reboot
Reports the time remaining before the next scheduled reboot.
Unrestricted command, in-game and IRC
/day7 or /when feral or /bloodmoon
Reports the number of days remaining until the next horde night.
Unrestricted command, in-game and IRC
/fps
Displays the most recent output from the server mem command.
Unrestricted command, in-game and IRC
/server date
Displays the system clock of the game server.
Unrestricted command, in-game and IRC
/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)
Unrestricted command, in-game and IRC
/new players {optional number (days)
List the new players and basic info about them in the last day or more.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/seen {player name}
Reports when the player was last on the server.
Unrestricted command, in-game and IRC
/rules
Reports the server rules.
Unrestricted command, in-game and IRC
/where
Gives info about where you are in the world and the rules that apply there.
Unrestricted command, in-game only
/who {optional number distance}
Donors can see 300 metres and other players can see 200. New and watched players can't see staff near them.
Unrestricted command, in-game only
/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}
Unrestricted command, in-game only
/info {player}
Displays info about a player. Only staff can specify a player. Players just see their own info.
Unrestricted command, in-game only
/who visited player {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.
Unrestricted command, in-game only
Base Commands:
Base commands includes commands for admins to set various restrictions on players using base commands and commands for players to set and protect their base(s).
/delbase {number or name of base}
Or /delbase player {player name} base {number or name of base} (for admins only) or
Or /delbase player {player name} (for admins only)
Delete a player's base and base protection (in the bot only). It does not physically delete the base in the game world.
Players can only delete their own bases.
If admins specify a player but do not specify a base, the nearest base owned by that player is deleted.
Unrestricted command, in-game and IRC
/list bases
Or /list bases {player name} (admins only)
See a numbered list of all of your bases.
Admins can list any player's bases by including a game id, steam id, or name.
Unrestricted command, in-game and IRC
/add (or /remove) base {number or name of base} member {player name}
Add or remove a player as a member of one of your bases.
You do not need to /friend them.
Only you and the base members are allowed in the base when base protection is set.
Your friends can't enter the base unless they are members or no members are assigned.
To remove all base members use /clear base members {number or name of base}
Unrestricted command, in-game and IRC
/clear base members {number or name of base}
Remove all members from the specified base.
Unrestricted command, in-game and IRC
/list base members {number or name of base}
List all members of the specified base.
Unrestricted command, in-game and IRC
/name base {number} {name}
Give one of your bases a name or change its name.
Unrestricted command, in-game and IRC
/set base cooldown {number in seconds} (default is 2400 or 40 minutes)
The /base and /home command can have a time delay between uses. If you set it to 0 there is no wait time.
ACL: 1 restricted to owners and admins, in-game and IRC
/set setbase cooldown {number in seconds} (default is 0)
The /setbase and /sethome command can have a time delay between uses. This hampers abuse of the command to locate hidden bases.
Note this cooldown is not the base cooldown timer.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set base deadzone {distance}
Block players setting their base too close to the base of another player who has not friended them.
The default is 0 which disables this feature. It does not remove existing bases that are closer than the distance you set here, but they will not be able to redo /setbase unless they move further away.
ACL: 0 restricted to server owners, in-game and IRC
/set base {base number} size {number} player {player name}
Set the base protection size for a player's base.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/setbed (or /clearbed)
When you die, the bot can automatically return you to your first or second base after respawn.
Set within 50 metres of your base. The closest base will become your new spawn point after death.
Unrestricted command, in-game only
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set max bases {number}
By default players can set one base with the bot. This setting applies to every player that is not a member of a group.
ACL: 0 restricted to server owners, in-game and IRC
/set max protected bases {number}
By default players can protect one base. This setting applies to every player that is not a member of a group.
ACL: 0 restricted to server owners, in-game and IRC
/base {number or name of base} private (or public)
Your friends can visit your bases unless you make them private.
Private bases can only be visited by you and its base members.
To keep everyone out; protect the base, make it private and don't add any members.
Unrestricted command, in-game and IRC
/enable (or /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.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) pvp protect
By default base protection is disabled where pvp rules apply. You can change that by enabling it.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) base (or home) teleport
Enable or disable the home or base teleport command (except for staff).
ACL: 1 restricted to owners and admins, in-game and IRC
/unprotectbase {number or base name} (optional)
Or /unprotect base {number or base name} (optional)
Or /unprotectbase player {player name} (admins only - unprotect nearest base owned by a specific player)
Or /unprotectbase player {player name} bases (admins only - unprotect all bases owned by a specific player)
Or /unprotectbase player {player name} base {number or name} (admins only - unprotect a specific player's base)
Disable base protection.
The nearest owned base will be unprotected unless you specify a base number or name.
Unrestricted command, in-game and IRC
Base Commands (In-Game Only):
/home (or /base) {number or name}
Teleport back to your base. A timer and/or a cost may apply.
If you have more than one base use the base number or name otherwise you will go to your first base.
Unrestricted command, in-game only
/pause (pause your nearest base)
Or /pause {number or name of base} (pause a specific base)
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.
Unrestricted command, in-game only
/test base (test your nearest base)
Or /test base {number or name} (test a specific base)
Turn your own base protection against you for 30 seconds to test that it works.
Unrestricted command, in-game only
/protect
Or /protect {number or name of base}
Or /protect player {player id or name} (admins only)
Or /protect player {player id or name} base {number or name of base} (admins only)
Set up the bot base protection. The bot will tell you to move towards or away from the base and will
automatically set protection outside of the base protected area. Do not set traps for players at the exit point.
If no base is given, the bot will look for your nearest base.
You should be inside or very close to the base when using this command.
Unrestricted command, in-game only
/resume (or /unpause) (resume your nearest base protection)
Or /resume (or /unpause) {number or name of base} (resume a specific base)
Re-activate your base protection.
Unrestricted command, in-game only
/sethome (or /setbase) {optional number or name}
Tell the bot where your base is for base protection, raid alerting and the ability to teleport home.
Unrestricted command, in-game only
/setplayerbase (or /setplayerhome) {player name}
Set a player's first base for them where you are standing.
ACL: 2 restricted to owners, admins and mods, in-game only
Location Commands:
A location is usually a teleport destination. They can be configured for many purposes.
You can find more information about locations in the following guide.
https://files.botman.nz/guides/Locations_Noobie_Guide.pdf
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/location categories
List the location categories. Only admins see the access level restrictions
Unrestricted command, in-game only
/locations
List the locations and basic info about them.
Unrestricted command, in-game only
/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.
If location spawn exists and lobby does not, spawn is the lobby location.
If a location has been assigned as the lobby and there isn't a location called lobby or spawn, it will be used instead.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location clear reset {location name}
Remove the reset zone flag. Unless otherwise restricted, players will be allowed to place claims and setbase.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} clear
Delete all random spawns for the location.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 1 restricted to owners and admins, in-game only
/location remove {name}
Delete the location and all of its spawnpoints.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {old name} rename {new name}
Change an existing location's name to something else.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} category {category name}
/location {name} clear category
Set or clear a category for a location. If the category doesn't exist it is created.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} access {minimum access level}
Set the minimum access level required to teleport to the location.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} close {0-23}
Block and remove players from the location from a set hour.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set location {name} cooldown {number in seconds}
After teleporting to the location, players won't be able to teleport back to it until the cooldown timer expires.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} cost {number}
Require the player to have {number} Zennies to teleport there. The Zennies are removed from the player afterwards.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} day closed {number}
Block and remove players from the location on a set day. Disable this feature by setting it to 0.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} open {0-23}
Allow players inside the location from a set hour.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} 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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} min level {minimum player level}
Or /location {name} max level {maximum player level}
Or /location {name} min level {minimum player level} max level {maximum player level}
Set a player level requirement to teleport to a location.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location {name} size {number}
Set the size of the location measured from its centre. To make a 200 metre location set it to 100.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/location allow base {location name}
Or /location (disallow or deny or block) base {location name}
Allow players to /setbase in the location or block that.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/location enable (or disable) {name}
Flag the location as enabled or disabled. Currently this flag isn't used and you can ignore this command.
ACL: 1 restricted to owners and admins, in-game and IRC
/location hide/unhide {name}
Flag the location as hidden or unhidden. Hidden locations are only shown to admins when using the /locations command.
ACL: 1 restricted to owners and admins, in-game and IRC
/location lobby/not lobby {name}
Flag the location as the lobby or not the lobby. New players will be sent to this location when they spawn if it is flagged as lobby. Only one location will be used so flagging more will not make them all the lobby.
To do that use /set tp {location}. This will add a random teleport destination for the location. You can set as many as you want.
ACL: 1 restricted to owners and admins, in-game and IRC
/location (round or circle or square) {name}
Locations are circles by default with a central coord and a radius. You can make the location a square (with equal sides).
The location's size is always its radius.
ACL: 1 restricted to owners and admins, in-game and IRC
/location p2p enable (or disable) {name} (default is enabled)
When disabled, players will not be able to teleport to friends or fetch friends in the location.
ACL: 1 restricted to owners and admins, in-game and IRC
/location pack enable (or disable) {name} (default is enabled)
When disabled, the /pack command will not work if the player died inside the location.
ACL: 1 restricted to owners and admins, in-game and IRC
/location private (or public) {name} (default is private)
Flag the location as private or public. Players can only use public locations.
ACL: 1 restricted to owners and admins, in-game and IRC
/location {name} pvp
/location {name} pve
Change the rules at a location to pvp or pve.
ACL: 1 restricted to owners and admins, in-game and IRC
/location {name} enable (or disable) returns
Enable or disable the return command for a location.
ACL: 1 restricted to owners and admins, in-game and IRC
/location safe (or 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.
ACL: 1 restricted to owners and admins, in-game and IRC
/location {name} watch
Or /location {name} stop watching
Set a location to report player activity regardless of other player watch settings, or not. The default is to not watch players.
Use this setting to be alerted whenever a player enters/exits a watched location or their inventory changes while in it.
ACL: 1 restricted to owners and admins, in-game and IRC
/location {name} enable (or disable) waypoints
Block or allow players to set waypoints in the location.
ACL: 1 restricted to owners and admins, in-game and IRC
/show (or /hide) locations
Normally when you enter and leave a location you will see a private message informing you of this. You can disable the message.
ACL: 0 restricted to server owners, in-game and IRC
/unprotect location {optional name}
Remove bot protection from the location. You can leave out the location name if you are in the location.
ACL: 1 restricted to owners and admins, in-game and IRC
/location {name}
See detailed information about a location including a list of players currently in it.
ACL: 2 restricted to owners, admins and mods, in-game only
Teleport Commands:
Teleports are coordinates in the game world that can trigger when a player's position is within a preset range to teleport the player somewhere else.
A teleport's behaviour can be altered by changing its properties.
Also included here are commands to configure other teleporting settings and some other teleport commands.
/tele {name} delete
Delete a teleport.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) fetch
Allow or block players using the fetch command to teleport friends to them.
ACL: 1 restricted to owners and admins, in-game and IRC
/enabletp {player name}
/disabletp {player name}
Allows or blocks a player's use of teleport commands.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/tele {name} enable (or disable)
Enable or disable a teleport.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/tele {name} one way
Or /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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/tele {teleport name} private (or public)
Make the teleport private or public. New teleports are private by default.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/tele {name} owner {player name}
Assign ownership of a teleport to a player. Only they and their friends can use it (and staff)
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set teleport cost {number}
Set a price for all private teleporting (excludes public locations). Players must have sufficient Zennies to teleport.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/tele {name} access min {minimum access level} max {maximum access level}
Or /tele {name} access min {minimum access level}
Or /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 new players /tele newbies access min 99 max 99.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) p2p
Allow or block players teleporting to other players via shared waypoints or teleporting to friends.
ACL: 0 restricted to server owners, in-game and IRC
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) pvp visit (default disabled)
Normally players cannot visit friends in pvp. They can if you enable this.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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).
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) teleporting
Toggle ability of players using teleport commands. Admins can still teleport.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) stuck
Enable or disable the /stuck command. Default is enabled.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set p2p access {access level}
Restrict the /visit command to players at and above a bot access level.
Levels are 99 (everyone), 90 (everyone except new players), 10 (donors), 2 (mods), 1 (admins), 0 (owners).
ACL: 0 restricted to server owners, in-game and IRC
/set p2p cooldown {number in seconds}
Set a cooldown after players teleport to friends before they can teleport to friends again. Default is 0.
ACL: 0 restricted to server owners, in-game and IRC
Teleport (In-Game Only):
/tp {player name}
Or /tp {name of teleport}
Or /tp {X coord} {Y coord} {Z coord}
Or /tp region {region X} {region Z} (tp's you to the centre of the region)
Or /tp #1 (tele to the coords of a line in a numbered list eg. from /list saves)
Or /north/south/east/west {distance}
Teleport yourself to a player, a coordinate, a named teleport, or a distance in a compass direction (north, south, east or west).
ACL: 2 restricted to owners, admins and mods, in-game only
/tele {name} end
Complete a teleport ending at your location or move an existing teleport's end to you.
ACL: 2 restricted to owners, admins and mods, in-game only
/tele {name} start
Create a teleport starting at your location or move an existing teleport's start to you.
ACL: 2 restricted to owners, admins and mods, in-game only
/fetch {player name}
Move a player to your current location (staff cannot be fetched).
ACL: 90 restricted to players and all admins, in-game only
/teleports
List the teleports.
ACL: 2 restricted to owners, admins and mods, in-game only
/pack (or /revive)
Teleport close to where you last died.
Unrestricted command, in-game only
/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.
Unrestricted command, in-game only
/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)
ACL: 2 restricted to owners, admins and mods, in-game only
/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)
ACL: 2 restricted to owners, admins and mods, in-game only
/stuck
Teleport you to the highest ground level at your location.
ACL: 90 restricted to players and all admins, in-game only
/view teleport {named teleport}
View all the settings of a teleport.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/visit (or /goto) {player name}
Teleport to another player. If the server rules allow, you can teleport to a friend. Various rules and cooldowns may block you.
Unrestricted command, in-game only
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.
You can find more information about waypoints in the following guide.
https://files.botman.nz/guides/Waypoints_Noobie_Guide.pdf
/clear all waypoints {optional player name}
Delete all your waypoints (anyone can do this) or those of a named player (only admins)
Unrestricted command, in-game and IRC
/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.
ACL: 90 restricted to players and all admins, in-game and IRC
/set max waypoints {number} (server wide)
Or /set max waypoints {player name} number {number} (for a specific player)
Or /set max waypoints donors {number} (for donors)
Set the max number of waypoints players can have or a specific player can have.
ACL: 1 restricted to owners and admins, in-game and IRC
/set waypoint cooldown {number} (seconds)
Set how long in seconds players must wait between uses of waypoints
ACL: 1 restricted to owners and admins, in-game and IRC
/set set wp cooldown {number} (seconds)
Set how long in seconds players must wait between uses of /set wp. This hampers abuse of the command to locate hidden bases.
Note this cooldown is not the waypoint cooldown timer.
ACL: 1 restricted to owners and admins, in-game and IRC
/set waypoint cost {number}
Set a price to use waypoints. Players must have sufficient Zennies to teleport.
ACL: 1 restricted to owners and admins, in-game only
/set waypoint create cost {number}
Set a price to create waypoints. Players must have sufficient Zennies
ACL: 1 restricted to owners and admins, in-game only
/enable/disable linked waypoints (default enabled)
If disabled, players will not be able to link waypoints. Also any non-admin existing linked waypoints will be unlinked.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable/disable waypoints
Allow players to create, use and share waypoints.
ACL: 0 restricted to server owners, in-game and IRC
Waypoint Commands (In-Game Only):
/clear wp {name}
Delete a named waypoint. If they are linked, this also unlinks them.
ACL: 90 restricted to players and all admins, in-game and IRC
/close (or /unshare) wp {waypoint name}
Make a waypoint private again. This is its default state.
ACL: 90 restricted to players and all admins, in-game and IRC
/open (or /share) wp {waypoint name}
Share a waypoint with your friends.
ACL: 90 restricted to players and all admins, in-game only
/set wp {waypoint name}
Create or move your first waypoint where you are standing. It retains its current status if it already exists.
ACL: 1 restricted to owners and admins, in-game and IRC
/link wp {name of wp1} to {name of wp2}
/link wp {name of wp1} to friend {name} wp {their shared waypoint}
Link your waypoints to create a portal instead. In this mode you can activate them by stepping into them.
You can link your waypoint to the shared waypoint of a friend until they unshare or delete their waypoint.
ACL: 90 restricted to players and all admins, in-game only
/unlink wp {name of waypoint}
Close your portal and convert each end back into two waypoints which you can then teleport to as normal.
ACL: 90 restricted to players and all admins, in-game only
/wp or /wp1 or /wp {your named waypoint}
Or /wp bob {bob's shared waypoint}
Teleport to one of your waypoints or one of your friend's shared waypoints.
Examples:
/wp stash (tele to your waypoint called stash)
/wp bob pit (tele to bob's waypoint called pit)
ACL: 90 restricted to players and all admins, in-game only
Shop Commands:
The bot's shop allows players to buy items for Zennies.
The shop can be available all the time or within certain hours of the day or from a specific location.
While you can manage the shop ingame, it is much easier to do so from the bot's web client.
/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 might not actually fix whatever is wrong with your shop.
WARNING! This command will send li * to the server which generates a massive list. It may cause a lag spike on a full server.
Due to the size of the data returned by the server, this command is not available in telnet mode. To use it the bot must be in API mode.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/quick fix shop
Like /fix shop but doesn't re-read all the item names known to the server so it completes much faster.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/reset shop
Restock the shop to the max quantity of each item.
ACL: 1 restricted to owners and admins, in-game and IRC
/set shop location {location name}
Or /clear shop location
Restrict the shop to a specific 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)
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set lottery prize {number}
You can set or reset the lottery prize to any number. Useful if it gets too large.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set lottery ticket price {number}
The default cost of a lottery ticket is 25 Zennies. You can change it to anything above 0.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/set shop open (or close) {0 - 23}
Enter a number from 0 to 23 which will be the game hour that the shop opens or closes.
ACL: 1 restricted to owners and admins, in-game and IRC
/open (or /close) lottery
Or /enable (or /disable) lottery
Turn on or off the daily lottery. It is on be default.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set playtime reward {Zennies}
Set how many Zennies a player earns for each minute played. (excludes new players and does not count total time played)
ACL: 0 restricted to server owners, in-game and IRC
/set zombie reward {Zennies}
Set how many Zennies a player earns for each zombie killed.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) bank
Players can earn Zennies if the bank is enabled.
ACL: 0 restricted to server owners, in-game and IRC
/open (or /close) shop
Or /enable (or /disable) shop
Enable or disable the shop feature.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) spending alert (default disabled)
PM the player every time an a command costs them money. Tell them how much they spent and what they have left.
ACL: 1 restricted to owners and admins, in-game and IRC
/cash or /wallet or /bank
Tells you how many Zennies you have.
Unrestricted command, in-game only
/pay {player name} {amount}
Pay a player some amount of Zennies. Admins don't need to have the cash in their balance first.
Unrestricted command, in-game only
/lotto or /lottery or /tickets
See how big the lottery is and how many tickets you have in the draw.
Unrestricted command, in-game only
/gamble {optional quantity} or /buy ticket {optional quantity}
Buy a ticket in the next daily lottery.
Unrestricted command, in-game only
/show (or /hide) cash
See an in-game PM every time your cash balance changes.
Unrestricted command, in-game only
Miscellaneous Commands:
Miscellaneous commands are commands that don't really belong in other sections or haven't been put in one yet :(
/accept
Use this command if you have received an invite to join the IRC server and want further instructions from the bot.
Unrestricted command, in-game only
/bk {bookmark number}
Teleport to the numbered bookmark (Admins only)
ACL: 2 restricted to owners, admins and mods, in-game only
/bookmark {message}
Record the coordinates where you are standing with a message. This was created to help admins quickly teleport to places that players wanted screenshot or videoed by admins before a server wipe.
Only admins can teleport to them. Players can only view a list of the bookmarks created by themselves.
ACL: 90 restricted to players and all admins, in-game only
/claim vote
Claim your reward for voting for the server at 7daystodie-servers.com
Can only be claimed once per day.
Unrestricted command, in-game only
/list bookmarks {player}
If players have bookmarked coordinates on your server, this command will give you a numbered list of a player's bookmarks
Players can only list their own bookmarks and can't teleport to them.
Unrestricted command, in-game and IRC
/bail {player}
/bail {player} pay {amount}
Anyone can bail a prisoner out of prison if they have enough Zennies.
If you don't have enough Zennies you can reduce the bail by making payment towards it.
ACL: 90 restricted to players and all admins, in-game only
/get region {x coordinate} {z coordinate}
Get the region name for the supplied coordinates.
Unrestricted command, in-game and IRC
/irc invite {player}
Invite a player to join the IRC server. Choose carefully who you invite.
ACL: 0 restricted to server owners, in-game and IRC
/mark {name} start/end or p1/p2
Mark out a named area to be used later with commands that accept coordinate pairs
You can save and reload it with /save {name} and /load prefab {name}
Mark two opposite corners of the area you wish to copy. Move up or down between corners to add volume or stay at the same height to mark out a flat area.
ACL: 2 restricted to owners, admins and mods, in-game only
/yes
If the bot asks you a yes/no question you can simply say yes or use this command to hide your response if commands are hidden.
Unrestricted command, in-game and IRC
Hotspot Commands:
Hotspots are proximity triggered PM's that say something to an individual player. Additional functions are being added and admins will be able to queue multiple actions when a specific hotspot is triggered.
/hotspot {message}
Create a hotspot at your current position with a message.
Unrestricted command, in-game only
/delete hotspot {hotspot number from list}
Delete a hotspot by its number in a list.
Unrestricted command, in-game only
/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.
Unrestricted command, in-game only
/hotspots {player name}
List your own hotspots. Admins can list another player's hotspots.
Unrestricted command, in-game only
/move hotspot {hotspot number from list}
Move a hotspot to your current position.
Unrestricted command, in-game only
/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.
Unrestricted command, in-game only
/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
ACL: 1 restricted to owners and admins, in-game only
Friend Commands:
These commands are adding/removing or viewing a player's friends.
/player {player} friend {other player}
eg. /player joe friend mary
Admins can force a player to friend another player with this command. It only applies to the bot, not the game itself.
ACL: 2 restricted to owners, admins and mods, in-game only
/friend {player}
Tell the bot that a player is your friend. The bot can also read your friend list directly from the game. If you only friend them using this command, they will not be friended on the server itself only in the bot.
Unrestricted command, in-game only
/clear friends {player} (only admins can specify a player)
Clear your friends list. Note that this does not unfriend players that you friended via your game. You will need to unfriend those players there yourself.
Unrestricted command, in-game only
/unfriend {player}
Unfriend a player.
Unrestricted command, in-game only
/friendme {player}
Admins can force a player to be their friend with this command. It only applies to the bot, not the game itself.
ACL: 2 restricted to owners, admins and mods, in-game only
/friends {player} (only admins can specify a player)
List your friends.
Unrestricted command, in-game only
/unfriendme {player}
/unfriendme everyone
Unfriend a player or everyone. This command is for admins only.
ACL: 2 restricted to owners, admins and mods, in-game only
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}
Add a player as a member of a village.
Unrestricted command, in-game and IRC
/elect {player name} village {village}
Elect a player as mayor of a village. Democratically of course :)
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/villages
/villagers
List villages or villagers.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/remove village {village}
Delete a village and everything associated with it.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/remove member {player name} village {village}
Remove a player from a village.
ACL: 90 restricted to players and all admins, in-game and IRC
/village {village} size {metres}
Resize a village. Note that this removes village protection to prevent teleport loops.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/add village {village name}
Create a new village.
ACL: 2 restricted to owners, admins and mods, in-game only
/protect village {village name}
Set village protection and follow the prompt from the bot, just like setting base protection.
ACL: 2 restricted to owners, admins and mods, in-game only
/unprotect village {village name}
Remove protection on a village.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
Bot Commands:
Commands in this section are commands that alter settings relating to the bot itself.
/backup bot {optional name}
Make a backup of the bot's data before doing something to the bot. :O
ACL: 0 restricted to server owners, in-game and IRC
/clear whitelist
Remove everyone from the bot's whitelist.
ACL: 1 restricted to owners and admins, in-game and IRC
/forget players
Makes the bot forget everything about players as if they were new again. It does not touch admins (nasty filthy adminses).
ACL: 0 restricted to server owners, in-game and IRC
/password {some password or phrase}
If you have set a master password, some bot commands will issue a password challenge. Use this command to send the password to the bot.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list backups
View a numbered list of available backups.
Use /restore backup, to restore a backup. See the help for /restore backup for additional options.
ACL: 0 restricted to server owners, in-game and IRC
/list chat colors
See the bot's chat colours and player chat colours.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/refresh code
Make the bot re-download and install from the current code branch for script updates. Only necessary if someone has edited the code and needs to restore it.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/rejoin irc
Sometimes the bot can fall off IRC and fail to reconnect. This command forces it to reconnect.
Unrestricted command, in-game and IRC
/reload bot
Make the bot read several things from the server including admin list, ban list, gg, lkp and others.
Unrestricted command, in-game and IRC
/reset bases
Just reset the player bases, nothing else.
This commmand is mainly for rare cases where you only need the bot to forget the player bases.
ACL: 0 restricted to server owners, in-game only
/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.
ACL: 0 restricted to server owners, in-game and IRC
/restart bot
If your Mudlet (the bot's engine) is set up to automatically restart itself you can command the bot to restart. Also this feature must be enabled.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/restore backup {optional backup number} {optional words: bases, cash, donors, colors, locations, waypoints, friends, villagers, teleports, hotspots, resets, players, shop, gimme, zombies}
/restore backup {optional backup number} {optional words as above} player {name or steam or player id} (note: player {name} must be specified last)
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.
To only restore player bases, add the word bases, for cash add cash and for donors add donors. If these words are included, nothing else is restored.
You can also just restore 1 named player.
To see a list of backups use /list backups.
ACL: 0 restricted to server owners, in-game and IRC
/set api log read {interval in seconds} (default 3 seconds)
In API mode the bot will read the server log at regular intervals with the default being every 5 seconds.
You can set a longer delay but the bot won't respond to in-game commands faster than the delay that you set.
If you think the polling interval is causing server lag you can try slowing it down.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set alert colour {hex code}
Set the colour of server alert messages.
ACL: 1 restricted to owners and admins, in-game and IRC
/set chat colour {hex code}
Set the colour of server messages. Player chat will be the default colour.
ACL: 1 restricted to owners and admins, in-game and IRC
/set bot log level {0 - 5} (default 0)
To help reduce IO and improve bot performance you can tell the bot to not maintain certain logs.
When set to 0 the bot will record all logs that it maintains except where individual logs can be enabled or disabled with other commands. Settings are as follows..
0 = Everything is logged
1 = Telnet is not logged
2 = The player tracking shadow copy is not logged
3 = Bot commands are not logged separately
4 = Telnet and the tracking shadow copy are not logged
5 = Telnet, the tracking shadow copy, and bot commands are not logged
ACL: 0 restricted to server owners, in-game and IRC
/name bot {some cool name}
The default name is Bot. Help give your bot a personality by giving it a name.
ACL: 0 restricted to server owners, in-game and IRC
/set bot name colour {hex colour code}
Set the colour of the bot's name. Requires the botman mod.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set spam trigger {number}
The bot has a safe mode and monitors telnet for WRN and ERR lines. If it counts more than the spam trigger value in 5 seconds, it will stop processing every single telnet line that it sees and go into safe mode.
In safe mode it will only process telnet lines for 5 seconds in every 25 seconds.
The bot will exit safe mode and resume normal processing of telnet lines once the spam detection drops below the spam trigger number.
It report to the alerts channel when it is in safe mode along with the current spam count.
ACL: 0 restricted to server owners, in-game and IRC
/set warn colour {hex code}
Set the colour of server warning messages.
ACL: 1 restricted to owners and admins, in-game and IRC
/set command prefix / (or no symbol)
Change bot commands from using / to using nothing or another symbol.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set max log days {number}
The default is 14 days. Setting this too long will result in lots of log files on disk.
To prevent this causing issues on my hosted bots, the max you can set this is 60 days.
To set it higher you need to edit telnetlogkeepdays in the server table in the database.
ACL: 0 restricted to server owners, in-game and IRC
/set web token {user} password {password}
If you have set a web token on the server for the bot to use, you can tell the bot the user and password with this command.
ACL: 0 restricted to server owners, in-game and IRC
/set update branch
Bot updates are released in code branches such as 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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.Note: This doesn't actually stop the bot. It only ensures that everything has been saved so you can manually shutdown Mudlet.
ACL: 0 restricted to server owners, in-game and IRC
/timers
List your active cooldown timers and how much time remains for each.
Unrestricted command, in-game only
/set bot chatty/quiet
If you want to stop the bot responding to 'hi bot' and be more utilitarian, you can set the bot to be quiet.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /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 https://botman.nz/shellscripts.zip
You will need to inspect and modify some paths in the scripts to match your setup.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /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
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) level hack check
Hackers can give themselves XP but normal play and/or game bugs can also cause large level changes.
The level check could falsely report legit level changes as hacking so this is disabled by default.
If you enable it and innocent players get banned, either unban them or turn it off again.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) bot colours (default enabled)
If you want something else managing chat colours you can stop the bot replacing them by disabling that feature with this command.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) 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.
ACL: 0 restricted to server owners, in-game and IRC
/show (or /hide) unknown command
If the bot doesn't recognise a command it will respond with 'Unknown command'. You can hide that message if you want.
ACL: 0 restricted to server owners, in-game and IRC
/show (or /hide) disabled command
If you use another manager for some commands and both use the same command prefix and you have disabled some bot commands, the bot will tell players that a command is disabled. You can stop the bot responding at all by hiding bot responses like 'This command is disabled'.
Note that this will suppress that response for all disabled bot commands and is not aware what if any commands are handled by another manager or mod.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) bot command log (disabled by default)
For debugging purposes, commands sent to the server by the bot can be logged just like player commands but to its own log file.
This will include sensitive information such as passwords so don't enable this if anyone has access to it that you don't want reading it.
Only server owners can enable this log.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) inventory log. (disabled by default)
The bot logs inventory and inventory changes to the database all the time. You can also have inventory changes recorded to a daily text file along with the other daily logs.
ACL: 0 restricted to server owners, in-game and IRC
/read log using telnet (default)
/read log using api
Due to ongoing issues with the API log reader skipping lines the default is that in API mode, the bot will monitor the server via telnet.
If telnet is disabled or you tell the bot to read the log using the API, then it will monitor the server via the API.
ACL: 0 restricted to server owners, in-game and IRC
/use telnet (this is the default now but the API is planned to become the new default soon)
/use api
The bot communicates with the server using telnet. It can use Allocs web API instead.
ACL: 0 restricted to server owners, in-game and IRC
/update code
Make the bot check for script updates. They will be installed if you have set /enable updates
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 0 restricted to server owners, 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.
ACL: 0 restricted to server owners, in-game and IRC
Fun Commands:
Fun commands are miscellaneous commands that include gimme, bounties and a few silly commands.
/bounty {optional player name}
Or /view bounty {optional player name}
Or /view bounties
See the player kills and current bounty on a players head or on all players currently on the server.
Unrestricted command, in-game and IRC
/gimme gimme
Or /gimme peace
Make gimme messages appear in public chat with /gimme gimme or as private messages with /gimme peace (with some exceptions).
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/fix gimme
Force the bot to rescan the list of zombies, animals and spawnable items.WARNING! This command will send se and li * to the server which generates a massive list. It may cause temporary lag on a full server.The bot will process the list slowly and will take a minute and a half to complete. Be patient :P
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/reset arena
Cancel an arena game in progress.
Unrestricted command, in-game and IRC
/gimme raincheck {seconds}
Set a time delay between gimmes. The default is 0 seconds.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/gimme reset
Reset gimme counters for everyone so they can play gimme again. The bot does this every 120 minutes automatically.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/gimme on (or off)
Enable/disable the gimme game.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/gimme zombies
/gimme no zombies
Enable or disable zombies as gimme prizes.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/gimme reset time {number} (In minutes. Default is 120)
Reset everyone's gimme counter after (n) minutes.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/beer
While in any location with beer in its name, players can grab a beer (or a lot).
Unrestricted command, in-game only
/gimme max gimmies {number of gimmies}
Set the maximum number of gimmie games that can be played between gimmie resets.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/suicide
Don't do it! :O
Unrestricted command, in-game only
/place bounty {player name} {cash}
Place a bounty on a player's head. The money is removed from your cash.
Unrestricted command, in-game only
/gimme
Play one gimme - win a prize!
Gimme cannot be played within a location unless it is pvp enabled.
Gimme cannot be played inside a player base.
Prize may contain nuts. If a rash develops, see your doctor. Keep away from small children. The bag is not a hat.
Unrestricted command, in-game only
/quit {message}
Get kicked out of the server and have the bot say your message in game chat.
/quit
/ragequit
Get kicked out of the server with a random message.
Unrestricted command, in-game only
/gimmezombies or /gimmehell or /gimmeinsane or /gimmedeath
Play a special gimme game in a location called arena. You and anyone with you will get 4 waves of zombies to fight.
Select one of 4 games of increasing difficulty (more zombies, faster spawns, harder zombies).
Admins or arena players can cancel the game with /reset gimmearena
Zombies are randomly distributed between arena players. Any players more than 5 blocks above the arena floor (or under it) are specators and don't get zombies.
Some useless crap is supplied at the start.
Unrestricted command, in-game only
/doge mode or /doge on/off
But what does it do!? Play and find out xD
Unrestricted command, in-game only
Admin Commands:
Admin commands are mainly about doing things to or for players but is also a catchall for commands that don't really fit elsewhere but are for admins.
/admin add {player or steam or game ID} level {0-2}
Or /admin remove {player or steam or game ID}
Give a player admin status and a level, or take it away.
The default admins levels are server owners: level 0, admins: level 1 and moderators: level 2. The bot supports admin levels from 0 to 89.
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.
ACL: 0 restricted to server owners, in-game and IRC
/add (or /remove) bad item {item} action {timeout or ban} (default action is timeout)
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}
ACL: 1 restricted to owners and admins, in-game and IRC
/add (or /remove) bad word {word or phrase} (max 100 characters)
Or /add (or /remove) bad word {word or phrase} cost {amount of money} response {nothing or mute or ban or timeout} cooldown {number of seconds before un-muting etc}
Add or remove a word or phrase to/from the list of bad words.
Cost, response and cooldown are optional. The default is a cost of 10 Zennies, and no other response or cooldown.
If you set the response to mute, ban or timeout and do not set a cooldown, it is permanent unless undone by an admin or something else.
ACL: 1 restricted to owners and admins, in-game and IRC
/add (or /remove) blacklist country {US}
Add or remove a country to/from the blacklist. Note: Use 2 letter country codes only.
ACL: 0 restricted to server owners, in-game and IRC
/add donor {player name} expires {number} week or month or year
Or /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.
Expiry is optional. The default is 1 year.
You can also temporarily raise everyone to donor level with /override access.
ACL: 0 restricted to server owners, in-game and IRC
/add restricted item {item name} qty {count} action {action} access {level}
Or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/add (or /remove) whitelist country {US}
Add or remove a country to/from the whitelist. Note: Use 2 letter country codes.
ACL: 0 restricted to server owners, in-game and IRC
/archive players
Archive players that haven't played in 60 days, aren't staff, banned, or a donor.
This should speed the bot up on servers that have seen thousands of players over time as the bot won't need to search so many player records.
Archived players are still accessible and searchable but are removed from the main players table. If a player comes back they are automatically restored from the archive.
ACL: 1 restricted to owners and admins, in-game and IRC
/arrest {player name}
Or /arrest {player name} reason {why arrested}
Send a player to prison. If the location prison does not exist they are sent to timeout instead.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/ban {player name} (ban for 10 years with the reason 'banned')
Or /ban {player name} reason {reason for ban} (ban for 10 years with the reason you provided)
Or /ban {player name} time {number} hour or day or month or year reason {reason for ban}
Or /unban {player name} (This will also remove global bans issued by this bot against this player. It will not remove global bans issued elsewhere.
Or /gblban {player name} 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'.
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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/block (or /unblock) {name}
Block/Unblock a player from using any bot commands or command the bot from IRC.
ACL: 1 restricted to owners and admins, in-game and IRC
/burn {player name}
Set a player on fire. It usually kills them.
ACL: 0 restricted to server owners, in-game and IRC
/clear country blacklist
Remove all countries from the blacklist. (yay?)
ACL: 0 restricted to server owners, in-game and IRC
/clear country whitelist
Remove all countries from the whitelist.
ACL: 0 restricted to server owners, in-game and IRC
/cool {player name}
Cool a player or yourself if no name given.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/cure {player name}
Cure a player or yourself if no name given.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/download help
This saves a JSON encoded text file of the bot's in-game help so you can edit it to change permissions.
To upload it back to the bot use /upload help {url where your modified help file can be downloaded by the bot}
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/free {player name}
Release the player from exile, however it does not return them. They can type /return or you can return them.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/give (claim or key or 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.
Unrestricted command, in-game only
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game only
/goto {player or steam or game ID}
Teleport to the current position of a player. This works with offline players too.
ACL: 2 restricted to owners, admins and mods, in-game only
/hordeme
Spawn a horde of 50 random zombies on yourself. Only admins can do this (but not mods)
ACL: 1 restricted to owners and admins, in-game only
/kick {player name or Steam ID or Game ID} reason {optional reason}
Is Joe annoying you? Kick his ass right out of the server! >:D
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/bad items
List the items that are not allowed in player inventories and what action is taken.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/bad words
List the bad words and what the bot will do about them. Also has a counter of how often they have been seen.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/bases (or /homes)
Or /bases (or /homes) range {number}
Or /bases (or /homes) 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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list blacklist
List the countries that are not allowed to play on the server.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/claims {range} (range is optional and defaults to 50)
List all of the claims within range with who owns them
ACL: 2 restricted to owners, admins and mods, in-game only
/offline players nearby
/offline players nearby range {number}
List all offline players near your position. The default range is 200 metres.
ACL: 2 restricted to owners, admins and mods, in-game only
/prisoners
List all the players who are prisoners.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list staff/admins
Lists the server staff and shows who if any are playing.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/restricted items
List the items that new players are not allowed to have in inventory and what action is taken.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list whitelist
List the countries that are allowed to play on the server.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/mend {player name}
Remove the brokenLeg buff from a player or yourself if no name given.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/near {player name} {optional number (distance away from player)}
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.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/poop {player name}
Make a player shit potatoes everywhere coz potatoes.
ACL: 1 restricted to owners and admins, in-game and IRC
/read claims
Make the bot run llp so it knows where all the claims are and who owns them.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/release {player name}
Or /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 (admin only)
Unrestricted command, in-game and IRC
/release here {prisoner}
Release a player from prison and move them to your location.
ACL: 2 restricted to owners, admins and mods, in-game only
/reload admins
Make the bot run admin list to reload the admins from the server's list.
Unrestricted command, in-game and IRC
/remove entity/trader/npc {optional id}
The bot will despawn any trader within 2 blocks of you in-game or by entity id if given.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/reset help
This command makes the bot delete and rebuild the command help from the bot's code so you can restore command permissions back to defaults should you need to.
ACL: 0 restricted to server owners, in-game and IRC
/reset player record {player name}
Make the bot forget a player's cash, waypoints, bases etc but leave their donor status alone.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/restore admin
Use this command if you have used /test as player, and you want to get your admin status back now.
Unrestricted command, in-game and IRC
/return {player name}
Or /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.
ACL: 90 restricted to players and all admins, in-game and IRC
/sendhome {player name}
Teleport a player to their first base or their bedroll if they have no base set.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/send {player} to {other player}
Teleport a player to another player even if the other player is offline.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set death cost {cash} (default is 0)
Set a cost penalty for dying. The player's cash balance won't drop below zero.
ACL: 1 restricted to owners and admins, in-game and IRC
/set suicide cost {cash} (default is 0)
Set a cost to use the /suicide command.
ACL: 1 restricted to owners and admins, in-game and IRC
/allow (or /disallow) suicide
Let players /suicide or don't let them commit the unthinkable :O
ACL: 1 restricted to owners and admins, in-game and IRC
/set drop mining warning {number of blocks} (default is 99)
Set how many blocks can fall off the world every minute before the bot alerts admins to it.
Disable by setting it to 0
ACL: 1 restricted to owners and admins, in-game only
/set command cooldown {seconds} (default 0)
You can add a delay between player commands to the bot. Does not apply to staff. This helps to slow down command abuse.
ACL: 1 restricted to owners and admins, in-game and IRC
/set feral horde night {day number} (default is 7)
Set which day is horde night. This is needed if your horde nights are not every 7 days.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set max admin level {number from 2 to 89}
Set the max access level for admins. The default is 2.
Note that levels 0, 1 and 2 are reserved and what you can is a number greater or equal to 2 but less than 90 eg. 10.
To avoid potential issues, do not allow max admin level to be a higher number than your lowest donor level.
ACL: 0 restricted to server owners, in-game and IRC
/max tracking days {days}
Set how many days to keep tracking data before deleting it. The default it 28.
ACL: 0 restricted to server owners, in-game and IRC
/set reserved slot timelimit {minutes} (default 0)
If this is 0, reserved slots are released when the player leaves the server.
Otherwise minutes after the player reserves a slot, they will become eligible to be kicked to make room for another reserved slotter.
ACL: 0 restricted to server owners, in-game and IRC
/set return cooldown {seconds} (default 0)
You can add a delay to the return command. Does not affect staff.
ACL: 1 restricted to owners and admins, in-game and IRC
/prisoner {player name} arrested {reason for arrest}
Or /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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set watch timer {number in seconds}
Or /set watch player {name} timer {number in seconds}
When a new player joins, in-game admins will be messaged when the player adds or removes inventory. They will automatically stop being watched after a delay. The default is 3 days.
You can also set a different watch duration for an individual player.
1 hour = 3,600 1 day = 86,400 1 week = 604,800 4 weeks = 2,419,200
This timer is in real time not game time or time played.
ACL: 1 restricted to owners and admins, in-game and IRC
/shit {player name}
Give a player the shits for shits and giggles.
ACL: 1 restricted to owners and admins, in-game and IRC
/test as player {optional number in seconds}
Remove your admin status for 5 minutes. After 5 minutes your admin status will be restored and any bans against you removed.
If you provide a number, your admin will instead be restored after that many seconds incase you need longer or shorter than the default 5 minutes.
You can get your admin status back with the command /restore admin
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/play as player
Remove your admin status in game only until restored with /restore admin.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 90 restricted to players and all admins, in-game and IRC
/enable (or /disable) level hack alert
By default the bot will inform admins when a player's level increases massively in a very short time. You can disable the message.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) airdrop alert
By default the bot will inform players when an airdrop occurs near them. You can disable the message.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) 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.
ACL: 1 restricted to owners and admins, in-game and IRC
/ignore (or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/block (or /unblock) player {player name}
Prevent a player from using IRC. Other stuff may be blocked in the future.
ACL: 0 restricted to server owners, in-game and IRC
/freeze (or /unfreeze) {player name}
Bind a player to their current position. They get teleported back if they move.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/include (or /exclude) 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.
ACL: 1 restricted to owners and admins, in-game and IRC
/ignore (or /include) player {player name}
An ignored player can have uncraftable inventory and do hacker like activity such as teleporting.
An included player is checked for these things and can be punished or temp banned for them.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set say uses name (the default)
Or /set say uses nick
The IRC command 'say' uses your player name by default.
You can set it to use the IRC nickname instead. Note: It will do that for all IRC users.
ACL: 1 restricted to owners and admins, in-game and IRC
/allow (or /disallow) xbox
Allow or block XBox (Gamepass) players joining your server. Default is allow.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) (pack or 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.
ACL: 1 restricted to owners and admins, in-game and IRC
/remove (or /leave) expired claims
By default the bot will not remove expired claims. It will always ignore admin claims.
ACL: 1 restricted to owners and admins, in-game and IRC
/reserve (or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) screamer alert
By default the bot will warn players when screamers are approaching. You can disable that warning.
ACL: 1 restricted to owners and admins, in-game and IRC
/allow (or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/watch {player name}
Or /watch new players
Or /stop watching {player name}
Or /stop watching everyone
Flag a player or all current new players for extra attention and logging. New players are watched by default.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/upload help {url where commands.json file can be downloaded by the bot}
Use this command to upload your edited commands.json file to the bot.
IMPORTANT: Every time you upload the json file you need to change the name of the file to prevent it being cached by the host server or you will not see your changes.
The url must link to the raw json file so you will not be able to use text sharing sites such as pastebin etc. If you own a website, upload it there.
ACL: 0 restricted to server owners, in-game and IRC
/unlockall
Unlocks all locked containers etc in your immediate area (the current chunk)
ACL: 1 restricted to owners and admins, in-game only
/crimescene {prisoner}
Teleport to the coords where a player was when they got arrested.
ACL: 2 restricted to owners, admins and mods, in-game only
/playerbase (or /playerhome) {player name}
Or /playerbase (or /playerhome) {player name} base {number or name}
Teleport yourself to a player's base.
ACL: 2 restricted to owners, admins and mods, in-game only
/whitelist add (or /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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/whitelist everyone (or all)
You can add everyone except blacklisted players to the bot's whitelist.
ACL: 1 restricted to owners and admins, in-game and IRC
Reset Zone Commands:
Reset zones tell a player where when they can't place claims or setbase in a location or region. The bot is not able to actually delete parts of the map and that must be done manually with the server offline. The bot does provide a list of regions that are reset zones if any regions have been flagged as such.
/clear reset zones
The bot will forget all the reset zones so you can start over marking new ones.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/reset zones
List all of the regions that are reset zones.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/redo reset zones
Put back all of the reset zones via the Botman mod if you've accidentally deleted the mod's config.xml file from the server.
Note: This requires the Botman mod or all it really does is list the reset zones.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/add (or /remove) reset
Or /add (or /remove) reset x-coord z-coord
Flag or unflag an entire region as a reset zone. If you don't specify an x and z coord, you need to be playing and standing inside the region.
Example with coords: /add reset -1 3. This will make region r.-1.3.7rg a reset zone.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
Tracker Commands:
All player movement is recorded every 3 seconds.
The tracker allows admins to follow a player's movements now or in the past so long as there is tracking data recorded.
The tracker can also be used to visit every recorded player base using special commands.
The tracker runs slowly by default to give admins time to look around and time to command the tracker. Several controls are available to change speed, direction and more.
/track {player name} session {number} (session is optional and defaults to the latest)
Or /trackshadow {player name} session {number} (session is optional and defaults to the latest)
Or /track {player name} session {number} range {distance}
Or /next (track the next session)
Or /last (track the previous session)
Track the movements of a player. If a session is given, you will track their movements from that session.
If you add the word hax, hacking or cheat the bot will only send you to coordinates that were flagged as flying or clipping.
If you suspect that the bot has lost the tracking data you can use the shadow copy instead using trackshadow instead of track.
ACL: 2 restricted to owners, admins and mods, in-game only
/skip {number of steps}
Skip {number} of steps. Instead of tracking each recorded step, you will skip {number} steps for faster but less precise tracking.
ACL: 2 restricted to owners, admins and mods, in-game only
/speed {number}
The default pause between each tracked step is 3 seconds. Change it to any number of seconds from 1 to whatever.
ACL: 2 restricted to owners, admins and mods, in-game only
/jump {number of steps}
Jump forward {number} steps or backwards if given a negative number.
ACL: 2 restricted to owners, admins and mods, in-game only
/goto start
Move to the start of the current track.
ACL: 2 restricted to owners, admins and mods, in-game only
/goto end
Move to the end of the current track.
ACL: 2 restricted to owners, admins and mods, in-game only
/go back
Remove the current base and protection that the tracker has teleported you to. Used with /check base.
ACL: 2 restricted to owners, admins and mods, in-game only
/stop
Stop tracking. Resume it with /go
ACL: 2 restricted to owners, admins and mods, in-game only
/go
Resume tracking.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 2 restricted to owners, admins and mods, in-game only
/check bases
Load base coordinates into the tracker so you can tp directly to each base in sequence. Used for visiting every single base ingame.
ACL: 2 restricted to owners, admins and mods, in-game only
/nb
Visit the next base in the tracker.
ACL: 2 restricted to owners, admins and mods, in-game only
/pb
Visit the previous base in the tracker.
ACL: 2 restricted to owners, admins and mods, in-game only
/killbase
Remove the current base and protection that the tracker has teleported you to. Used with /check base.
ACL: 2 restricted to owners, admins and mods, in-game only
Server Commands:
Server commands mainly cover settings that change the nature of the server or turn features on or off that relate to the server.
/set telnet enabled (or disabled) (enabled is the default)
This doesn't change telnet in the server. Instead use this to tell the bot if the server's telnet is enabled or disabled.
This is used by the bot as part of monitoring the status of telnet. If telnet is disabled, the bot won't keep trying to connect to it.
ACL: 0 restricted to server owners, in-game and IRC
/say{2 letter language code} {something you want translated}
If the translator utility is installed, the bot can translate from english what you say into the language you specify.
eg. /sayfr Hello. The bot will say Smegz0r: Bonjour
Note: This uses Google and due to the number of bots I host, it is not installed on my servers as I don't want to risk an invoice from them.
Unrestricted command, in-game only
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/join server {ip} port {telnet port} pass {telnet password}
Tell the bot to join a different game server.
ACL: 0 restricted to server owners, in-game and IRC
/pause reboot
Pause a scheduled reboot. It will stay paused until you unpause it or restart the bot.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set archive players day {number (days) default is 60}
The bot will archive players who haven't played in 60 days except for admins. You can disable this feature by setting it to 0.
The bot will archive players at startup or if you use the command /archive players.
ACL: 0 restricted to server owners, in-game and IRC
/set bail {number}
Set how many Zennies it costs to bail out of prison. To disable bail set it to zero (the default)
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/motd (to view it)
/motd (or /set motd) {your message here} (to set it)
/motd clear (to disable it)
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
ACL: 0 restricted to server owners, in-game and IRC
/set idle kick {seconds} (default 900. 15 minutes)
How many seconds a player can be idle for before being kicked from the server. Does not include joining players that have not spawned yet.
ACL: 1 restricted to owners and admins, in-game and IRC
/set irc main (or alerts or watch) {channel name without a # sign}
Change the bot's IRC channels.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/set irc server {IP or URL and optional port}
Use this command if you want players to know your IRC server's address.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set max animals {number}
Change the server's max spawned animals.
ACL: 0 restricted to server owners, in-game and IRC
/set hacker flying trigger {number}
The anti-cheat flying detection will trigger when a player is detected more than this high above the ground.Default is 7. Used by the bot's flying hacker detection when enabled with /disallow flying.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/set max players {number}
Change the server's max players. Admins can always join using the automated reserved slots feature.
ACL: 0 restricted to server owners, in-game and IRC
/set max uptime {number}
/max uptime (to review it)
Set how long the server will run before the bot schedules a reboot. The bot will always add 15 minutes as the reboot is only scheduled at that time.
Numbers 1 - 24 will be treated as hours, numbers above that will be treated as minutes. So to set an uptime of 2 hours and 30 minutes use /set max uptime 150.
ACL: 0 restricted to server owners, in-game and IRC
/set max zombies {number}
Change the server's max spawned zombies.
ACL: 0 restricted to server owners, in-game and IRC
/set new player max level {number} (game level)
By default a new player is automatically upgraded to a regular player once they pass level 9.
Use this command to change it to a different player level.
ACL: 0 restricted to server owners, in-game and IRC
/set new player timer {number} (in minutes)
/new player timer (to see it)
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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/set pvp cooldown {seconds}
Set how long after a pvp kill before the player can use teleport commands again.
ACL: 1 restricted to owners and admins, in-game and IRC
/set pvp temp ban {minutes}
Set how long to temporarily ban a player after a pvp kill.
This is only used in PVE when there is no prison location.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set rolling delay {minutes}
Set the delay in minutes between rolling announcements.
ACL: 1 restricted to owners and admins, in-game and IRC
/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
ACL: 0 restricted to server owners, in-game and IRC
/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. It is used to determine if a player has voted for your server today.
While the bot takes precautions to keep your API key a secret, you should be careful not to type it anywhere in public. The safest place to give it to the bot is in private chat on IRC or on the bot's web interface when that is available.
ACL: 0 restricted to server owners, in-game and IRC
/set server vote reward {default/random/list/item/entity}
/set server vote reward random quantity {number} quality {number}
The default reward is the sc_General supply crate.
If you set a random reward you can optionally set a quantity and quality.
Quality is random if not specified.
Quantity is the number of random items, not a quantity of the same item (except by chance). If quantity is not set the bot will give between 3 and 5 random items.
If you set the reward as list you will need additional commands to manage the reward items. For commands type /help reward list.
If you set the reward as item, the player will be given the item that you specify.
If you have a custom entity (eg sc_General2) type /set server vote reward entity sc_General2.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/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)
ACL: 1 restricted to owners and admins, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/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
If you want to manually set a web permission, here is a valid console command for reference
webpermission add webapi.getplayersOnline global 1000
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 1000
webapi.getstats 1000
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 1000
webapi.viewallclaims 1000
webapi.getplayerinventory 1000
ACL: 0 restricted to server owners, in-game and IRC
/set web panel port {port of server's control panel/web panel}
or /set api port {number}
The bot needs to be told the port for Alloc's web map. If you give it the wrong port and API support is enabled or you enable that later, the bot will try that port and the ports +/- 2 above and below it.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/set welcome message {your message here}
/clear welcome message
You can set a custom welcome message that will override the default greeting message when a player joins.
ACL: 1 restricted to owners and admins, in-game and IRC
/test vote reward
Admin and in-game only. The bot will try to spawn the server vote reward beside you.
ACL: 0 restricted to server owners, in-game only
/allow/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.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) vac (disable is the default)
If a player has any VAC bans you can auto-ban them or allow them in.
Each time they join, admins will be alerted to their VAC ban. To stop that, add the them to the bot's whitelist.
ACL: 1 restricted to owners and admins, in-game and IRC
/remove zombies before bloodmoon
/leave zombies before bloodmoon
This command is temporarily disabled until the Botman mod can despawn multiple entities using a filter.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) error scan (disabled by default)
The server can automatically scan for and fix some errors using console commands if you have the BC mod or Botman mod installed.
You can disable the scan if you suspect it is creating lag.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/allow/disallow family (allowed by default)
Set to disallow if you require all players use the owner steam key and want to block players with a steamid that does not match the steamOwner.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /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.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /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.
ACL: 0 restricted to server owners, in-game and IRC
/allow/disallow idling (allowed is default)
If idle kick is enabled the default is to only kick idle players when the server is full. By setting disallow idling, players can be kicked for idling any time.
ACL: 0 restricted to server owners, in-game and IRC
/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.
ACL: 0 restricted to server owners, in-game and IRC
/set irc private (or 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.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) noclip scan (defaults disabled)
Using the Botman mod 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. The bot will ban a player found clipping a lot for one week.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) overstack checking
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.
ACL: 0 restricted to server owners, in-game and IRC
/northeast pve (or pvp)
/northeast pve (or pvp)
/northwest pve (or pvp)
/southeast pve (or pvp)
/southwest pve (or pvp)
/north pve (or pvp)
/south pve (or pvp)
/east pve (or pvp)
/west pve (or pvp)
Make northeast/northwest/southeast/southwest/north/south/east/west of 0,0 PVE or PVP.
ACL: 0 restricted to server owners, in-game and IRC
/allow (or /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.
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) region pm
A PM for admins that tells them the region name when they move to a new region.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or disable) reboot
By default the bot does not manage server reboots.
See also /set max uptime (default 12 hours)
ACL: 1 restricted to owners and admins, in-game and IRC
/enable (or /disable) watch alerts
Enable or disable ingame private messages about watched player inventory and base raiding. Alerts will still go to IRC.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) welcome messages
The welcome messages are enabled by default.
ACL: 0 restricted to server owners, in-game and IRC
/resume (or /unpause) reboot
Resume a paused reboot.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/visitmap
Or /visitmap x1 z1 x2 z2
Or /visitmap range {distance}
Or /visitmap stop
Make the server explore the map while you hit up some zombie chicks.
If you add the optional word 'check' at the end of the command it will also check chunk density.
To visit the entire map do not include coordinates or a range.
ACL: 0 restricted to server owners, in-game and IRC
Botman Commands:
The Botman mod adds special features to the bot such as hiding commands from chat, digging big holes and lots more.
The bot will work just fine without it.
/save {name}
After marking out the area you want to copy, you can save it.
ACL: 2 restricted to owners, admins and mods, in-game only
/set (new player or player or donor or prisoner or mod or admin or owner) chat colour FFFFFF
Or /set player {player name} chat colour FFFFFF
Or /reset chat colour ({player name} or everyone or all)
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 disable automatic chat colouring, set it to white which is FFFFFF
To reset everyone to white type /reset chat colour everyone
ACL: 1 restricted to owners and admins, in-game and IRC
/set (or /clear) horde
Marks your current position to spawn a horde there with /spawn horde.
Clear horde doesn't remove the horde. It only clears the saved coordinate.
ACL: 2 restricted to owners, admins and mods, in-game only
/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.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/set max clans {number of clans}
Set the maximum number of clans.
ACL: 0 restricted to server owners, in-game and IRC
/set max clan players {number of players}
Set the maximum number of players clans can have.
ACL: 0 restricted to server owners, in-game and IRC
/set min clan level {player level}
Set the minimum player level required to join a clan.
ACL: 0 restricted to server owners, in-game and IRC
/set reset delay {days}
Sets the delay of days between resets. 0 for every reboot.
ACL: 0 restricted to server owners, in-game and IRC
/set map colour FF0000 (red is the default colour)
Set the colour of reset regions on Alloc's web map.
ACL: 1 restricted to owners and admins, in-game and IRC
/set player {steam id or name or entity id} name {new name}
Or /clear player {steam id or name or entity id} name
A player's name can be replaced with something else.
The change is applied each time the player joins until an admin clears it.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/enable (or /disable) anticheat
Enable or disable the anticheat feature in the Botman mod. Default is disabled.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) clans
Enable or disable the clan feature in the Botman mod. Default is disabled.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) mapping
Enable or disable plotting reset regions on Alloc's web map.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) reset regions
Enable or disable the Botman mod's reset regions feature. Default is disabled.
This is very similar to the bot's reset zones except that they are limited to whole regions and can actually reset the region or just prefabs or just remove claims.
ACL: 0 restricted to server owners, in-game and IRC
/reset regions remove (or leave) claims (default is leave claims)
Reset regions can remove or leave claim blocks.
ACL: 0 restricted to server owners, in-game and IRC
/enable (or /disable) reset prefabs
The Botman mod can reset entire regions (the default) or just the prefabs they contain.
ACL: 0 restricted to server owners, in-game and IRC
/mute (or /unmute) {player name}
Muting a player blocks their ingame chat from being seen by other players. You will still see it from the web client.
It does not block voice chat sadly.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/show (or /hide) commands
Hide commands from ingame chat which makes them all PM's or show them which makes them public. They will still appear in the web client.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/trader (protect or unprotect or remove) {named area}
/trader add (or /trader del) {named area}
/trader (protect or unprotect) (north or south or east or west or ne or nw or se or sw) long {number} wide {number}
After marking out a named area with the /mark command, you can add or remove trader protection on it.
When used with a compass direction you do not need to mark out the area first. Your current position is used instead.
Also when a compass direction is used, do not give the area a name as it is not recorded. You can repeat the command by simply typing /
ACL: 2 restricted to owners, admins and mods, in-game only
/stop (or /cancel) maze
Aborts generation of any mazes that you have told the bot to create.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/delete save {number taken from /list saves}
After /list saves, you can delete a save from the list.
Note that the list is temporary, but will last until the next time a list is generated. If it doesn't work, do another /list saves.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/dig (or /fill) {optional number} (default 5)
Dig a hole or fill a hole.
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)
/dig up wide 50 tall 30 replace air block terrStone
/fill east base 70 wide 2 tall 10 long 50 block steelBlock
/fill bedrock wide 2 block stone
/fill {saved prefab} block stone
You can repeat the last command with /again and change direction with /again west
ACL: 2 restricted to owners, admins and mods, in-game only
/erase {optional number} (default 5)
Or /erase block {block name} replace {with other block name} {optional number}
Replace an area around you with air blocks. Add a number to change the size.
eg. /erase block stone replace air 20
ACL: 2 restricted to owners, admins and mods, in-game only
/list (or /li) {partial name of an item or block}
List all items containing the text you are searching for.
ACL: 2 restricted to owners, admins and mods, in-game only
/list saves {optional player name}
List all your saved marked areas 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.
You can teleport to them with /tp #{name of marked area}.
You can delete one /delete save {list number of marked area}.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/load prefab {name}
Or /load prefab {name} at {x} {y} {z} face {0-3}
Or /load prefab {name} here
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.
ACL: 2 restricted to owners, admins and mods, in-game only
/make maze (default maze 20 x 20)
Or /make maze wall {block name} fill {air block} width {number} length {number} height {number} x {x coord} y {y coord} z {z coord}
The bot also accepts wide, long, and tall instead of width, length, and height.
The maze will generate with no roof. If you want a roof add the word roof.
If you want a multi-level maze add levels {number}. Note: it will include a floor.
You will need to cut holes or make rooms yourself.
Generate and build a random maze. Someone must stay there until the maze completes or it will fail to spawn fully.
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.
Note: width and length are multiplied by 2.
ACL: 2 restricted to owners, admins and mods, in-game only
/reset chunk
Or /reset chunk wide {number}
Or /reset chunk wide {number} player {player}
Or /reset chunk {player}
Reset chunks at your position or where another player is standing.
When used with a player name, the player must be on the server.
When used on yourself, you must be in-game.
ACL: 0 restricted to server owners, in-game and IRC
/reset player profile {player name}
Make the server delete a player's profile.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/reset prefab {player name}
Reset a prefab where the player is standing. If doing on yourself in-game you only need /reset prefab.
ACL: 1 restricted to owners and admins, in-game and IRC
/reset regions now
Reboot the server and reset all reset regions immediately. (result varies subject to other settings)
ACL: 0 restricted to server owners, in-game and IRC
/undo
The block commands bm-prender, bm-pdup and bm-repblock 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.
ACL: 2 restricted to owners, admins and mods, in-game only
Player Group Commands:
Player group commands include commands for admins to create and manage player groups and the many settings that each group contains, plus commands to manage group membership.
Each group has its own copy of the bot's settings. These can be customised for the group and are the settings that are applied to all members in the group.
See also https://botman.nz/docs/guides/player-groups-noobie-guide for more detailed info with examples.
You can find more information about player groups in the following guide.
https://files.botman.nz/guides/Player_Groups_Noobie_Guide.pdf
/add (or /remove) group {group name}
Add or remove a player group.
When removing a player group, all players that are members of it will be removed from it.
ACL: 0 restricted to server owners, in-game and IRC
/group {number or name} add {name}
Or /group {number or name} add {name} expires {interval} to group {number or name}
/group {number or name} remove {name}
Add or remove a player from a group.
Players can only belong to one group at a time so adding them to a group automatically removes them from another.
You can also set an expiry after which the player is automatically removed from the group. If you specify a second group, they are automatically joined to it after the expiry or to no group.
ACL: 0 restricted to server owners, in-game and IRC
/copy group {number or name} to {new group name}
Make a new group using the settings from an existing group.
If the new group already exists, it's settings will be replaced with the settings from the first group.
Player group assignments will not be changed.
ACL: 0 restricted to server owners, in-game and IRC
/empty group {group number or name}
Remove all members of the group.
ACL: 0 restricted to server owners, in-game and IRC
/list group {number or name}
View a group's current settings.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list group members {group number or name}
See a list of players that belong to a group.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list groups
See a numbered list of the player groups.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/list no group
View the settings for everyone not in a group.
ACL: 2 restricted to owners, admins and mods, in-game and IRC
/move group members {old group number or name} to {new group number or name}
Move all members of a group to another group.
ACL: 0 restricted to server owners, in-game and IRC
/group settings
View info about group settings for use in /group {group} set {setting number} value {value}.
ACL: 1 restricted to owners and admins, in-game and IRC
/group {number or name} set {setting number from list} value {a value}
Change the value of one of the group's settings.
To see the numbered list of settings type /group settings and note the number of the setting you wish to change.
Depending on the setting, {a value} will be a number, or Y or N, or some text
For Y/N settings the bot will also accept yes/no, true/false, on/off or enabled/disabled.
ACL: 0 restricted to server owners, in-game and IRC
/no group set {setting number from list} value {a value}
Change the value of one of the bot's settings for players who are not in a group.
To see the numbered list of settings type /group settings and note the number of the setting you wish to change.
Depending on the setting, {a value} will be a number, or Y or N, or some text
For Y/N settings the bot will also accept yes/no, true/false, on/off or enabled/disabled.
ACL: 0 restricted to server owners, in-game and IRC
Custom Commands:
Custom commands are commands that you can create, add to or edit that can perform multiple actions.
/add command {command} message {custom message}
Add a custom command. Currently all it can do is send a private message. Later more actions will be added including the ability to add multiple actions.
ACL: 1 restricted to owners and admins, in-game and IRC
/remove command {command}
Remove a custom command.
ACL: 1 restricted to owners and admins, in-game and IRC
/list custom commands
List the custom commands.
Unrestricted command, in-game and IRC
Lounge Commands:
Lounge commands are commands bot commands that can only be used in The Lounge. These are not in-game commands and do not start with a /
Bot Commands On IRC (The Lounge):
help (display this list)
help manual (New to the bot and IRC? Read this.)
help setup (Stuff to do when the bot is new.)
help irc (View a different list of IRC command help including ingame commands that refer to IRC.)
fps (display current server performance metrics)
say {something} to talk to players ingame
staff (see who your admins are. You can also type owners, admins, or mods to just see a partial list)
server (server ip and port and number of players)
stop (stop the bot spamming you. If the command you ran has a lot of output, this stops it)
uptime (server and bot running times)
who (list in-game players)
Misc commands:
day, date or time (show the game date and time)
locations
new players (list new players in the last 2 days)
server status (some daily stats)
shop categories (list categories)
shop {category} (list items in a category)
shop {item} (list all items that partially match what you type)
villages (list)
If your login is not working properly try typing rescue me, hit return then login again.
help topics (display help topics only)
help commands (for ingame commands that you can also do in irc)
invite {player name} (Send the player a code and instructions to join irc and give themselves a password)
add player {playername} login {password} (create a password for an irc player to authenticate on irc).
bases (list all bases and their regions)
check dns player {player name} ip {ip} (tell bot to do a dns check on a player)
claims (list all players more than 1 placed claim and their total)
claims {player name} (list each placed claim for a player with coords)
date, time, day (display the current game date and time)
donors (list donors known to the bot)
friends {player name}
info {player name} (lots of quick info about a player)
inv {player name} (current inventory of player)
mute irc {player name} (prevent someone from using say and most other irc bot commands)
unmute irc {player name} (prevent someone from using say and most other irc bot commands)
list bad items
locations (list)
new players
pay {player name} {amount} (gift Zennies to a player or admin)
permaban {playername}
player {player name} friend {player to be friended}
player {player name} unfriend {player to be unfriended}
player {player name} (info on a specific player)
players (master list of all players)
prisoners (list)
remove permaban {playername}
resetzones (list)
server stats
status {player name}
stealth translate {player name} (ingame chat from the player will not be translated to irc only)
stop translating {player name} (ingame chat from the player will not be translated)
stop watching {player name}
teleports (list)
translate {player name} (ingame chat from the player will be translated ingame)
view alerts (lists the last 20) add a number for more
villagers (list villages and villagers)
watch player {player name}
who (list in-game players)
uptime
type say {something} to talk to players ingame
type pm {playername or id} PM a player ingame
type con {server command} (send a command to the server in console
help {keyword} (adding a new help system. As it grows, more keywords will be known to it.)
list help {optional section} (eg. admin, server). Short help, just a list.
command help {optional section} (eg. admin, server). Longer help with info.
Commands are divided into sections eg. admin, server, locations etc.
Command: help irc
Command: lounge commands
View all IRC (lounge) bot command help.
Command: use telnet
The bot will monitor the server using telnet and will not use Alloc's web API. Switching to this mode can fix some issues as there are several differences between the two modes with how the bot reads and processes the server traffic.
Command: use api
The bot will send commands to the server using Alloc's web API. Unless set elsewhere, the bot will still use telnet to listen to the server but with very few exceptions it will not send commands via telnet.
Command: reload code
Make the bot reload its code. It also performs some maintenance tasks on the bot's data.
Command: just reload code
Make the bot reload its code without doing any other maintenance tasks afterwards.
Command: reload admins
Make the bot read admin list
Command: reload bot
Make the bot read gg, admin list, ban list, version and lkp -online.
Command: update code
Make the bot check for code updates and apply them.
Command: map
View the URL where the server map should be located.
Command: server
View basic info about the server and installed mods.
Command: version
View the installed mods.
Command: bot info
Display basic info about the bot.
Command: search blacklist {IP}
See if an IP is in the blacklist or not.
Command: shop, or help shop
View the IRC help for the shop management.
Command: empty category {category name}
Delete everything from a shop category so you can start minty fresh.
Command: shop {category name}
List the items in the specified shop category.
Command: shop categories
List the shop categories.
Command: shop stock
List everything in the shop.
Command: shop {item name}
View an item in the shop.
Command: villages
List the villages and who the mayor is.
Command: fps
View the last recorded mem output. (updated every 40 seconds while players are online)
Command: help custom commands
View the help for custom commands.
Command: date, or time, or day
View the game day and time (not server time)
Command: uptime
See how long the bot and server have been running.
Command: location categories
List any defined location categories.
Command: location {name of location}
View info about a location.
Command: list location {name} spawns
A numbered list of random spawn points for a location.
Command: server stats
View basic stats about the server from the last 24 hours.
Command: who played today
List who played on the server in the last 24 hours in order of appearance.
Command: list help command {keyword}
Or list help command {keyword} full and/or notes
List all matching help commands from the bot's help commands table for use in changing the minimum access level required to use the command.
Optionally include the full command help and/or notes and examples for each matched command.
Command: set help command {keyword} number {number from list} access {new minimum access level. valid range (0-99)}
Set the minimum access level of a help command after using the command list help command {keyword}.
The list command gives you a numbered list. Using that number and THE SAME keyword you can change the access level of a previously listed command.
If you don't use the exact same keyword as before, you risk changing the access level of some other command which will have unintended consequences.
Command: help topics
View lounge command help topics.
Command: locations
List the locations.
Command: staff
List all of the admins.
Command: restore admin
Restore your admin status early if you used /test as player and the timer hasn't expired yet.
Command: logout
Log out of the bot on IRC (does not disconnect you from the IRC server).
Command: hi bot
Get the bot to respond to you. It will create a private chat channel as well as respond to you in the current channel.
Command: who
List everyone playing on the server right now. The info varies depending on if you are staff or player, logged in to the bot or not.
Command: login {name} pass {password}
Log in to the bot. Do NOT do this in any public channels (they start with a #). Do this only in the bot's private chat channel. If the bot sees this in a public channel it will destroy your login. If that happens, use the invite command to invite yourself to IRC. Follow the in-game prompts and you will get authenticated again.
Command: rescue me
This command fixes a weird and long standing bug where the bot can get mixed up between you on IRC and a random player. It doesn't give them admin commands but it does cause you to not be able to use them on IRC and the say command uses the other player name instead of yours. One day I shall find this bug!
Command: bow
Login to the bot without a password. Only works if you have previously been authenticated.
Command: help manual
Read the help manual. Its about a page and a half.
Command: help setup
View the help topic on setting up the bot.
Command: set server ip {IP}
Tell the bot the IP of the server that it is connected to. Due to a limitation in Mudlet it can't easily determine this for itself from the Mudlet profile.
Command: new login {name} pass {password}
Change your bot login.
Command: say {something man}
Say something publicly in-game to the players as yourself.
Command: sayfr {something to be translated}
Depreciated feature. It should work but requires a translation utility installed in Linux. I don't use it anymore as I host too many bots and don't want a big surprise bill from Google.
Command: command help
View the ingame command help in full including descriptions.
Command: list help
View the ingame command help minus the description texts.
Command: help server
View the server help topic
Command: help donors
View the donor help topic
Command: help csi
View the CSI help topic
Command: help watchlist
View the watchlist help topic
Command: help bad items
View the bad items help topic
Command: help announcements
View the rolling announcements help topic
Command: help commands
View the remote commands help topic
Command: help motd
View the message of the day help topic
Command: help access
View the access levels help topic
Command: reset zones
List the reset zones.
Command: stop
Stop the bot's current command output so you can issue a new command without waiting for the last one to finish.
Command: stop all
Stop the bot's IRC command output for everyone.
Command: rules {new rules}
View the server rules.
Command: invite {player name}
Send and IRC invite to a player. The bot will give them a series of simple instructions that they must follow in order to join the IRC server and be recognised by the bot. Also useful if you get your own bot login disabled, just invite yourself, join the server and /read mail or follow the prompts if you are already ingame.
Command: play (or join)
View the server ip, player port and basic version info so you can join the server by copy-pasting the ip and port into your game.
Command: fix bot
Restricted: Owners and Admins only
The bot will run a number of house-keeping tasks from data collection to database maintenance. The bot will appear frozen during this time until it has completed these tasks.
DO NOT repeat the command, just wait for it to complete. The bot will start talking again and shortly after will respond to new commands.
Command: add location category {category} {minimum access level} {maximum access level}
Add a location category and optionally assign a minimum access level and maximum access level (can be the same level.)
Command: remove location category
Remove a location category. It is also removed from all locations currently assigned to it.
Command: run report
View a report on server performance including how long the command lag is. The report recalculates continuously until stopped by typing stop report.
Command: stop report
Stop the running report.
Command: unmute irc {player}
Allow a player to use bot commands on IRC again.
Command: mute irc {player}
Block a player from commanding the bot on IRC.
Command: sql {a select statement}
Run a select query on the bot's database and view the output. It is limited to 100 records by default. Specify a different limit if you want more.
Only select queries are permitted. This is mainly intended for debugging purposes.
Only server owners can use this command.
Command: sqlmem {a select statement}
Run a select query on the bot's SQLite memory database and view the output. It is limited to 100 records by default. Specify a different limit if you want more.
Only select queries are permitted. This is mainly intended for debugging purposes.
Only server owners can use this command.
Command: sqltrak {a select statement}
Run a select query on the bot's SQLite tracking database and view the output. It is limited to 100 records by default. Specify a different limit if you want more.
Only select queries are permitted. This is mainly intended for debugging purposes.
Only server owners can use this command.
Command: sqltrakshadow {a select statement}
Run a select query on the bot's SQLite tracking shadow database and view the output. It is limited to 100 records by default. Specify a different limit if you want more.
Only select queries are permitted. This is mainly intended for debugging purposes.
Only server owners can use this command.
Command: sqlite {a select statement}
Run a select query on the bot's SQLite tracking database and view the output. It is limited to 100 records by default. Specify a different limit if you want more.
Only select queries are permitted. This is mainly intended for debugging purposes.
Only server owners can use this command.
Command: set irc server {IP:Port}
The bot will connect to the IRC server that you specify. If the IP and port are wrong, you will need to join the server and issue same command in-game but with a valid IP and port.
Only server owners can use this command.
Command: set server ip {server IP} port {telnet port} pass {telnet password}
Make the bot join a different 7 Days to Die server. All parts are required even if they are not changing.
Only server owners can use this command.
Command: restart bot
If your bot's server or the bot's launcher script monitors the bot's process ID, you can command the bot to shut down and restart itself. This can help to fix temporary problems with the bot.
All bots hosted at botmanhosting or hosted by Smegz0r can be restarted this way. The command is disabled by default.
Command: check disk
View basic information about disk usage on the server hosting the bot.
Command: command prefix {new in-game command prefix}
Change the in-game command prefix to something else. The default is / The bot can automatically change to ! if it detects some other server managers.
If there is a command clash between the bot and another manager or mod, you should use this command.
Command: server settings {optional filter}
View current settings in the bot, organised by category. You can view a specific category if you type it after settings.
The categories are: chat, shop, teleports, security, waypoints, misc, games, irc, mods.
The displayed settings may not be a complete list as the bot is still under development and new settings are added frequently.
Command: new players
List new players that have joined in the last 24 hours. To see further back, add a number eg: new players 5 will give you the last 5 days.
Command: check dns {player}
Make the bot do a DNS lookup on any player. Mainly useful if a player of interest is already in the game before the bot joined. Otherwise the bot will check their DNS only when the player re-logs.
Command: view alerts
Command: alert {number} status {your text here (max 100 length)}
Command: delete alert {number}
Command: delete alerts (delete all of them)
Command: view slots
View information about the bot's player slots and reserved slots.
Command: show inventory
View historic inventory movement of a player. They do not need to be playing right now.
eg. show inventory player Joe xpos 100 zpos 200 days 2 range 50 item tnt qty 20 exclude bob
eg. show inventory player Joe xpos 100 zpos 200 hours 1 range 50 item tnt qty 20 exclude bob
You can grab the coords from any player by adding, near john (for example)
Defaults: days = 1, range = 100km, xpos = 0, zpos = 0
Optional: player (or near) joe, days 1, hours 1, range 50, item tin, qty 10, xpos 0, zpos 0, session 1
Currently this command always reports up to the current time. Later you will be able to specify an end date and time.
Command: announcements
View the rolling announcements.
Command: add announcement
Add a new rolling announcement.
Command: delete announcement
If you type 'announcements' you will see a numbered list of rolling announcements. To delete a specific announcement type its number at the end of this command.
eg. delete announcement 3
Command: who visited
See who visited a player location or base.
Example with defaults: who visited player smeg days 1 range 10 height 4
Example with coords: who visited x 0 y 100 z 0 height 5 days 1 range 20
Another example: who visited player smeg base
Another example: who visited bed smeg
Setting hours will reset days to zero
Defaults: days = 1 or hours = 0, range = 10
This report could be very long. You can cancel it by typing nuke irc
Command: pay {player} {amount of Zennies}
eg. pay joe 1000. Joe will receive 1000 Zennies and will be alerted with a private message. You will also see a confirmation message that you have paid them.
Only owners and level 1 admins can do this on IRC.
Command: set player {name} cash {value}
Command: set player everyone cash {value}
Reset a player's cash to a specific amount to fix stuff-ups, or reset everyone's cash if you type everyone instead of a player name.
Command: set update branch {branch name}
Tell the bot to switch to a different code branch.
Command: enable/disable debug
If you have access to Mudlet you can enable or disable debug output to Mudlet's debug and lists windows. This automatically disables itself when Mudlet is closed.
Command: claims {optional player}
List all of the claims on the server or a specific player's claims.
Command: cmd {normal ingame command}
Use an in-game command from IRC. The command is identical to how you use it in-game except you prefix it with cmd. eg. cmd /uptime. Not all in-game commands allow you to use them from IRC and will tell you if you can't use them.
Command: pm {player} {message}
Command: con {console command}
Send a console command to the server. If you don't see the console output on IRC it will be a command that the bot doesn't pipe back to IRC. The command will still be sent. This feature is restricted to server owners.
Command: set bot owner {steam ID}
Assign a steam ID as owner of this bot. Only 1 steam ID can be the bot owner and this can only be assigned once.
This isn't currently used by the bot but will be used later.
To use this command you must be a level 0 admin and to have been seen on the server by the bot.
Command: villagers
List all of the villagers. It also shows who are the mayors.
Command: base cooldown {seconds}
Set a timer between uses of the /base or /home command. Donors wait half as long.
Command: set rules {new rules}
Change the server rules.
Command: motd
View the message of the day. You can clear it with motd clear.
Command: set motd {message}
Change the message of the day.
Command: set api port
Tell the bot what port the Alloc's API is using.
Command: set api key {API key from 7daystodie-servers.com}
Tell the bot your servers API key. DO NOT do this in a public channel!
Your key is not logged or displayed anywhere. It is kept out of the database too.
Once set, your players will be able to use the command /claim vote.
Command: list tables
List the bot's tables.
Command: show table {table name} {optional search string}
View the contents of one of the bot's tables. Not all tables will display but you'll soon work out which ones you can view.
Command: reset bot keep money
Make the bot forget map specific information but remember the player cash. Use this command after a map wipe.
Command: reset bot
Make the bot forget map specific information. Use this command after a map wipe.
Command: stop translating {player}
Stop sending a player's in-game chat to Google for translating.
Command: translate {player}
This command only works if a Linux utility called trans is installed. It uses Google Translate so I no longer use it since I don't want to risk a huge bill from Google. It worked great when I used to use it.
Command: stealth translate {player}
Only translate a player's in-game chat to IRC.
Command: open shop
Enable the shop so player's can buy stuff and spend their hard earned Zennies.
Command: close shop
Disable the shop. You'll soon see who can't live without it xD
Command: shop units {item} {new unit quantity}
Change the number of units sold per sale of the specified item.
Command: shop price {item} {new price}
Change the price of an item in the shop.
Command: shop quality {item} {new quality 0-6 or custom number}
Change the quality of an item given when buying a specific item in the shop.
Command: shop max {item} {max stock level}
Set the maximum quantity of an item for sale in the shop.
Command: shop restock {item} {quantity}
Increase the quantity of an item in the shop.
Command: shop add category {category name} code {short code}
Add a new category to the shop, such as weapons.
Command: shop remove category {category name}
Remove a category from the shop.
Command: shop change category {old category} to {new category}
Command: shop change category {old category} to {new category} code {new code}
Rename a shop category. All of its items will move to the new category.
Command: inv {player}
View the current or last known inventory of a player.
Command: list villagers {name of village}
List all of the village members of a specific village.
Command: list {optional player} bases
List all of the player bases or just those of one player.
Command: list bases near {x} {z} range {distance}
List all of the player bases within range of a coordinate.
Command: list beds {optional player}
List all of the player beds or just that of one player.
Command: add bad item {item name} action {exile, ban or timeout} (timeout is the default)
Add an item to the bad items list.
Command: remove bad item {item name}
Remove an item from the bad items list.
Command: bad item {item name} action {exile, ban or timeout}
Change what the bot does when it detects a specific bad item in inventory.
Command: near player {player}
Lists players, bases and locations near a player or coordinate.
Usage: near player {name}
optional: range {number}
optional: Instead of player use xpos {number} zpos {number}
Command: info {player}
View info about a player including links to some 7 Days related websites and the player's DNS record.
Command: add donor {player} expires {number} week or month or year
Give a player donor status. They get a few special privileges but it is not play to win. There are no game items included.
Command: remove donor {player}
Remove a player's donor status.
Command: add owner {player}
Give a player owner status which is the highest admin status in the bot and server.
Command: remove owner {player}
Remove an owner so they are just a regular player.
Command: add admin {player}
Give a player admin status. Note: This gives them level 1 admin status only.
Command: remove admin {player}
OUT! Remove an admin. They become a player again.
Command: permaban {jackass}
Ban and permanban a player. Not currently used by the bot, but the ban works.
Command: remove permaban {player}
Unban a player and remove their permaban status. Not currently used by the bot, but it will unban them.
Command: add player {player} login {name} pass {password}
Authorise a player to login to the bot here on IRC. They can login with login {name} pass {password}. They must not use that in any public channels, only in private with the bot or the bot will destroy their login.
Command: player {player one} unfriend {player two}
Make a player no longer friends with another player. Does not change friend status done through the game's own friend system.
Command: player {player one} friend {player two}
Make friends. No not you! Make a player friends with another player.
Command: friends {player}
View all of the friends of a player known to the bot or the game.
Command: players {optional player name}
Get a list of all of the players or a specific player (except archived players).
Command: archived players {optional player name}
Get a list of all the players that have been archived or a specific player.
Command: player {name}
Command: player {name} find {search string}
View the permanent record for a player or you can just list specific info using find. eg player smegz find home.
Command: sqlplayer {name}
Command: sqlplayer {name} find {search string}
View the shadow copy of a player record in the SQLite database (tables.sqlite) or you can just list specific info using find. eg sqlplayer smegz find home.
Command: archived player {name}
Command: archived player {name} find {search string}
View the permanent record for an archived player or you can just list specific info using find. eg archived player smegz find home.
Command: igplayer {name}
Command: igplayer {name} find {search string}
View the bot's record for a player that is currently on the server.
Command: igplayers
View the bot's record for each player that is currently on the server.
Command: whos
View compact list of players on server now.
Command: watch {player}
Command: stop watching {player}
Stop getting in-game messages about a player every time their inventory changes or they get too close to a base.
Command: donors {optional player name}
List all of the donors or a specific donor.
Command: teleports
List all of the teleports. These are not locations or waypoints. They are special teleports that players step onto in-game to get automatically teleported somewhere.
Command: list bad items
Command: prisoners
List all of the current prisoners. If a reason was recorded, that will be shown too.
Command: list all items
This command generates a text file called items.txt which you will find in the temp folder of your bot's daily logs folder.
It will have every item known to your server which you can use as a handy guide when adding items to your shop etc.
Command: list all entities
This command generates a text file called entities.txt which you will find in the temp folder of your bot's daily logs folder.
It will have every entity known to your server (except players) which you can use as a handy reference.
Command: li {item name}
List game items. eg. li boots, will list all items with boots in their name.
Command: status {player}
View some info about a player's bases and donor status.
Command: shop add item {item name} category {category} price {price} stock {max stock} units {units spawned} quality {0-6}
Add an item to the shop. If a unit is given and a player buys 1 item, the bot will give 1 * the unit eg. 10 of the item.
If quality is set to 0 the spawned item will have a random quality. You can set any number that is supported by your server (usually 1-6).
Command: empty shop
Completely empty the shop so you can start fresh.
Command: shop remove item {item name}
Remove an item from the shop.
Command: add command {command} access {minimum access level} message {private message}
Add a custom command. At the moment these are just a private message. Later more actions will be possible.
Command: remove command {command}
Delete a custom command.
Command: list commands
View the full list of custom commands.
Command: blacklist add {player}
Add a player to the bot's blacklist. The bot will ban them for 10 years.
Command: ban remove {player}
Unban a player.
Command: list event {event type}
Several events are logged and can be searched with list event. Select from any of the following or add a player name or steam ID.
eg. list event ban. Matching events in the last day are displayed. To see more days add a number eg. list event ban 5
Command: search player {name}
Search for a player by name. It will list any players that match your search.
Command: list duplicate players
Get a list of all players with the same name. Useful for fixing issues.
Command: add proxy {text to match} action {ban or exile}
Add a proxy for the bot to scan for and what action to take when it sees it.
Command: remove proxy {text}
Remove a proxy.
Command: list proxies
View all of the proxies that the bot checks for, how many hits each has had and what action the bot takes when it sees one.
Command: list regions
List all of the regions that contain a player base. Does not take into account parts of bases that cross into other regions.
Command: list restricted items
View the list of restricted items. These are items that new players aren't allowed.
Command: list entities
List all of entities currently in the world.
Command: near entity {entity ID}
View a list of players, bases and locations near a specific entity.
Command: delete old logs
This should happen daily but if for some reason logs are not being trimmed, you can make the bot delete old logs. Mainly useful if the daily maintenance not completing for some reason.
Command: help {command}
View help for an in-game command. You will see help for any commands that match your search based on keywords.
Command: get guides
The bot comes with a growing number of guides to help you learn how to use the bot. It will automatically grab them every 1-2 days but you can make it grab them immediately with this command.
Command: shop edit {category name}
Copy, edit, then paste the items in the specified shop category formatted for easy editing back into this chat.
Using your favourite text editor you can bulk edit all the items in a category with the bot commands ready to re-paste.
Command: shop edit stock
Copy, edit, then paste the items for the entire shop formatted for easy editing back into this chat.
Using your favourite text editor you can bulk edit all the items in the shop with the bot commands ready to re-paste.
Access Levels
Access levels control who can do what. Commands that are above a players level return unknown command.
Level 0 server owners
Level 1 admins
Level 2 mods
Level 3 - 89 custom admin levels
Level 90 Regular players
Level 99 New players
Customising The Bot And Server
reset bot (Do after a wipe. BE CAREFUL. This will make the bot forget map specific things like locations and bases.)
server ip {internet address of server} (to view just type server)
server ip:port pass {telnet password} (point the bot to a new 7 Days server)
set irc server ip:port (point the bot to a new irc server).
set rules {new rules} (to view just type rules)
See help motd for setting the message of the day
Forensic Investigative Tools
claims {player name} (list each placed claim for a player with coords)
info {player name} (lots of quick info about a player)
inv {player name} (current inventory of player)
near {player name} range {number} (list bases and players near a player. Range is optional and defaults to 200 metres.
show inventory (See built in help. Just type show inventory)
who visited (See built in help. Just type who visited)
view alerts (lists the last 20) add a number for more
Announcements Management
announcements (view a numbered list of the server announcements).
add announcement {your message here}
You can also set an announcement to trigger when the server time is a specific hour and minute. (Valid hour is 0-23 and minute 0-59)
add announcement time {hour:minute} {your message here}
eg. add announcement time 0:30 This is a test of the emergency broadcast syst.. *[i]radio static[/i]*
delete announcement {number} (from the numbered list given with announcements)
set rolling delay 10 (The next rolling announcement will happen every 10 minutes)
Custom Commands
You can create commands that send a private message.
Type list custom commands (list them)
Type add command {command} level {access level} message {message}.
Type remove command {command}.
Access level is optional and defaults to 99.
See help access for the list of access levels.
Bad Item (Uncraftable) Management
list bad items
add bad item {name of item as given by server}
remove bad item {name of item as given by server}
Any player caught with an item on this list will be sent to timeout or banned.
You can allow a player to have these items (except bedrock and smokestorm) with..
exclude {player name} (They can have bad items in inventory)
include {player name} (They may not have bad items on them)
Remote Server Commands
Most ingame commands can be done from IRC by putting 'cmd' in front. These commands do require a slash.
If an ingame command does not support running from IRC the bot will tell you.
For the full list type list help or for detailed help type command help. If you know the section you want add that eg list help server.
example. cmd /arrest {playername}
If you are a level 0 admin (owner) you can also send console commands to the server. Currently the bot must be in API mode or you will not see any feedback.
example. con help ban
Message Of The Day Management
motd (view the current message of the day if set).
motd clear (or motd delete).
set motd followed by anything else sets the message of the day.
Watchlist Management
Changes to player inventories can be sent to a channel called #watch
New players and watched players are automatically included.
To add a player type watch {player name}
To remove them type stop watching {player name}
The bot will automatically add players that are detected with certain items in unusual quantities.
Shop Manglement
empty shop (Everything must go! Deletes everything except the misc category which is a catchall)
shop categories (list categories)
shop {category} (list items in a category)
eg. shop food
shop {item} (list all items that partially match what you type)
shop add category {category name} code {code} (1 or more letters only)
eg. shop add category food code foo. Category name should be one word only.
shop remove category {category name}
eg. shop remove category food. Any items in the category are moved to the misc category which is an automatic catch-all category for stuff.
shop change category {old category} to {new category} code {new code}
eg. shop change category food to noms code nom. The food category becomes noms and the items in the food category move to the noms category with the code nom.
shop add item {item} category {a category} price {number} stock {number} units {number} quality {0-6 or custom quality number}
eg. shop add item armorLeatherBoots category clothing price 500 stock 100 units 1 quality 6
Units are how many of the item to spawn and quality is random if not specified and the server ignores quality for items that do not have a quality.
shop remove item {item}
eg. shop remove item armorLeatherBoots
shop price {item} {number}
eg. shop price armorLeatherBoots 100. Change the price of an item.
shop quality {item} {number}
eg. shop quality armorLeatherBoots 0. A quality of 0 will spawn a random quality of the item.
shop units {item} {number}
eg. shop units armorLeatherBoots 2. Buy one get one free!
shop restock {item} {number}
eg. shop restock armorLeatherBoots 100. Increase the stock of this item by 100.
open shop
close shop (staff can still access)
Special Bulk Editing Shop Commands
~*~*~*~*~*~*~*~*~*~*~*~*~*~*~
Use these commands along with a text editor to change multiple items at once.
Command: shop edit {category name}
Copy, edit, then paste the items in the specified shop category formatted for easy editing back into this chat.
Using your favourite text editor you can bulk edit all the items in a category with the bot commands ready to re-paste.
Command: shop edit stock
Copy, edit, then paste the items for the entire shop formatted for easy editing back into this chat.
Using your favourite text editor you can bulk edit all the items in the shop with the bot commands ready to re-paste.
Commands By Topic:
help announcements
help bad items
help commands
help custom commands
help CSI
help donors
help motd
help prefab (or botman)
help server
help shop
help watchlist