Wiki
Every command, what each equipment slot does, and the fixes for the things that usually go wrong.
Commands
Everything runs under /fightbot, shortened to /fb. The permission is fightbot.use, which defaults to OP.
Spawning
| Command | What it does |
|---|---|
| /fightbot spawn <name> | Spawns one bot with the name you give it, where you're standing. |
| /fightbot spawn --random [count] | Spawns 1 to 50 bots with random player-style names. |
Fighting
| /fightbot fight <bot> <player...> | Sends one bot after one or more players. |
| /fightbot fight --all <player...> | Sends every bot after those players. |
| /fightbot fight --group <group> <player...> | Sends a whole group after players. |
| /fightbot fight --group <A> <B> | Sets two groups on each other. Good for watching. |
| /fightbot stop <bot|--all> | Calls them off. |
Managing bots
| /fightbot list | Shows every live bot and group. |
| /fightbot remove <bot|--all> | Deletes bots. |
| /fightbot edit clone <bot> <name|--random> | Copies a bot, gear and inventory included — and it joins the fight the original is in. |
| /fightbot edit change <bot> <name|--random> | Renames a bot. |
Moving them
| /fightbot tp <bot> <player> | Teleports a bot to a player. |
| /fightbot tp <bot> <x> <y> <z> | Teleports a bot to coordinates. |
| /fightbot tp --all <player|x y z> | Teleports every bot at once. |
| /fightbot tp --group <group> <player|x y z> | Teleports a group. |
Equipment
Right‑click any bot in creative mode to open its equipment screen. Every slot maps to a behaviour: give the bot the item and it will use it.
| Slots | Contents |
|---|---|
| 1–4 | Helmet, chestplate, leggings, boots |
| 5 | Offhand — totem or shield |
| 6 | Main hand — its weapon |
| 7 | Axe, used to break raised shields |
| 8 | Food, for eating and regen |
| 9 | Cobwebs |
| 10 | Ender pearls |
| 11 | Water bucket, for clutching |
| 12–14 | Held back for mace and crystal gear |
| 15+ | Storage — anything the bot picks up lands here |
When a hotbar slot empties mid‑fight the bot refills it from storage, so stack spare pearls or totems in the back and it keeps going. Slot positions and item behaviour can all be moved around in config.yml.
Groups
Groups let you command several bots at once, and make them retaliate together.
/fightbot group create redteam /fightbot group add redteam Kade /fightbot group list redteam
| /fightbot group create <name> | Makes a group. |
| /fightbot group add <group> <bot> | Puts a bot in it. |
| /fightbot group list [group] | Lists groups, or one group's members. |
| /fightbot group edit remove <group> <bot> | Takes a bot out. |
| /fightbot group edit change <old> <new> | Renames a group. |
| /fightbot group remove <group> | Deletes it. |
With two groups you can set them on each other and watch, or drop yourself into the middle of one:
/fightbot fight --group redteam blueteam
Roaming
Roaming bots wander instead of hunting. They stay peaceful until something hits them.
/fightbot roam Kade /fightbot roam --group redteam /fightbot roam --all
Hit a roaming bot and it fights back. Hit one that's in a group and every bot in that group comes for you — worth knowing before you punch one for fun.
Patrols
Waypoint loops, for bots that walk a route rather than wandering.
| /fightbot patrol add <bot> | Saves where you're standing as a waypoint. |
| /fightbot patrol start <bot> | Starts the bot walking the loop. |
| /fightbot patrol stop <bot> | Stops it. |
| /fightbot patrol list <bot> | Shows the bot's waypoints. |
| /fightbot patrol clear <bot> | Wipes them. |
Config
Two files sit in the plugin's folder:
- config.yml — bot health, speed, damage, and which equipment slot does what.
- botnames.yml — the pool that --random pulls names from.
Edit either, then reload without restarting:
/fightbot reload
/fightbot remove --all /fightbot spawn --random 1
Troubleshooting
The plugin won't load
Check your server is on 1.16 or newer. If you're running a build below 4.1.0, install the free LibsDisguises alongside it — older builds rely on it. From 4.1.0 onward you don't need it.
Bots look like zombies
Same thing: an old build without LibsDisguises. Update to the newest release and it goes away.
A bot just stands there
It hasn't been told to fight anyone. Run /fightbot fight <bot> <you>. If it's already fighting and still frozen, it probably can't path to you — try it on flatter ground first.
Bots move slowly
Check the speed value in config.yml, and remember it only applies to newly spawned bots — clear and respawn after changing it. If it started after updating to a beta, roll back to the last full release and report it in Discord with your server version.
Config changes did nothing
Health, speed and damage only apply to newly spawned bots. Remove the existing ones and spawn fresh.
Something else
Report it in Discord with your server version, your plugin version and anything the console printed. Bug reports there are what drive most updates.