Difficulty and playstyles
How well a bot plays (the difficulty knobs and presets), what it wants (its playstyle), and the habits that make it play like a person.
Skill and the knobs
No move a bot makes is frame-perfect. skill (0–100, default 50) is the master dial, and it is split into
one knob per part of playing well: aim, reaction, crit timing, technique, tracking, clutch and more. That
way you can build a bot that aims perfectly but reacts slowly, or one that never misses a crit but can't clutch.
A knob at -1 follows skill, so a config that only sets skill plays exactly as
it always did. Even at 100 there is a gap to play around: reach is a player's, aim turns at a limited speed and
ping-millis adds a real connection's delay.
Difficulty presets
Six presets write every knob at once: easy, medium, hard, expert,
professional and perfect.
/pvpbot difficulty [list]
/pvpbot difficulty preset <easy|medium|hard|expert|professional|perfect>
/pvpbot difficulty <knob> <value>
/pvpbot difficulty bot <bot> [list|preset <level>|clear|<knob> <value>]
/pvpbot difficulty faction <faction> [list|preset <level>|clear|<knob> <value>]
These are separate from the settings presets
(/pvpbot preset), which change more than difficulty: which tricks are on, pearls, webs and so on.
Per bot, per faction, everywhere
Every setting, not only difficulty, resolves per bot first, then per faction, then globally. A bot's
own values are kept by name in bot-settings.yml, so they survive respawns and restarts. See
Which value wins.
| Setting | Default | Values | What it does |
|---|---|---|---|
aim | -1 | -1 – 100 | How straight it aims - swings, pearls, charges, shots (-1 = follow skill) |
reaction | -1 | -1 – 100 | How fast it responds to anything new (-1 = follow skill) |
crit-timing | -1 | -1 – 100 | How close to the ideal tick its crits, swings and smashes land (-1 = follow skill) |
technique | -1 | -1 – 100 | How often the hard techniques actually come off (-1 = follow skill) |
tracking | -1 | -1 – 100 | How well it keeps its aim on a moving target mid-technique (-1 = follow skill) |
clutch | -1 | -1 – 100 | Water-bucket clutch success rate, percent (-1 = follow mistake-chance) |
shield-disable-speed | -1 | -1 – 100 | How fast it notices a raised shield and axes it (-1 = follow reaction) |
shield-charge | 0 | 0 – 100 | Attack charge, percent, it waits for before the axe hit on a shield (0 = at once) |
strafe | 22 | 0 – 60 | Degrees off the straight line it circles you at (0 = walks straight in) |
reach-flips | 0 | 0 – 10 | How often, in tens of percent, a swing gives up full reach (0 = always full reach) |
potion-gap | 2.0 | 0 – 10 | Seconds at least between two healing potions |
cart-skip | 0 | 0 – 100 | Percent of cart chances it lets go by |
elytra-mace-level | 0 | 0 – 5 | Elytra-mace skill, 1 (easy) to 5 (professional) - 0 follows skill |
stun-slam-chance | 100 | 0 – 100 | Percent of raised shields it goes for the axe-then-mace stun slam on |
Playstyles
A playstyle sets what a bot wants, on top of how well it plays: when it commits, heals, runs and chases.
| Playstyle | How it plays |
|---|---|
default | As bots always have. |
aggressive | Commits and stays in longer. |
safe | Heals and pearls out early. |
defensive | Stands its ground: blocks more, punishes your mistakes, never chases past a few blocks (it stops, faces you and lets you come back), never backs off to reset, and heals where it stands. |
adaptive | Swings between aggressive and safe with the health race. |
balanced | Sits in the middle. |
Set it per bot (kept by name), per faction or globally. randomplaystyle rolls each bot its own, by weights
you choose.
/pvpbot playstyle list
/pvpbot playstyle <style> <bots>
/pvpbot playstyle clear <bots>
/pvpbot playstyle faction <faction> <style|clear>
/pvpbot randomplaystyle <bots>
/pvpbot randomplaystylechances [list|reset|<style> <weight>]
The opening
A bot walks a new opponent down the way a player does: drifting side to side, pausing to watch, arcing in over the last few blocks and only sprinting near the end. That careful walk is only the last stretch: from further off it sprints and hops in like anyone crossing open ground. From the first hit either way, it fights as always. The walk-in ends once the gap has been growing for half a second, so a bot still chases someone who runs.
| Setting | Default | Values | What it does |
|---|---|---|---|
playstyle | default | default / aggressive / safe / defensive / balanced / adaptive | Temperament: how far it commits, when it runs, how it uses the safety net |
opening | true | true / false | Walks a new opponent down the way a player does - drifting, pausing, arcing in - not a straight sprint |
Playing like a person
- Personality: every bot gets its own habits from its name: how jumpy it is, how wide it strafes, the range it likes, rush or turtle, sprint-comboer or crit-hunter. Weak bots sometimes spam-click air, and pay for it.
- Spacing and whiffs: out of your reach while its attack meter refills, back in as it fills. It hovers at the edge of your reach to bait a swing, and punishes a whiff with a free hit.
- Tempo: it pushes after landing two in a row, backs off to reset after taking two, and takes a breath after a heavy trade.
- Items in hand first: gapples, potions and pearls come up a moment before use, and now and then the wrong slot comes up first.
- Panic or clutch: at three hearts a bot either locks in or falls apart. Better bots lock in more often.
- Outgeared bots play it smart: when your kit clearly beats theirs (armour, weapon, totems, gapples), a bot stops trading straight. It waits for you to swing first and punishes the gap, goes for crits, blocks more, and heals and backs off sooner.
- After a kill: some crouch over the body; most pick the totems, pearls, gapples and potions out of the drop.
- Fidgeting: standing about, bots look round, glance at people walking past, flick their hotbar and hop.
| Setting | Default | Values | What it does |
|---|---|---|---|
personality | true | true / false | Each bot has its own habits from its name - how jumpy, how wide it strafes, its range, rush or turtle, sprint-combo or crit-hunter, and (below skill 45) sometimes spam-clicking |
spacing | true | true / false | Out of your reach while its meter refills and yours is full, back in as it fills; now and then hovers at the edge of your reach to draw a swing |
whiff-punish | true | true / false | You swing and miss: it steps straight in for the free hit |
tempo | true | true / false | Fights in phases: pushes after landing two, backs off to reset after taking two, a breath after a heavy trade |
show-items | true | true / false | A gapple, potion or pearl is up in its hand a moment before it is used, and now and then the wrong slot comes up first |
panic | true | true / false | At three hearts it either locks in (steadier aim) or panics (shaky aim, jumpy, strafing every which way) - better bots lock in more often |
after-fight | true | true / false | After a kill: crouches over the body (some do), picks the good stuff out of the drop |
idle-fidget | true | true / false | Standing about it looks round, glances at people, flicks its hotbar, hops and taps crouch |