Your bots
Difficulty and cheats
Make bots sharper or clumsier, and optionally give them a head start with cheats.
While the play style decides what a bot likes to do, the difficulty decides how well it does it: how fast it reacts, how well it aims, how far it sees and how good its decisions are.
The four difficulties
| Difficulty | Id | What it’s like |
|---|---|---|
| Easy | aiplayers:easy | Slow to react, misses a lot, has a narrow field of view and doesn’t notice things far away. Can’t parkour, runs from creepers, stays indoors at night, never goes to the End and sometimes makes a less-than-best choice. A good sparring partner. |
| Normal | aiplayers:normal | A decent player: fights creepers when armed, works through the night on safe ground (and raids by night), and makes solid choices. The default for new bots. |
| Hard | aiplayers:hard | Quick reflexes, good aim, sees farther and almost always makes the best call. |
| Expert | aiplayers:expert | Instant reactions, near-perfect aim, a very wide view and flawless decisions. Fighting one is a real challenge. |
Change a bot’s difficulty at any time:
/aiplayer set Steve difficulty aiplayers:hardDifficulty never lets a bot break the rules. An Expert bot still mines at normal speed, needs the right tools and can only hit what it can reach. It’s just better at playing.
Cheats
By default, bots play fair. If you’d like to give them a head start, a difficulty can include three optional cheats:
- Starting kit: a set of items the bot gets each time it spawns or respawns (once per life).
- Resource gifts: items handed to the bot at a regular interval, like 4 cobblestone every minute.
- Revealed enemy bases: the bot knows each enemy faction’s base (its chests and what’s in them, its gates and golems) as confirmed knowledge, with no scouting. Handy for showcase servers, since a raider’s first trip goes straight for a chest.
Cheats never give experience, enchantments or teleports. The kit and the gifts only put items in the bot’s inventory (whatever doesn’t fit is dropped at its feet). The reveal only writes knowledge a player would otherwise have to earn by watching.
Turning cheats on
Cheats need two switches, so nobody can turn them on by accident:
-
The server owner allows them by setting
cheats_allowedtotruein the server configuration. -
An operator turns them on for a specific bot:
Command /aiplayer set Steve cheats true
The four shipped difficulties don’t include any cheats, so you also need a difficulty that does. Creating one takes a small data pack, explained in Difficulty files.
Technical details
The difficulties' numbers
| Key | Easy | Normal | Hard | Expert |
|---|---|---|---|---|
reaction_ticks | 8 | 4 | 2 | 0 |
aim_error_degrees | 6.0 | 3.0 | 1.5 | 0.5 |
fov_degrees | 150 | 180 | 200 | 220 |
perception_radius | 24 | 32 | 40 | 48 |
path_max_nodes | 10000 | 20000 | 30000 | 40000 |
path_max_millis | 100 | 200 | 300 | 400 |
decision_quality | 0.7 | 0.9 | 0.97 | 1.0 |
combat_skill | 0.4 | 0.7 | 0.85 | 1.0 |
parkour | no | yes | yes | yes |
creeper_tactic | flee | fight | fight | fight |
night_work | no | yes | yes | yes |
end_dragon | no | yes | yes | yes |
reaction_ticks: how long the bot takes to notice something it sees (and to raise its shield).aim_error_degrees: how much its arrows spread.fov_degreesandperception_radius: how wide and how far it sees.path_max_nodesandpath_max_millis: how hard it thinks about a route before settling for a partial one. The milliseconds count on the server’s bot clock, so an operator can speed every bot’s thinking up or down without editing difficulties.decision_quality: below 1, the bot occasionally picks its second-best option.combat_skill: delays each swing by up to (1 − skill) × 10 ticks, and is the chance it tries a critical hit.parkour: whether it jumps over one- and two-block gaps.creeper_tactic: whether a fit bot armed with a sword or axe fights creepers with hit-and-step-back (fight) or always runs (flee).night_work: whether a sheltered bot works through the night on safe ground (yes) or heads indoors at dusk and idles until dawn (no).end_dragon: whether the bot may go to the End at all. Withno, no style sends it there and anendorder is refused.threats: a difficulty file can also tune how dangerous each Overworld, Nether and End monster is considered when fleeing or sizing up a fight (the dragon weighs 6, a shulker 2).
The format is described in Difficulty files.
How cheats are applied
The starting kit is given once per life: at the bot’s first check after spawning, then after each respawn
(unless the bot is set to permadeath). Reconnects and server restarts don’t give it again. The resource gift
is given every interval_minutes of world time, counted from the last gift (0 turns it off). Each cheat
writes a line to the server log, for example
Cheat for AI player Ann: starting kit (respawn): breadx3. A bot with cheats on while the server forbids them
logs one notice and gets nothing. The revealed enemy bases hand out no items. Instead, copies of the enemy
factions’ own base records go straight into the bot’s knowledge. They’re checked every second and rewritten
when they’d change or once they’re older than a minute. While the cheat is in effect the bot never scouts,
since there’s nothing left to find. All three cheats sit behind the same two switches.
Last updated Oct 30, 2026