Your bots
How bots live
What a bot does on its own, from its first minutes in the world to a thriving base, and how it decides what comes next.
Once you spawn a bot, it plays survival on its own, the way a player would. It starts with nothing, then gathers, crafts and builds its way up from there.
The first day
A brand-new bot starts with an empty inventory. Its first day usually goes like this:
- Wood and stone tools. It looks for a tree and chops logs (towering up to high logs or cutting through leaves if needed). It crafts planks, sticks and a crafting table, makes wooden tools, and digs stone for a stone pickaxe, axe and sword. A bot with no sword and no axe at all makes a sword before anything else (stone from two cobblestone, else wood), so it never goes underground unarmed.
- A home first. As soon as it holds a stone pickaxe, building its first house becomes its top priority, ahead of mining for iron, so every style with a base gets a roof over its head. It checks that it can walk to the site and levels or cuts into rough ground if needed. Before the walls rise it sows a small crop plot beside the site, since wheat takes days to ripen (the first plot). Behind the site it opens a small quarry, a staircase down and a gallery along its bottom, and digs until it holds the cobblestone the house lacks (it never digs a pit under its own feet). Then it puts up a small house with a door of the wood it holds, a torch, a chest, a crafting table it keeps for good, a furnace, and a bed if sheep are around.
- Cooked food. When it hunts animals, it smelts the raw meat in a furnace, so it carries steak, cooked porkchops or mutton instead of raw drops. It keeps a nourishing stack on hand, and once it has stone tools it treats a nearly empty food stock as an urgent need. It won’t eat food that would harm it, like rotten flesh or raw chicken, unless it’s starving.
- Iron tools, the pickaxe first. Next it digs a mine for iron, or explores caves and falls back to a strip mine if no cave turns up. Once its shelter stands, it spends the daylight in the cave or the mine until its iron tools are done. The iron pickaxe comes first. The bot smelts and crafts it from its first three raw iron wherever it stands, even down the mine. The very next ingot becomes its shield, made where it stands, ahead of the day’s food and farm. Then come its iron sword and its axe from one furnace load, plus a spare pickaxe so a broken tool underground never stops its dig. With an iron pickaxe in hand it also makes a water bucket and keeps it in its hotbar. Near a wide lake or river, it builds a boat and rows across instead of swimming.
- A bed by the second night. A house isn’t finished without a bed, so the bot goes looking for sheep by day (walking to where it last saw some, or toward a flock it remembers), and it keeps the wool and string it comes by. When it can, it shears them with two spare iron rather than killing them. Where no sheep live, twelve string from the spiders at its door or the cobwebs by its mine make a white bed instead.
- Working the night. A sheltered bot keeps busy after dark. On Normal, Hard and Expert difficulties, it works through the night on anything that keeps it within safe ground. It digs its mine (or, for a cave miner, a dedicated night strip mine inside the yard), smelts, crafts, sorts chests, tends its farm and goes fishing from a bank inside its yard. At dusk it hunts spiders and skeletons at its doorstep to craft a bow and arrows (and to collect bones for its crops). A bot shut in its house with nothing else to do digs down through its own floor and mines the night under it. If night falls while it’s far from home or has no house yet, it digs a 3-block burrow straight down and caps the hole overhead. With any pickaxe in hand, it then turns the burrow into a mine. It digs a staircase down from the burrow’s floor to the depth of the ore it needs, then a tunnel until dawn, so even its first night brings iron (a wooden pickaxe digs for coal and keeps the stone for the morning’s tools; a mine from the burrow).
From there it keeps climbing:
- diamond gear
- an enchanting corner with bookshelves to enchant its kit
- a bigger base, and a farm and animal pen
- trading with villagers, up to bought iron and diamond gear
- for styles that travel to the Nether, a portal for blaze rods, potions, bastion templates and netherite
- for styles that go to the End, a faction trip to the dragon, the egg, and an end city’s elytra
How a bot decides what to do
A bot always has a list of things it could do: eat, flee, fight, recover dropped items after a death, upgrade or enchant its gear, brew potions, gather wood, build, mine, farm, trade, fortify its base and explore. Raiding styles can also scout for and raid enemy bases, and End-going styles can call the faction to the End. About once a second it weighs them all and picks the one that matters most right now.
- Staying alive comes first. If it’s starving, badly hurt, on fire, in the dark outside safe ground or out of air underwater, it deals with that before anything else.
- Then fights and orders. A bot that’s being attacked defends itself, and a bot with an order from an ally works on it.
- Then urgent survival milestones. It picks up its dropped items if it just died nearby, builds its first house once it holds a stone pickaxe, and secures at least a quarter of its cooked food stock.
- Then everything else, scored by need. A bot with a stone pickaxe wants iron, a bot with worn tools replaces them before they break, and a bot with full chests wants a storehouse. Its play style decides how much each kind of work appeals to it, so a miner rates mining higher and a fighter rates hunting enemies higher.
A bot sticks with what it’s doing unless something clearly more important comes up, so it doesn’t flip between tasks every second. If something keeps failing (say, it can’t find any iron nearby), it gives up on it for a while and does something else.
Two more habits keep a bot looking like a person rather than a mob:
- It doesn’t stand around. If a bot is awake and hasn’t changed anything for a minute (not moved, not picked up or used anything, not opened a chest), it treats that as a failure. It drops what it was doing and cools that goal down. If it happens again on the same spot, it walks out to open ground and starts over. Standing still on purpose (sleeping, waiting out the night indoors, a short smelt, a trade) doesn’t count.
- It never loops. A bot that keeps moving without getting anywhere (pacing between two blocks, bouncing up and down a column, one task after another on the same spot) is caught too. After two and a half minutes within eight blocks of one spot with nothing changed, it climbs an escape ladder, one rung each time it’s found stuck again: its task fails and rests, it walks out to open ground, then it relocates to the nearest place it knows to be safe (its shelter, its base, in the End the gateway or the exit portal), digging and building as it goes, then relocates again, and after three failed relocations it asks its faction for help in team chat and keeps trying. No rung is ever a random step, a drop into the void or a death on purpose.
- It leaves furnaces to work. A long smelt is loaded and left. The bot goes mining or building and comes back when the furnace is done, refueling it if it went out, and it empties any of its furnaces it happens to walk past. At dusk it loads whatever raw iron, gold or copper it’s carrying so nothing stays raw overnight.
Keeping stock
Bots like to keep a few basics on hand and go gather more when they run low: some logs, cobblestone, coal, food, torches and sticks. Anything beyond what they need ends up in their base’s chests. A bot eats what it walks past: with its food stock low, an animal it could cook within 24 blocks comes before its tools and its mine, like the cow a player kills on day one. When the stock runs low and no animal is in sight or remembered, a bot with a house goes on a hunt trip by day. It walks to where it last saw an animal, toward a flock it remembers (animals grazing together, remembered for three days and shared with its faction), or toward the most open grassland within 64 blocks of its door, then hunts the first animal it sees and cooks the meat. A trip that finds nothing makes the next one wider, out to 128 and then 256 blocks in legs, started early enough to be home by dark. It also takes the food that grows wild, melons in a jungle and ripe sweet berries in a taiga, and when no animal can be found at all it farms and fishes for its food instead. In the last stretch of the afternoon a bot with less than three quarters of its food stock fills it up before anything else, so it goes into the night fed.
Exploring
When there’s nothing pressing to do, a bot wanders off to explore. Exploring helps it find new trees, ores, animals and villages. It never strays farther from home than its play style’s roaming radius (from 64 to 256 blocks for the shipped styles).
Respecting your builds
Bots gather from nature and leave what players build alone:
- They chop only logs that belong to a real tree, with that tree’s own leaves around them.
- They never mine placed cobblestone. Their cobblestone always comes from natural stone.
- They never touch another bot’s house, their base’s buildings or a building under construction.
- They won’t hunt an animal that has a name tag or is on a lead.
One exception: a raid in progress
A raider from an enemy faction, in the middle of a heist, may open the chests that base is recorded to hold, steal one fence post or gate from its wall, and dig up one floor block outside its buildings for a trap. The buildings themselves stay off-limits even then. See Raiding enemy bases.
Watch out near log cabins and stone walls
The “real tree” check is a smart guess, and it can be wrong. A bot may still take logs from a log cabin built under a tree, or mine a wall made of natural stone or andesite. Keep bots’ bases away from builds like that, or use a protection mod. Bots break and place blocks like players do, so claims and protected areas stop them too.
Getting out of trouble
- Water. A bot underwater surfaces for air before it does anything else, and it only dives when it has enough air to come back up.
- Fire and lava. A burning bot drinks a Fire Resistance potion if it carries one (and its style uses potions). Otherwise it pours its water bucket at its feet if it has one (in the Overworld), or steps off the fire onto safe ground (into water first when in reach) and waits it out. If it falls into lava, it scrambles onto the nearest bank.
- Long drops and sheer walls. With a water bucket, a bot facing a fall of more than three blocks with no way round pours water under itself as it falls, lands in it, then scoops the water back up. A wall two to six blocks high with no way up gets climbed on a column of water the bot pours against the top.
- Wide water. Once it has stone tools and sees open water more than eight blocks across, a bot keeps a boat. For longer crossings it places the boat from the bank, climbs in, paddles across, gets out, breaks the boat and picks it up again (diving for it if it sank). Shorter crossings it still swims.
- Multiple threats and archers. When running away, a bot sprints in the direction that puts the most distance between itself and every threat it has seen, so it won’t run from a creeper straight into a skeleton’s arrows, and it turns the moment a new monster comes into view. Caught on a ledge, it drops off the edge like a player jumps rather than stand there. When an archer it won’t fight shoots at it, it ducks behind a block for cover, or walls the archer off with two blocks when it holds them.
- Walling in. Underground, where running means a monster at its heels in the dark, a bot that would flee closes every open cell around it with blocks instead, waits inside until the coast is clear and its health is back, eats if it can, and strikes whatever pokes in (combat). On the open ground it still runs, except when a fight has turned badly and it holds the blocks.
- Buried. A bot whose head ends up inside a block (falling gravel, say) digs itself free before anything else.
- Holes and pockets. A bot that’s walled in, fell into a hole or dug itself into a pit digs a staircase, tunnels or pillars its way back to the open sky. It ignores tree canopies overhead so it climbs out to real ground, and it never mistakes its own fresh tunnels, its remembered mine or the quarry of its first house for a trap. If the walk out fails twice from the same spot within a minute, it stops looking for a way out and digs one, a block at a time. It pillars up out of a hole on the blocks it holds (cutting through leaves or logs that roof it), cuts a stair into the wall when it holds none, or breaks the block under its feet from a height, one short drop at a time. It never cuts into a base’s building or anything that would take more than five seconds to break by hand, and it leaves the block that lured it in (a log in a jungle canopy, an ore) alone for the rest of the day.
- Out of reach. If the bot can’t get to a block it set out to mine (no walk reaches it, or a minute passes without getting closer), it gives up on that block for five minutes and takes the next one. That way it doesn’t stand staring at a log it can’t reach.
- High logs and cave ceilings. When a tree’s upper logs (up to 8 blocks up) or an ore in a cave ceiling are out of reach, the bot pillars up on blocks it holds, breaks the target, and digs its own pillar back down so no ugly towers are left behind.
- Night burrows. A bot caught at night without a house (or more than 48 blocks from its shelter and outside its mine) digs 3 blocks straight down into firm ground, caps the hole over its head, and climbs back out at dawn. If its home is near but out of reach (say it’s caught at the bottom of its quarry), it tries the walk for five seconds and then burrows where it stands. A bot in a tunnel or stair of its own shuts itself in there instead. With a stone pickaxe, the burrow becomes a mine for the night.
- Recovering items after dying. When a bot dies within 160 blocks in the same dimension (not in lava, and not in the End), it walks back to its death spot before the items despawn, digging and building its way there if a plain walk finds none (a death down its own mine, say). It waits if a monster is camping the spot, then picks its things back up and puts its armor back on. A bot that respawned with no pickaxe goes back at night too, for drops within 64 blocks, rather than sit the night out with nothing to dig with.
- Respawning into monsters. A bot that sees a monster within 24 blocks as it respawns, or that died twice within two minutes, waits inside its house or a burrow until nothing has been in sight for half a minute, then goes back for its drops.
- No pickaxe at night. A miner with no pickaxe at night fetches wood for one once instead of waiting for dawn: from what it holds, its chests, or the nearest tree, then makes a table and a pickaxe and digs its night.
- Trees. Leaves count as solid ground, so a bot that respawns on top of a tree climbs down like a player would.
Day and night, online and offline
Bots load the world around them like any player, so they keep working even when no real player is nearby. Leave for a few days and their base will have grown when you come back.
Bots don’t count toward the sleep vote, so only real players decide when the night gets skipped. When every real player online is asleep in bed, any bot that has a bed walks to it and lies down so the skipped night finds it in bed. It gets right back to work when players wake up.
Technical details
The objectives and how they're scored
Each “thing a bot could do” is an objective. Objectives are scored with:
score = weight × urgency × feasibility × (1 − risk × (1 − risk_tolerance))- weight comes from the play style (
weightsin the play style file). Surviving, fighting, orders, stowing surplus, building the first house (once holding a stone pickaxe) and refilling a food stock below 16 hunger points (once holding a stone pickaxe) are unweighted (weight = 1). - urgency comes from the bot’s needs: hunger, health, threats, darkness, the gap between its gear and its gear goal, how far below target its stockpiles are, and so on.
- feasibility is whether the first steps can be taken right now (a known source for the item, the right materials, a reachable site).
- risk comes from threats and distance from home, softened by the style’s
risk_tolerance.
The running objective gets a 15% bonus so a bot doesn’t flip between close scores. Survival, fights and
orders are interrupts, checked every tick. Everything else is re-scored every second. At night, while a
sheltered bot works the night (night_work: true), only night-safe objectives and interrupts are ranked. Work
the bot has begun runs to its end, and a night job that fails twice is held until morning. A bot that’s ready
for the End ranks the trip above every gear, mining, building and exploring
objective, whatever the weights. An objective whose work fails isn’t picked again for 600 ticks (30 seconds).
The full list of objectives and their ids is in
Inspecting and debugging bots.
Stockpile targets
| Stockpile | Target |
|---|---|
| Logs | 16 |
| Cobblestone | 32 |
| Coal | 8 |
| Food | 64 hunger points (e.g. 8 steak) |
| Torches | 8 |
| Sticks | 8 |
| Arrows | 16 (styles that fight with a bow) |
| Sugar cane | 16 (styles raising an enchanting corner, until its fifteenth shelf stands) |
| Emeralds | 32 (while a trader that sells gear the bot wants is known, see Villages and trading) |
The urgency of a stockpile is half its deficit, so a half-empty stockpile is never more urgent than 0.25.
Food is the exception. It counts nourishment (cooked meat, bread, carrots, baked potatoes, berries, melon
slices; raw meat and raw potatoes count 0), and it becomes an unweighted need whenever a bot with a stone or
better pickaxe has fewer than 32 hunger points on hand and in its base chests: at full urgency below 16, weaker
between 16 and 32 (so the next tier of tools and an unfinished first house still come first). In the last 4000
ticks before dusk, a bot under 48 points fills the stock to 64 before anything else. For five minutes after
spotting a huntable animal whose meat it can cook, the bot remembers where it saw it and walks back there when
gather_food runs, and it keeps the flocks it has seen for three days. stow cooks any raw meat in the
inventory before storing excess food beyond 64 hunger points.
A play style can add its own targets with hoard, for example { "minecraft:diamond": 8 }. Items in the base’s
chests count toward every target.
Eating and healing
A bot eats from food level 16. When it’s hurt and holds food, it eats below food level 18, which is where
vanilla’s natural regeneration stops, so it heals between fights. When the best food it holds is raw meat or
fish and a furnace and fuel are available, it cooks the meat first unless it’s starving (food level 7 or below).
Food in the #aiplayers:harmful_food item tag is never eaten above food level 3 (see
Data packs).
Exploring in detail
Exploring makes up to eight trips, each to a random spot on the surface between 32 blocks and the roaming radius away from home. A trip that fails halves the range (down to 8 blocks), so a bot stuck in a cave still gets somewhere. Reaching a spot restores the range. A bot whose style trades and that knows no village nearby explores more eagerly, heading away from where it has already been.
The stall guard
Once a second the bot compares a snapshot of its own state with the last one: the block under its feet, what
it carries and the wear of its held tool, the blocks it broke or placed, the menu it has open, its health and
food. A minute awake with none of that changed is a stall. The running task fails with the reason stalled,
its objective isn’t chosen again for 600 ticks, and the server log names the objective, the step it was at and
where. A second stall within two blocks of the first inside five minutes, or a stall with no task at all (the
log then lists every objective’s score), walks the bot out to open ground four blocks away. That’s the same walk
that takes it out of a pit, never a random step. Leaves that must stand still declare their wait (a short
smelt, sleep, the night behind the door, the dawn watch, the dusk hunt, a trade, an ordered stay, hiding from a
shooter), and a declared wait counts as progress until its deadline. A bot digging in the quarry of its first
house is never walked out of it as if trapped, and one standing in it with nothing to dig is walked out only
after ten seconds without a step or a broken block.
The escape ladder catches what the stall guard can’t: a bot that moves but gets nowhere. Staleness is a
region, not a pose. When the bot stays within eight blocks of one spot, sideways and at any height, for 3000
ticks awake, breaking and placing nothing, with its inventory unchanged and no chest opened, whatever it tried
meanwhile, it’s stuck. Each time it’s found stuck again within 12000 ticks it takes the next rung: the task
fails and cools, a walk out to open ground, a relocation to the nearest known safe place outside those eight
blocks (digging, placing and, in the End, flying or digging down as it goes), another relocation with the
task’s rest doubled, and after three failed relocations a stuck call to its faction in team chat, after
which it keeps relocating. A relocation that arrives ends the ladder. No rung is a random step, a step into
the void or lava, or a death on purpose, and a relocation never takes a bot out of its dimension away from
home. A guard in its yard is never stuck. Every rung is in the server log, and info shows stuck: <rung>.
The gear ladder's order
A bot with no sword and no axe anywhere in its pack makes a sword before anything else, scored above the trips
that take it underground. Then a bot gets a tier’s tools pickaxe first. It makes the pickaxe as soon as it holds
that pickaxe’s three ingots (a miner under a mining strategy makes its iron pickaxe from three iron before the
set’s nine are mined), and by day it makes it before anything but the urgent. Then comes the shield (for a sword
or axe style), from the very next ingot, where the bot stands, even down its burrow’s mine, and then the sword
and the axe, as far as the iron held allows. The rest of the
tier’s material goes into one furnace load that’s left pending and crafted on the collect. For the scoring, the
armor, the shears and the enchanting corner, a tier counts as climbed once its sword and axe are held too.
What the bot can mine is read from the pickaxe itself. The ore the next pickaxe needs is smelted at any hour,
wherever the bot stands, even down its mine
(mining). stow keeps the ladder’s ingots and raw
ore in hand up to the tier’s need.
The water bucket and the boat
- A bot with an iron or better pickaxe crafts a bucket from three ingots and fills it at the nearest water it
knows.
stowkeeps one water bucket (or the empty bucket while it holds no water). The bot never pours it into another base’s protected ground, or in the Nether, where it would evaporate. - A bot with a stone or better pickaxe that sees open water at least nine blocks wide within 32 blocks crafts a
boat from the wood it holds most (a bamboo raft from bamboo, an oak boat if it holds no wood at all), and
stowkeeps it. It rows a crossing when it’s a straight line longer than eight blocks, from one bank to another at the same height, over water at least two deep. Ice, lily pads and shallows make it swim or go round. A bot hit while rowing gets out immediately. No boat is ever placed on lava or used in the Nether.
Last updated Nov 9, 2026