Skip to content
Documentation
On this page

Bots

A bot plays a level for you with your own controls. It watches what is coming, looks for free space and moves the same character you do: it walks, dashes, takes damage and dies

A bot does not guarantee a clear. It does not get tired, but it can lose. If a pattern has to be entered correctly a second before it arrives, the bot gets hit. Nothing is broken when that happens

A bot loads the device. Searching for free space is real work on every frame. Expect frame drops on a weak device. On a heavy level the first seconds are the worst

To choose a bot, use the Bot condition on the level screen: No Bot, Reflex Bot v1 or Warm Bot v1. It is chosen for each run, like lives and speed

Worth knowing

A bot cannot cheat, and that is how it is built, not a promise. It has the same controls you have and nothing more: the same speed, the same dash, the same hitbox, the same damage. It cannot pass through anything you could not pass through

A level beat the bot?

Bots get better on levels they have not seen yet. Such a level is worth sending

Open an issue in bullet-hero/releases. Write which bot lost and where, and attach the level folder

Two bots

Every frame a bot gives one input, the same as a keyboard does, and nothing else. It has no access to the avatar's position, its health or the state of the level. If the bot does not answer on some frame, your device steers on that frame

Reflex Bot v1Warm Bot v1
What it knowsthe next 1.5 seconds, recalculated every framethe whole level, calculated once
When it loads the deviceevery frame while it runsonce, before the run
What it can doavoid what it sees aheadfollow a plan no look-ahead would ever find
What breaks ita pattern that had to be entered a second earliera level that changed under it
How it steersby directionby target

The warm bot aims for zero damage. It pays for that with an extra loading stage, Baking route. It can last tens of seconds

The ? next to Bot warns about this in advance, with a paragraph per bot. Cancel stops the calculation and hands the run to you. The warm bot's route depends on the seed, Determinism

Where else bots play

  • The editor's test player: Settings → Game Editor → Bot Steers The Player. Only the reflex bot plays there: it needs nothing prepared in advance and it survives rewinding. More - How a bot plays your level
  • The main menu background: the arena behind the buttons is a reflex bot playing live with no look-ahead at all

The bot is part of a record's conditions. So a bot's run never replaces your best result, Statistics