Content generated with AI — it may contain mistakes.

Configuring

Equipment

The armour, weapon, off hand, knockback and potion buffs a bot wears, where its first kit comes from, and what each one changes in a fight.

A bot is dressed by fourteen settings: four armour pieces, an enchantment for each of them, a weapon, an off hand, a knockback level, strength, speed and fire resistance. Every one of them is a button in /bot — the armour column down the left of the main menu, the hands down the right, fire resistance in Fine tuning. Nothing here is a number you have to balance: the mode you pick already dressed the bot, and these are the pieces you change afterwards.

What you can change

SettingValuesWhere
Helmet, chestplate, leggings, bootsNONE, DIAMOND, NETHERITEMain menu, left-click the piece
The enchantment on each pieceNONE, PROTECTION, BLAST_PROTECTIONMain menu, right-click the piece
Main handSWORD, AXE, MACE, TOTEMMain menu, left-click Main hand
Knockback on that weaponNONE, KNOCKBACK_1, KNOCKBACK_2Main menu, right-click Main hand
Off handNONE, TOTEM, SHIELDMain menu, Off hand
StrengthNONE, STRENGTH_1, STRENGTH_2Main menu, left-click Potions
SpeedNONE, SPEED_1, SPEED_2Main menu, right-click Potions
Fire resistanceon or offFine tuning

Every button steps forward through its list and wraps around at the end, so a piece you overshot is three more clicks away rather than a menu away. The names you read on the buttons — Diamond, Protection IV, Strength II — are labels in messages.yml and can be renamed or recoloured; the values above are the ones the plugin stores.

Where the first kit comes from

A player who has never opened /bot is dressed by whatever bot.mode says in config.yml. Each mode has one kit, and it is the kit that mode is balanced around:

ModeArmourEnchantmentMain handOff handStrengthSpeed
NONEDiamondProtectionSwordShield——
SWORDDiamondProtectionSwordShield——
POT_PVPDiamondProtectionSwordShieldStrength IISpeed II
UHCDiamondProtectionAxeShield——
CRYSTAL_PVPNetheriteBlast ProtectionSwordTotem——
MACE_PVPNetheriteProtectionMaceTotem——
BOXING——Sword———

A kit is uniform: all four pieces are the same tier with the same enchantment, which is what makes picking a mode one decision instead of eight. Mixing tiers afterwards is a per-piece choice and stays one. Two of the kits are deliberately bare — UHC carries no potion buffs because in UHC what you drink is what you brewed, and boxing wears no armour and holds nothing in the off hand because nobody is taking damage.

Changing mode does not re-dress the bot

The kit is applied when a player's settings are first created and every time they are reset. Cycling Mode in the menu afterwards changes the techniques the bot fights with and leaves the gear exactly as you left it. If you want a mode's own kit back, use Reset settings or /bot reset — that puts every setting back to the server default, kit included.

Armour

Three tiers per slot, chosen per slot.

ValueWhat goes on the bot
NONEThe slot is left empty.
DIAMONDThe diamond piece for that slot.
NETHERITEThe netherite piece for that slot.

Every piece is unbreakable, so a long session never wears the bot's kit down.

Enchantment

One enchantment per piece, at level IV.

ValueWhat goes on the piece
NONENothing.
PROTECTIONProtection IV.
BLAST_PROTECTIONBlast Protection IV — what a crystal fight is fought in.

Main hand

The weapon decides how often the bot may swing, because the bot waits for its attack bar the way a player does. Every shipped mode fights under modern combat rules, so the cooldown below is the real one.

ValueItemFull charge
SWORDNetherite sword12.5 ticks
AXENetherite axe20 ticks
MACEMace33.3 ticks
TOTEMTotem of Undying4 ticks

Three of them change more than the cadence:

  • An axe breaks a raised shield, and the bot knows it — this is the weapon the UHC kit carries.
  • A mace earns the vanilla smash bonus when the bot lands on you from a height, which is the whole of MACE_PVP.
  • A totem is not a weapon. The bot holds it, hits for almost nothing and swings four times a second, which is a bot that is there to be hit.

The weapon is built unbreakable with Unbreaking III. Attack damage is not read off the item: it is the attack_damage slider in Fine tuning, and the cooldown scaling and critical hits vanilla applies go on top of it.

Knockback

Knockback is an enchantment on the weapon, so it moves with the weapon.

ValueLevel
NONENot enchanted at all
KNOCKBACK_1Knockback I
KNOCKBACK_2Knockback II

Off hand

ValueWhat the bot holdsWhat it means
NONENothingBoxing carries nothing there, and neither does anybody who wants their movement.
TOTEMTotem of UndyingThe bot pops it and re-arms from its totem reserve.
SHIELDAn unbreakable shieldRaised and dropped on a timer, so it can be read — and disabled by your axe for the number of seconds in shield_disable.

How many spare totems the bot re-arms with is the totems slider in Fine tuning, not a setting on this page; see Limits.

Strength and Speed

Both are the vanilla potions, applied to the bot permanently and shown on it — the swirls are how an opponent knows what they are fighting.

ValueEffectWhat it does
NONE—The effect is removed.
STRENGTH_1Strength I+3 damage on every hit.
STRENGTH_2Strength II+6 damage on every hit.
SPEED_1Speed IMoves 1.2× as fast.
SPEED_2Speed IIMoves 1.4× as fast.

The damage and the movement are applied by the AI itself, exactly as the potion would; the effect on the bot exists so you can see it.

POT_PVP is the only shipped kit that starts with either of them, and it starts with both at level II.

Fire resistance

A permanent Fire Resistance effect, toggled from Fine tuning. No shipped kit starts with it — it is there for a sandbox where lava is part of the practice, which is what the UHC mode's lava technique makes it.

Golden apples

Which apple the bot eats is not a button. It is decided for it:

SituationWhat it eats
Pot PvP, no kit sent by another pluginEnchanted golden apples if advanced.pot-pvp.enchanted-apples is on, plain ones otherwise.
UHC, no kit sentPlain golden apples. UHC has no splash potions, so the apple is the only heal there is.
Either mode, with a kit sentWhichever apple the kit actually holds — enchanted if there are any in it, plain otherwise.

When the gear is not yours

Another plugin can spawn a bot through the API with a kit of its own, and that kit outranks everything on this page: the armour, the weapon and the off hand come from the items, and what the bot can spend during the fight is counted out of the same kit. A player's saved settings are theirs and have no say in what a duel opponent wears. See API.

Something missing on this page? Tell us on Discord