Reference
Commands
Every /pvpbot and /ghost command, grouped by topic.
You need the pvpbot.admin permission (ops by default). /bot is an alias of /pvpbot.
Values in < > are required, values in [ ] are optional, and | separates
alternatives. Wherever it says <selector> you can use a name, all, latest,
faction <name>, overfaction <name> or random[...]: see
Selectors.
Managing bots#
| Command | What it does |
|---|
/pvpbot spawn | Spawns a bot with a generated name where you stand (from the console: at the first world's spawn). |
/pvpbot spawn <name> | Spawns a bot with that name (16 characters at most). If an account has that name the bot wears its skin, otherwise a random one. |
/pvpbot spawn <name> <skinFrom> | Spawns a bot wearing the skin of the account skinFrom. |
/pvpbot spawn <name> none | Spawns the bot at once, without looking up a skin. Useful in scripts, where the next line must already find the bot. |
/pvpbot spawn <count> | Spawns up to 50 bots with generated names. |
/pvpbot spawn names:<table> <count> [skinFrom] | Spawns bots with names taken from a table in config.yml. With skinFrom the whole batch wears the same skin. |
/pvpbot remove <bot> | Removes a bot. |
/pvpbot removeall | Removes every bot. |
/pvpbot list | Lists the active bots. |
/pvpbot reload | Reloads config.yml and the other files. |
Combat orders#
| Command | What it does |
|---|
/pvpbot attack <bot> <target> | The bot hunts a player or another bot, by name. |
/pvpbot fight <bot> <bot> | Two bots fight each other, even with bot-vs-bot off. |
/pvpbot stop <bot> | Clears the bot's orders and stops it fighting. |
/pvpbot retreat <selector> [to <player|x y z>] | Fall back. Without to every bot runs its own way; with to they regroup on a player (followed as they move) or at coordinates. Outranks follow, guard and attack until called off. |
/pvpbot retreat stop <selector> | Calls off the retreat. |
/pvpbot hide <selector> | The bot hides: with an invisibility potion it drinks it and takes its armour off, without one it crouches. It stops starting fights but keeps following orders, and comes out by itself when an enemy is close and can see it. |
/pvpbot hide stop <selector> | Brings the bot out of hiding. |
/pvpbot tether <target> <leader> <selector> [radius] | A leash: the bots escort the target and make sure it stays within radius blocks (default 20, 1 to 512) of the leader. See Tether. |
/pvpbot tether stop <target> | Releases the target and stands the escort down. |
/pvpbot tether info <target> | Shows the tether's state. |
Movement and positioning#
| Command | What it does |
|---|
/pvpbot follow <selector> <target> [formation] | Escort a player or a bot. Formations: behind (default), circle, open_circle. Followers fight when attacked, then fall back in. |
/pvpbot follow stop <bot|all> | Stop following. |
/pvpbot guard <bot|all|faction <name>> <radius> [x y z] | Hold a spot (your position or the coordinates) within a radius of 2 to 128 blocks (default 12). Attacks anyone who comes in, and walks back to its post if a fight pulls it too far. Alias: protect. |
/pvpbot guard stop [bot|all] | Stands the guards down. |
/pvpbot pause <bot|all|faction <name>> | Suspends the AI: the bot stays in the world, falls and takes damage, but does nothing. With no argument, lists the paused bots. |
/pvpbot resume <bot|all|faction <name>> | Turns the AI back on. Alias: unpause. |
/pvpbot tp <bot|all|faction <name>> <player|bot|x y z> | Instant teleport. |
Squad teleport#
Three showy ways to bring a group somewhere. range is how far around the destination the bots are scattered (default 100, at most 1000).
| Command | What it does |
|---|
/pvpbot tp portal [ground] <selector> <player|bot|x y z> [range] | Opens real nether portals (obsidian frame, lit inside) around the destination and has the bots step out: up to 3 per portal, which may float; with ground portals always sit on the ground and up to 5 share one. The portals stay and never lead to the Nether. |
/pvpbot tp pearl <selector> <player|bot|x y z> [range] | Each bot arrives on a real ender pearl thrown from high above: real flight, landing and a little fall damage. |
/pvpbot tp rift [big] <selector> <player|bot|x y z> [range] | Tears in reality that close right behind the bots: up to 5 per rift, or one big shared rift with big. |
Patrol routes#
You build a route by walking it: create the route, then add a point at each spot you stop at.
| Command | What it does |
|---|
/pvpbot path create <name> | Creates an empty route. |
/pvpbot path add <name> | Adds your position as the next point (in-game only). |
/pvpbot path remove <name> <index> | Removes a point. |
/pvpbot path delete <name> | Deletes the route and stops anyone walking it. |
/pvpbot path list [name] | Lists the routes, or one route's points. |
/pvpbot path assign <selector> <route> | Sends the bots to patrol the route. |
/pvpbot path stop <selector> | Stops the patrol. |
Settings#
| Command | What it does |
|---|
/pvpbot set <setting> <value> | Changes a global setting, live and for good (it is written to config.yml). |
/pvpbot settings [group|text] | Shows the current values, by group (general, combat, movement, utility, ranged, building, detection) or filtered by name. * marks a default not yet written to the file. |
/pvpbot faction set <faction> <setting> <value> | Changes a setting for one faction only. |
/pvpbot preset [name] | With no name, shows the active preset and the ones available; with a name, applies it. |
/pvpbot preset save <name> | Saves the values in force right now as a preset (overwrites if it exists). |
/pvpbot preset delete <name> | Deletes a preset. |
/pvpbot preset off | Turns the preset off: back to config.yml as written. |
Factions#
Alias: /pvpbot f. Details on Factions.
| Command | What it does |
|---|
/pvpbot faction create <name> | Creates a faction. |
/pvpbot faction disband <name> | Disbands a faction. |
/pvpbot faction join <faction> <member|selector> | Adds a player or bots. |
/pvpbot faction join <faction> range <blocks> | Adds every bot within that distance of you (0–512). |
/pvpbot faction leave <member> | Removes a member from their faction. |
/pvpbot faction hostile <a> <b> | War: they attack each other on sight. |
/pvpbot faction peace <a> <b> | Peace: neither side starts anything, but both hit back. |
/pvpbot faction ally <a> <b> | Alliance: the same side, each with its own settings. |
/pvpbot faction unally <a> <b> | Ends the alliance. |
/pvpbot faction leader <faction> <player|bot|clear> | Sets or clears the leader. |
/pvpbot faction follow <faction> <target|stop> [formation] | The whole faction follows someone. |
/pvpbot faction kit <faction> set <kit> <weight> | Adds a kit to the faction's random kit table (weight 0–1000, 0 removes it). |
/pvpbot faction kit <faction> list|clear|give | Shows the odds, empties the table, or rolls and hands a kit to every bot. |
/pvpbot faction info <name> | Members, leader, allies, enemies and factions at peace. |
/pvpbot faction list | Lists the factions. |
Overfactions#
Coalitions of factions. Alias: /pvpbot of.
| Command | What it does |
|---|
/pvpbot overfaction create|disband <name> | Creates or disbands a coalition. |
/pvpbot overfaction add <overfaction> <faction> | Adds a faction: it becomes allied with every other one inside. |
/pvpbot overfaction remove <faction> | Takes a faction out of its coalition. |
/pvpbot overfaction hostile|peace <a> <b> | War or peace between two coalitions, or a coalition and a single faction, in one go. |
/pvpbot overfaction leader <overfaction> <player|bot|clear> | A leader for the whole coalition. |
/pvpbot overfaction follow <overfaction> <target|stop> [formation] | The whole coalition follows someone. |
/pvpbot overfaction tp <overfaction> <player|bot|x y z> | Teleports the whole coalition. |
/pvpbot overfaction info|list | Info and list. |
Kits#
| Command | What it does |
|---|
/pvpbot kit save <name> [bot] | Saves your inventory as a kit, or a bot's. |
/pvpbot kit give <kit> <player|selector> | Gives the kit to a player (real ones too) or to bots. |
/pvpbot kit givefaction <kit> <faction|selector> | Gives the kit to every bot in a faction. |
/pvpbot kit delete <name> | Deletes a kit. |
/pvpbot kit list | Lists the kits. |
Scripts#
Details on Scripts.
| Command | What it does |
|---|
/pvpbot script create <name> | Creates an empty script. |
/pvpbot script add <name> <command> | Adds a line (no leading slash). {1}…{9} are the parameters, wait <ticks> is a pause. |
/pvpbot script show <name> | Shows the numbered lines. |
/pvpbot script remove <name> <line> | Removes a line. |
/pvpbot script delete <name> | Deletes the script. |
/pvpbot script run <name> [args...] | Runs the script as if you typed it. |
/pvpbot script list | Lists the scripts. |
Companions#
Details on Companions.
| Command | What it does |
|---|
/pvpbot owner set <bot> <player> | Hands the bot to an online player, who can then command it in chat. |
/pvpbot owner clear <bot> | Removes the owner. |
/pvpbot owner list <player> | A player's bots. |
/pvpbot owner help | Summary of the chat orders. |
| Command | What it does |
|---|
/pvpbot diagnose <bot> | Works out why a bot can't fight (login plugins, invulnerability, damage cancelled by another plugin) and suggests the fix. |
/pvpbot debug <bot> | The bot's internal state: awareness, building, clutch, faction. |
/pvpbot debug <bot> invulnerable <true|false> | Forces the vanilla invulnerable flag, to reproduce a problem. |
/pvpbot givebow <bot> | Gives the bot a bow and arrows. |
/pvpbot drop <bot> <item id> [amount] | Drops an item at the bot's feet (vanilla id, e.g. diamond_sword). |
/pvpbot resetattr <player|bot> | Removes every attribute modifier left by other plugins (bosses, items, roles) and restores the base values. Alias: resetattributes. |
/pvpbot clearplayerdata | Deletes the player files (data, stats, advancements) of bots that no longer exist. Leaves kits, factions, scripts and config alone. |
Ghosts#
Details on Ghosts.
| Command | What it does |
|---|
/ghost record <name> | Starts recording your movement (and the blocks you break or place). |
/ghost stoprecord | Stops and saves the recording. |
/ghost spawn <name> <recording> [skin:<name>|skin:none] [line1|line2|...] | Spawns a ghost that replays the recording forever. |
/ghost stare <name> [skin:<name>|skin:none] [line1|line2|...] | Spawns a still ghost that stares at the nearest player and vanishes when someone comes close. |
/ghost remove <name> | Removes a ghost. |
/ghost list | Lists the ghosts. |
/ghost recordings | Lists the recordings. |