AI Players
Type to search documentation.

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

DifficultyIdWhat it’s like
Easyaiplayers:easySlow 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.
Normalaiplayers:normalA 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.
Hardaiplayers:hardQuick reflexes, good aim, sees farther and almost always makes the best call.
Expertaiplayers:expertInstant 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:

Command
/aiplayer set Steve difficulty aiplayers:hard

Difficulty 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:

  1. The server owner allows them by setting cheats_allowed to true in the server configuration.

  2. 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
KeyEasyNormalHardExpert
reaction_ticks8420
aim_error_degrees6.03.01.50.5
fov_degrees150180200220
perception_radius24324048
path_max_nodes10000200003000040000
path_max_millis100200300400
decision_quality0.70.90.971.0
combat_skill0.40.70.851.0
parkournoyesyesyes
creeper_tacticfleefightfightfight
night_worknoyesyesyes
end_dragonnoyesyesyes
  • 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_degrees and perception_radius: how wide and how far it sees.
  • path_max_nodes and path_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. With no, no style sends it there and an end order 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