PvpBotdocs
Features

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.

SettingDefaultValuesWhat it does
aim-1-1 – 100How straight it aims - swings, pearls, charges, shots (-1 = follow skill)
reaction-1-1 – 100How fast it responds to anything new (-1 = follow skill)
crit-timing-1-1 – 100How close to the ideal tick its crits, swings and smashes land (-1 = follow skill)
technique-1-1 – 100How often the hard techniques actually come off (-1 = follow skill)
tracking-1-1 – 100How well it keeps its aim on a moving target mid-technique (-1 = follow skill)
clutch-1-1 – 100Water-bucket clutch success rate, percent (-1 = follow mistake-chance)
shield-disable-speed-1-1 – 100How fast it notices a raised shield and axes it (-1 = follow reaction)
shield-charge00 – 100Attack charge, percent, it waits for before the axe hit on a shield (0 = at once)
strafe220 – 60Degrees off the straight line it circles you at (0 = walks straight in)
reach-flips00 – 10How often, in tens of percent, a swing gives up full reach (0 = always full reach)
potion-gap2.00 – 10Seconds at least between two healing potions
cart-skip00 – 100Percent of cart chances it lets go by
elytra-mace-level00 – 5Elytra-mace skill, 1 (easy) to 5 (professional) - 0 follows skill
stun-slam-chance1000 – 100Percent 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.

PlaystyleHow it plays
defaultAs bots always have.
aggressiveCommits and stays in longer.
safeHeals and pearls out early.
defensiveStands 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.
adaptiveSwings between aggressive and safe with the health race.
balancedSits 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.

SettingDefaultValuesWhat it does
playstyledefaultdefault / aggressive / safe / defensive / balanced / adaptiveTemperament: how far it commits, when it runs, how it uses the safety net
openingtruetrue / falseWalks 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.
SettingDefaultValuesWhat it does
personalitytruetrue / falseEach 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
spacingtruetrue / falseOut 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-punishtruetrue / falseYou swing and miss: it steps straight in for the free hit
tempotruetrue / falseFights in phases: pushes after landing two, backs off to reset after taking two, a breath after a heavy trade
show-itemstruetrue / falseA 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
panictruetrue / falseAt three hearts it either locks in (steadier aim) or panics (shaky aim, jumpy, strafing every which way) - better bots lock in more often
after-fighttruetrue / falseAfter a kill: crouches over the body (some do), picks the good stuff out of the drop
idle-fidgettruetrue / falseStanding about it looks round, glances at people, flicks its hotbar, hops and taps crouch