Settings
Every option that changes how bots behave, with its default and limits.
Changing settings
- In game:
/pvpbot set <name> <value>. Applies to every bot at once and is written toconfig.yml. - For one faction:
/pvpbot faction set <faction> <name> <value>. Applies only to that faction's bots. - For one bot: the difficulty knobs, playstyles and techniques can be set per bot
(
/pvpbot difficulty bot,/pvpbot playstyle,/pvpbot techniques bot), and the settings menu edits any setting for one bot with/pvpbot settings bot <bot>. A bot's own values are kept by name inbot-settings.yml. - In a menu:
/pvpbot settingsopens a paged menu of every setting. See Menus. - In the file: edit
plugins/PvpBot/config.yml, then run/pvpbot reload. - To see them in chat:
/pvpbot settings list, or/pvpbot settings list combatfor one group, or/pvpbot settings list pearlto filter by name.
Values outside the limits are refused. Times are in ticks (20 ticks = 1 second), distances in blocks, and health in half-hearts (20 = full health).
Which value wins
When a bot reads a setting, the most specific layer wins:
config.yml(or the default, if the key isn't there);- the active preset, if any;
- the bot's faction settings;
- the bot's own settings.
So a value is read per bot first, then per faction, then globally. The difficulty knobs at -1 follow
skill at whichever layer it's set.
/pvpbot set writes it to config.yml but the preset's
value still wins. The command tells you so: use /pvpbot preset off, or save the preset again with
/pvpbot preset save <name>.General
Group general: periodic checks, restarts and compatibility with other plugins.
| Setting | Default | Values | What it does |
|---|---|---|---|
check-interval | 20 | 1 – 200 | Ticks between equipment checks (best armour and weapon). |
bots-relog | true | true / false | Bring bots back after a server restart. |
force-vulnerable | true | true / false | Clear the invulnerable flag on bots. Login plugins set it and never clear it. |
auth-autologin | true | true / false | Register bots with the login plugin (AuthMe and similar) so it stops freezing them. |
bypass-damage-protection | false | true / false | Un-cancel damage involving bots. Overrides region and PvP protection, so use with care. |
target-scan-interval | 10 | 1 – 60 | Ticks between target searches. Raise it if a large crowd of bots lags. |
Combat
Group combat: who to attack, how, and with which techniques. Longer explanations on
Combat.
| Setting | Default | Values | What it does |
|---|---|---|---|
auto-target | true | true / false | Hunt the nearest enemy unprompted. |
target-players | true | true / false | Pick players as targets unprompted (off = mobs only, unless ordered or hit). |
target-passive-mobs | false | true / false | Also pick passive and neutral mobs as targets (off = hostile mobs only). |
revenge | true | true / false | Fight back against whoever hits the bot. |
friendly-fire | false | true / false | Allow hitting allies. |
bot-vs-bot | false | true / false | Bots pick fights with each other unprompted. |
attack-invincible | false | true / false | Also attack players in creative or spectator mode. |
max-target-distance | 32.0 | 1 – 128 | How far (in blocks) a bot looks for targets. |
melee-range | 3.0 | 1 – 6 | Reach, from the eyes to the hitbox as vanilla measures it (3.0 = a player's). |
melee-standoff | 2.2 | 0.5 – 5 | Distance held in melee, so bots don't stand inside each other. |
attack-cooldown | 12 | 1 – 100 | Ticks between swings (lower = faster). |
ping-millis | 50 | 0 – 500 | Simulated latency: delays when a decided attack lands, like a real client's round trip (0 = instant, unrealistically perfect). |
miss-chance | 10 | 0 – 100 | Percent of swings and shots missed on purpose. |
mistake-chance | 12 | 0 – 100 | Chance to hesitate or panic on a clutch action (0 = flawless). |
leader-call-seconds | 30 | 0 – 600 | How many seconds a faction stays hostile to whoever its leader is fighting (0 = off). |
reaction-ticks | 30 | 0 – 200 | Ticks a bot sizes up a player it noticed on its own before attacking (0 = at once). |
spawn-grace | 5 | 0 – 600 | Seconds after spawning before a bot starts a fight with a player on its own. |
skill | 50 | 0 – 100 | How human a bot's reactions, timing and aim are. Never frame-perfect, even at 100. |
turn-speed | 30.0 | 1 – 180 | Most degrees a bot turns per tick (180 = instant snap-aim, the old behaviour). |
special-weapon-melee-chance | 35 | 0 – 100 | Percent of fights where a mace carrier uses an ordinary weapon instead. |
shield-disable-chance | 70 | 0 – 100 | Percent of raised shields a bot reacts to by switching to an axe. |
mace-range-bonus | 0.0 | 0 – 4 | Extra reach on a mace smash, on top of melee-range (a deliberate advantage). |
attribute-swap | false | true / false | Master switch for the weapon-swap techniques (breach swap, mace stun, lunge). |
breach-swap | true | true / false | Hit with a sword carrying the mace's Breach/Density enchantments. |
mace-stun | true | true / false | Axe to break a raised shield, then the mace straight after without waiting for the cooldown. |
spear-lunge | true | true / false | Chain spear jabs to close distance (needs Lunge to actually dash). |
swap-cooldown | 30 | 0 – 200 | Ticks between swap combos. This is the real limit, since combos skip the normal attack cooldown. |
mace-pearl-launch | false | true / false | Throw a pearl, then pop a wind charge on it mid-flight for a much higher launch. |
mace-defence-shield | 55 | 0 – 100 | Percent of incoming mace smashes answered with a shield. |
mace-defence-flee | 20 | 0 – 100 | Percent answered by getting out of the way (the rest are taken). |
mace-totem-chance | 35 | 0 – 100 | Percent of mace fights where the bot keeps a totem in the offhand instead of a shield. |
mace | true | true / false | Use mace jump attacks. |
elytra-mace | false | true / false | Elytra mace: climb on rockets, dive and smash without landing (needs elytra, rockets and a mace). |
elytra-mace-height | 20 | 8 – 60 | Blocks above the target to climb before diving. Higher hits harder. |
cart-pvp | false | true / false | Cart PvP: a Flame arrow, then a rail and a TNT minecart in its path (needs all three, plus arrows). |
cart-max-self-damage | 10.0 | 0 – 40 | Most damage (after armour, on an average roll) a bot accepts from its own cart. Never a lethal roll without a totem. |
cart-cooldown | 80 | 0 – 1200 | Ticks between cart plays. |
crit-chain | true | true / false | Chain jump crits back to back instead of resting between hops. |
cooldown-trick | true | true / false | Swing at 84.8% attack cooldown instead of 100%: full crit and knockback, just faster. |
jump-reset | false | true / false | Chain another mace smash right after landing one, instead of waiting for the cooldown. |
mirror-punish | true | true / false | Swing back mid-air off the enemy's own knockback the instant they hit (a punish crit). |
hit-select | true | true / false | Hold a swing until the angle and spacing are favourable, instead of swinging on cooldown alone. |
d-tap | true | true / false | A brief sideways sprint reset after landing a hit: the w-tap idea on a lateral axis. |
hit-web-combo | true | true / false | Follow a landed cobweb trap with an immediate swing instead of leaving the web to work alone. |
sweep-hit | true | true / false | Drop sprint to land vanilla's sweep attack when 2 or more enemies are close in melee. |
priority-hp-target | true | true / false | Within the same priority, prefer the lowest-health target over the nearest. |
shield-read-windup | true | true / false | Raise the shield early when reading a jump-crit windup, not only against a mace smash. |
orbital | true | true / false | Fire Orbital Strike Cannon rods, staying clear of their own blast. |
orbital-cooldown | 200 | 20 – 2000 | Ticks between orbital strikes. |
crits | true | true / false | Jump before swinging to land critical hits. |
stasis | false | true / false | Block a killing hit and teleport away (ender pearl effect) instead of dying. Off makes a protected faction killable again. |
shield-disable | true | true / false | Switch to an axe to break a blocking enemy's shield. |
break-stashes | true | true / false | Break a shulker box or ender chest the target placed nearby, denying a mid-fight restock. |
Movement
Group movement.
| Setting | Default | Values | What it does |
|---|---|---|---|
bhop | true | true / false | Jump constantly while chasing. |
speed | 1.0 | 0.1 – 2 | Movement speed (1.0 = sprint). |
wander | true | true / false | Walk around when idle. |
follow-distance | 3.5 | 1 – 20 | How far a follower stays from whoever it escorts. |
Utility and survival
Group utility: gear, healing, totems, pearls, cobwebs, water.
| Setting | Default | Values | What it does |
|---|---|---|---|
auto-equip | true | true / false | Wear the best armour and hold the best weapon carried. |
auto-repair | true | true / false | Collect nearby XP orbs and mend damaged gear with them. |
auto-repair-bottles | true | true / false | Once nearby orbs run out, crack carried XP bottles to mend gear. |
auto-totem | true | true / false | Grab a totem when close to death. |
totem-health | 8.0 | 0 – 20 | Health at which the totem goes into the hand. |
retreat | true | true / false | Back off when low on health. |
retreat-health | 6.0 | 0 – 20 | Health at which to retreat. |
auto-food | true | true / false | Eat when hungry. |
food-threshold | 16 | 0 – 20 | Food level below which to eat. |
auto-shield | true | true / false | Raise a shield when hurt. |
shield-health | 8.0 | 0 – 20 | Health at which to start blocking. |
auto-potion | true | true / false | Drink healing potions and eat golden apples. |
potion-health | 10.0 | 0 – 20 | Health at which to heal. |
buff-potions | true | true / false | Drink strength, speed and fire resistance before a fight. |
pearls | true | true / false | Use ender pearls to escape and to chase runners. |
pearl-escape-health | 5.0 | 0 – 20 | Health at which to pearl away. |
pearl-chase-distance | 14.0 | 4 – 64 | How far a fleeing target must be before the bot pearls after them. |
pearl-cooldown | 120 | 20 – 600 | Ticks between pearls. |
cobwebs | false | true / false | Web enemies to pin them. |
cobweb-range | 3.5 | 0.5 – 6 | How close before webbing (lower = must commit). |
cobweb-cooldown | 160 | 20 – 600 | Ticks between webs from one bot. |
cobweb-global-cooldown | 60 | 0 – 600 | Ticks between webs from ANY bot, so a squad can't chain-web you (0 = off). |
drain | true | true / false | Scoop up water an enemy places (MLG denial). |
drain-delay | 20 | 0 – 100 | Reaction delay in ticks before draining. |
web-escape-delay | 15 | 0 – 100 | Ticks a webbed bot takes to react and reach for its water bucket (each web adds up to 50% more). |
web-escape-fumble-chance | 35 | 0 – 100 | Percent of water escapes a webbed bot botches, losing a beat before trying again. |
totem-delay-ticks | 10 | 0 – 60 | Pause before a panic totem reaches the offhand (instant would look inhuman). |
water-clutch | true | true / false | MLG a water bucket to survive a long fall. |
water-clutch-min-fall | 5.0 | 0 – 64 | Shortest fall worth a bucket (below this the bot takes the damage). |
water-clutch-window | 5.0 | 1 – 32 | Blocks above the ground where the water goes down (widens with falling speed). |
water-clutch-pickup | true | true / false | Scoop the water back up after landing. |
Ranged
Group ranged: bows and crossbows.
| Setting | Default | Values | What it does |
|---|---|---|---|
ranged | true | true / false | Use bows and crossbows. |
ranged-min-range | 6.0 | 0 – 64 | Closer than this, switch to melee. |
ranged-optimal-range | 12.0 | 1 – 64 | Distance to hold while shooting. |
bow-min-draw-ticks | 18 | 1 – 60 | Draw time before releasing (20 = full draw). |
arrow-prediction | true | true / false | Lead shots ahead of moving targets. |
ranged-shot-gap | 25 | 0 – 200 | Fewest ticks between one arrow and the next draw. |
ranged-volley-size | 3 | 1 – 20 | Most arrows in a row before lowering the bow (each volley is 1 to this many). |
ranged-rest-ticks | 80 | 0 – 600 | How long the bot stops shooting after a volley, closing in meanwhile. |
Building
Group building: what bots may do to the world's blocks. They only ever break soft natural blocks (dirt,
sand, gravel, clay, leaves, undergrowth, cobwebs), never stone, ore, builds or containers.
| Setting | Default | Values | What it does |
|---|---|---|---|
building | true | true / false | Let bots bridge, pillar and dig through soft cover (never stone or anything built). |
building-bridge | true | true / false | Place a block to cross a gap. |
building-pillar | true | true / false | Tower up toward a target that is above and out of reach. |
building-clear-soft | true | true / false | Dig through dirt, sand, gravel, leaves and undergrowth in the way. |
building-cooldown | 6 | 0 – 200 | Ticks between block actions. |
building-budget | 64 | 0 – 2000 | Most blocks a bot may place and break per minute. |
building-max-pillar | 6 | 0 – 64 | Tallest tower a bot will build. |
Detection
Group detection: when a bot notices a target. The multipliers scale the distance you're noticed at: below
1 means you have to be closer to be seen.
| Setting | Default | Values | What it does |
|---|---|---|---|
detection | true | true / false | Bots must actually see a target to know about it (off = the old plain-radius sweep). |
detection-touch-radius | 3.0 | 0 – 16 | Within this distance a target is noticed even without line of sight. |
detection-memory-ticks | 100 | 0 – 1200 | How long a spotted target stays known after leaving line of sight. |
detection-invisible | 0.15 | 0 – 2 | Notice-range multiplier against an invisible player (0.15 = spotted at 15% of the usual distance). |
detection-sneaking | 0.5 | 0 – 2 | Multiplier against a crouching player. |
detection-armoured | 1.0 | 0 – 2 | Multiplier against a player wearing armour. |
detection-unarmoured | 0.7 | 0 – 2 | Multiplier against a player wearing none. |
Difficulty
Group difficulty: skill split into knobs. -1 follows skill. See
Difficulty and playstyles.
| 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 |
Behaviour
Group behaviour: playstyle and the opening.
| 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 |
Aim
Group aim: crosshair-based hits. See Aim that decides
hits.
| Setting | Default | Values | What it does |
|---|---|---|---|
aim-hits | true | true / false | Its swing lands where its crosshair is: it aims a moment late, flicks and settles, and whiffs a juke (off: the old in-reach-and-a-dice-roll hit) |
aim-height | 70 | 30 – 95 | Where on the body it aims, percent of height from the feet - each bot a little higher or lower |
Senses
Group senses: view cone and hearing.
| Setting | Default | Values | What it does |
|---|---|---|---|
fov | 120 | 30 – 360 | How wide it sees, in degrees: someone behind it is not seen until heard or felt (360 = all round) |
hearing | 16 | 0 – 32 | Blocks it hears sprinting, fighting, eating and pearls from, and turns to look (0 = deaf) |
Tactics
Group tactics: hotbar discipline, the damage model, reading you, the shield game, edges and UHC tools.
See Fighting smarter.
| Setting | Default | Values | What it does |
|---|---|---|---|
hotbar-only | true | true / false | In a fight it uses its hotbar and off-hand; anything in the bag means opening the inventory - standing still for a moment - and it refills its hotbar between fights |
damage-model | true | true / false | Picks weapons by the damage they do through your armour, and fights, heals and backs off by who is winning the trade and how fast it is losing health |
read-opponent | true | true / false | Learns your habits in a fight: axes a shield player every time, crits a jump-resetter, follows your pearls, goes all in when you are low with no totem up |
shield-game | true | true / false | Lowers its shield to an axe about to land, punishes the five seconds your shield is down, and keeps its distance while its own is |
edge-play | true | true / false | Lines its hits up to knock you toward the void, lava or a drop, and keeps its own back off edges |
lava-play | false | true / false | UHC: pours lava on you and takes it back, and lights fire at your feet (needs a lava bucket / flint and steel; changes blocks) |
block-off | false | true / false | Walls itself off with a couple of blocks while it heals (needs blocks; changes blocks) |
Playing like a person
Group human: personality, spacing, tempo, clutch and fidgeting.
| 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 |
Techniques
Group techniques: the mace, spear, wind charge and elytra moves. See
Mace and spear techniques.
| Setting | Default | Values | What it does |
|---|---|---|---|
mace-swap | true | true / false | Swaps to the mace for its smashes and back to its weapon between them (off: the mace stays out) |
spear-mace-swap | false | true / false | After a spear lunge carries it in, the follow-up hit comes off the mace |
sword-windburst-swap | false | true / false | No effect: a smash is always swung with the mace (a sword swap there turned every smash into a plain sword hit) |
spear-reach-swap | false | true / false | A target just past sword reach gets the spear's 4.5-block jab instead of a step in |
windcharge-mace | true | true / false | A wind charge at its own feet to go up for a smash |
wc-crouch-boost | false | true / false | Throws the launch charge nearly straight under itself: more height, less drift toward them |
cooldown-discipline | true | true / false | Never throws a charge still on cooldown, and holds the smash swing for a charged meter |
hit-preference | true | true / false | In a mace play it saves the swing for the smash coming up rather than spending it on a flat hit |
hotbar-shield-tracking | false | true / false | Watches for a shield and keeps an axe on its hotbar for it, ready to stun |
elytra-wc-boost | false | true / false | Out of rockets mid-climb, a wind charge under the elytra for the height |
spear-dash | false | true / false | At the top of a launch, a wind charge and the spear on the same tick dash it across the gap |
dash-chain | false | true / false | Strings launches and spear dashes together to cover a long approach |
spear-macing | false | true / false | Launches for a smash from further out, letting the spear dash carry it in over them |
wc-reset | false | true / false | A smash that lands goes straight back up off a wind charge the same tick |
wc-self-reset | false | true / false | A wind charge under itself before a hard landing: the blast resets the fall |
stun-slam-variant | one-tick | one-tick / easy / optimal | How the stun slam goes in: one-tick (axe and mace the same tick), easy (axe, then the mace once it charges), optimal (only from a fall, so the mace part is a smash) |
ground-backstab | false | true / false | Beats a raised shield by getting behind it: past them, turn, mace their back (alternative to mace-stun) (an alternative to mace-stun: switching one on switches the other off) |
elytra-backstab | false | true / false | An elytra dive at a raised shield comes down behind it instead of pulling out |
spear-stun-slam | false | true / false | Axes a raised shield down, then follows with the spear's long jab |
shield-drain | false | true / false | A wind charge into someone turtling behind a shield, to knock them off their stance |
detap-spear-mace | false | true / false | On a low opponent: a spear jab, then the mace the tick their hit protection runs out |
detap-breach | false | true / false | A breach swap, then a second one the tick their hit protection runs out |
spear-double-pop | false | true / false | A smash that pops a totem is followed straight away by a spear jab to pop the next |
wc-cancel | false | true / false | A wind charge into an opponent going up for a smash, knocking them off course |
wc-cancel-chance | 10 | 0 – 100 | Percent of an opponent's launches wc-cancel goes for (never twice within 15 seconds) |
rocket-mace | climb | off / climb / spiral / angled / overhead | The elytra-mace climb-and-drop: climb (the usual), spiral (round them), angled (out, then a long run in), overhead (straight up over them) - or off, no rocket climbs |
elytra-spear | false | true / false | An elytra pass with the spear: rocket at them and jab on the way through |
elytra-chain | true | true / false | A Wind Burst smash throws it up: wings out, one rocket back over them and down again, until it misses |
pearl-catch | smart | smart / standard / instant / angle | The pearl catch for mace-pearl-launch: smart (picks per situation - recommended), standard (straight up), instant (charge from the off-hand, both throws back to back), angle (out over them) |
Survival
Group survival: healing, off-hand and combo answers.
| Setting | Default | Values | What it does |
|---|---|---|---|
healing | advanced | advanced / old | How it heals under pressure: advanced buys a gap first (knockback hit, web or short pearl), old just heals where it stands or runs |
offhand | auto | auto / totem / shield | What it keeps in its off-hand: auto (shield while healthy, totem when low), totem, or shield |
offhand-totem-hearts | 4.0 | 0.5 – 10 | Hearts at which a shield off-hand gives way to a totem (offhand: shield only) |
mace-totem | true | true / false | A totem in its main hand while a mace is about to land on it and its off-hand has none |
combo-answers | true | true / false | Being combo'd gets an answer: a crit back instead of a flat trade, a pearl out once it is clearly lost |
hunger-stop | true | true / false | Stops to eat at three hunger bars whatever it is doing, taking its best plain food |
Webs
Group webs.
| Setting | Default | Values | What it does |
|---|---|---|---|
web-prediction | false | true / false | Webs the ground an opponent closing in is about to walk onto, not the ground they are on |
head-web | false | true / false | With a wall behind the opponent, hits them into it and webs the block their head rises into |
hit-web | false | true / false | Half its webs: a knockback hit first, then the web where they land |
web-drain-chance | 100 | 0 – 100 | Percent of chances it takes to scoop up someone's escape water |
web-cut | true | true / false | Cuts itself out of a web: shears first (keeping the web), a sword when it has no bucket or pearl |
Escapes
Group escapes.
| Setting | Default | Values | What it does |
|---|---|---|---|
chorus-escape | false | true / false | Webbed and boxed in, it eats a chorus fruit to teleport out |
fire-escape | false | true / false | Burning with no fire resistance, it pours water on its own feet and takes the water back |
Regear
Group regear. See Regearing.
| Setting | Default | Values | What it does |
|---|---|---|---|
enderchest-regear | true | true / false | Regears from its ender chest like an SMP player: pearl away, chest down beside it, takes what it is short of (loose, or out of a shulker in it), mines it all back up (needs an ender chest in the bag) |
shulker-regear | true | true / false | Regears from a shulker box it carries: puts it down, restocks, mines it back up (no ender chest needed) |
regear-distance | 20.0 | 8 – 64 | How far off the opponent must be (or out of sight) before it opens anything |
shulker-restock | false | true / false | Walks to a placed shulker box nearby and takes what it is short of |
shulker-steal | false | true / false | Mines an opponent's placed shulker box mid-resupply and takes the drop |
Items
Group items: rods, tridents, splash potions, fireworks, the spear charge and block clutches.
| Setting | Default | Values | What it does |
|---|---|---|---|
fishing-rod | true | true / false | Hooks you with a fishing rod and reels you in - off a ledge, toward lava, back from running |
trident | true | true / false | Throws its trident (and waits for Loyalty to bring it back), rides Riptide in rain or water |
crossbow-ammo | true | true / false | Loads firework rockets from its off-hand into a crossbow for burst damage |
throw-potions | true | true / false | Throws Weakness, Slowness, Harming and Poison at you |
spear-charge | false | true / false | Holds use with a spear as it runs in - the charged spear attack (check it on your version) |
block-clutch | true | true / false | Without water, clutches a fall with a slime block, hay bale, cobweb or powder snow |
Team play
Group team. See Team play and armies.
| Setting | Default | Values | What it does |
|---|---|---|---|
focus-fire | true | true / false | In a faction: goes for the enemy its allies are on, and the weakest - low, broken armour, no totem |
peel | true | true / false | Leaves its own fight to hit whoever is on a nearly dead ally |
heal-allies | true | true / false | Throws its splash healing potions at a hurt ally close by |
regear-turns | true | true / false | Faction members regear one at a time instead of all leaving the fight together |
Armies
Group army: reaction ripple, pile-on cap, skill spread, morale and roles.
| Setting | Default | Values | What it does |
|---|---|---|---|
reaction-ripple | true | true / false | Orders, calls and new targets reach each bot after its own moment - nearest first, the odd one late - instead of the whole side turning on one tick |
pile-cap | 3 | 0 – 10 | Most bots on one enemy; the rest go for the next or wait at the edge for a way in (0 = no cap) |
skill-spread | 12 | 0 – 30 | Each bot's skill sits up to this far above or below its faction's, by its name (0 = all the same) |
morale | true | true / false | Outnumbered and losing members, the less brave run (a leader close by holds them and rallies them) |
roles | true | true / false | In an army: archers hang back, flankers come round the side, healers stay by the hurt |
loose-formations | true | true / false | Formations wobble round their slots, each bot at its own pace, turns ripple down the column, stragglers sprint-jump to catch up |
ally-care | true | true / false | No arrows through allies, no sword sweep into them, no standing inside each other |
Other parts of config.yml
These parts of config.yml can't be changed with /pvpbot set: edit the file, then run
/pvpbot reload.
| Key | Default | What it does |
|---|---|---|
active-preset | '' | The active preset. Changed with /pvpbot preset. |
presets | casual, sweaty, passive, easy, normal, hard, expert | The saved presets. See Presets. |
plugin.language | en | The language PvpBot talks in: en or it. Single lines can be changed in messages.yml. See Installation. |
plugin.update-check | true | Says in the console, and to admins as they join, when a newer PvpBot is out. |
plugin.metrics | true | Anonymous usage numbers through bStats. |
skins.random | missing | missing, always or off. See Skins and names. |
skins.built-in-pool | true | Use the few hundred skins that ship with the plugin. |
skins.pool | [] | Extra account names whose skins bots can wear. |
name-tables | default, bandits | Name lists for /pvpbot spawn names:<table>. |
companions.holding-world | test_world | The world companions are parked in while their owner is offline. See Companions. |