FightBot

Paper's Most Complex Combat Plugin

Spawn AI-powered combat bots that fight, roam, retaliate, and march. FightBot is a full combat AI system built on top of Paper's entity engine — bots that behave like real players, equippable through an in-game inventory, organized into groups, and capable of coordinated tactical behavior.

Why FightBot?

Most combat plugins spawn a zombie and call it a day. FightBot goes further:

Bots look like players thanks to LibsDisguises
Bots fight like players — critting, sprinting, dodging, retreating to heal
Bots roam freely and retaliate when attacked, alerting their group-mates
Bots are fully equippable via a right-click inventory GUI
Everything is group-based — command entire armies with one command

Features

Advanced Combat AI

Critical hits — 30% chance to deal 1.5x damage with visible crit particles
Sprint attacks — burst of speed toward the target every 3 seconds for bonus knockback
Dodge — bots sidestep incoming projectiles automatically
Surround formation — multiple bots spread evenly around the target, attacking from all sides
Retreat and heal — bots disengage at 2 hearts, back off, regen 1 heart per second, then re-engage at full health
Lava and void detection — bots detect dangerous terrain ahead and steer clear
Bridge building — if the target is above and the bot is stuck, it jumps and places cobblestone to climb up

Roam Mode

Put bots into roam mode and they wander freely — no target, no aggression. The moment a player hits a roaming bot:

The bot immediately retaliates and fights back
Every other bot in the same group also joins the fight against that player

Perfect for ambush scenarios, guard bots, and PvE events.

Group System

Create named groups of bots
Send an entire group to fight players at once
Group vs Group battles — pit two bot armies against each other
Rename, edit, and remove groups at any time

Full Equipment System

Right-click any bot in Creative mode to open its personal inventory GUI
Dedicated slots for helmet, chestplate, leggings, boots, offhand, and weapon
Storage slots for potions, food, and totems
All equipped gear drops on death
Equipment persists between inventory opens

Death Events

Chat broadcast: [BotName] was killed by [Player]
Followed by: [BotName] left the game
Wither spawn sound plays for all online players

Fully Configurable

config.yml — tune every combat stat: crit chance, retreat threshold, heal rate, speed, damage
botnames.yml — customize the random name pool with as many names as you want

Commands

Permission: fightbot.use — default op

Spawn

/fightbot spawn <name>
/fightbot spawn --random <count>

Fight

/fightbot fight <bot> <player> [player2...]
/fightbot fight --all <player> [player2...]
/fightbot fight --group <groupA> <groupB>

Roam

/fightbot roam <bot>
/fightbot roam --all
/fightbot roam --group <group>

Stop

/fightbot stop <bot|--all>

Stops fighting, roaming, or any other active behavior.

Management

/fightbot remove <bot|--all>
/fightbot list
/fightbot edit <bot> clone <name|--random>
/fightbot edit <bot> change <new name>

Groups

/fightbot group create <name>
/fightbot group add <bot> <group>
/fightbot group list
/fightbot group edit <group> remove <bot>
/fightbot group edit <group> change <new name>
/fightbot group remove <group>

Configuration

plugins/FightBot/config.yml

crit-chance: 0.30        # Crit hit probability (0.0 to 1.0)
retreat-health: 4.0      # HP to start retreating (4 = 2 hearts)
heal-rate: 2.0           # HP healed per second while retreating
move-speed: 0.32         # Bot movement speed
attack-damage: 6.0       # Base attack damage in HP

plugins/FightBot/botnames.yml

names:
  - BlockBuddy22
  - CraftyAlex99
  # Add or remove as many names as you want

Requirements

Paper 1.21.x
LibsDisguises (free version works)

Not compatible with Spigot or CraftBukkit.

Quick Start

1. Drop FightBot.jar and LibsDisguises.jar into /plugins
2. Restart your server
3. /fightbot spawn --random 5
4. /fightbot roam --all         (bots wander freely)
5. Hit one — watch the whole group retaliate

Permissions

Permission	Description	Default
`fightbot.use`	Full access to all FightBot commands	op

Built for Paper 1.21.x — pushing the limits of what server-side combat AI can do.

Paper Fight Bot