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.