Documentation

Learn how to install and use LiquidBounce with our comprehensive guides

DocumentationModulesPlayerAutobuff

AutoBuff

AutoBuff keeps you topped up by automatically using or throwing buff items the moment you need them — healing soups, golden apples, enchanted player heads, and potions. Turn on the buff types you want, and it watches your health and surroundings, then drinks, eats, or splashes the right item for the situation without you having to manage your hotbar.

Each buff type is its own toggle with its own trigger conditions. Health-based buffs (Soup, Head, Gapple) only fire once your health drops to the threshold you set, while the potion options (Pot, Drink) react to which effects you're missing. When the needed item isn't in your hotbar, AutoSwap can silently switch to it, and Refill can quick-move spare buff items up from your main inventory so you never run dry mid-fight.

Use it on Kit-PvP, UHC, or survival servers where staying buffed is the difference in a fight. If you'd rather it back off while you're trading hits, the CombatPauseTime and NotDuringCombat options let you hold buffs until combat settles. For automatic eating to fill your hunger bar instead, see SmartEat.

Category: Player Enabled by default: No

Settings

SettingTypeDefaultRangeDescription
SoupToggleable GroupOff—Heals you by eating mushroom stew when your health is low.
Soup → HealthInteger401..100 %HPTrigger soup once health falls to this percent of your max.
Soup → ConsiderAbsorptionToggletrue—Counts absorption (yellow) hearts toward your health when deciding whether to eat.
Soup → DropAfterUseToggleable GroupOn—Drops the empty bowl after eating so it doesn't clutter your slot.
Soup → DropAfterUse → AssumeEmptyBowlToggletrue—Drops right away assuming the bowl is now empty, instead of waiting to confirm.
Soup → DropAfterUse → WaitInteger Range1..21..20 ticksRandom delay before dropping the bowl.
HeadToggleable GroupOff—Eats a player head for instant healing when your health is low.
Head → HealthInteger401..100 %HPTrigger the head once health falls to this percent of your max.
Head → ConsiderAbsorptionToggletrue—Counts absorption (yellow) hearts toward your health when deciding whether to eat.
Head → MaxAbsorptionDecimal1.00.0..8.0Only eats while your current absorption is at or below this amount.
Head → CooldownDecimal0.00.0..120.0 sMinimum wait between eating heads.
PotToggleable GroupOn—Throws splash potions at your feet to apply missing beneficial effects.
Pot → PotionsSetting Group——Choose which effects AutoBuff will splash for.
Pot → Potions → HealthToggleable GroupOn—Splashes Instant Health when you're hurt.
Pot → Potions → Health → HealthInteger401..100 %HPTrigger a health splash once health falls to this percent of your max.
Pot → Potions → RegenToggleable GroupOn—Splashes Regeneration when you're hurt and don't have it.
Pot → Potions → Regen → HealthInteger401..100 %HPTrigger a regen splash once health falls to this percent of your max.
Pot → Potions → StrengthToggleable GroupOn—Splashes Strength when you don't have the effect.
Pot → Potions → SpeedToggleable GroupOn—Splashes Speed when you don't have the effect.
Pot → Potions → FireResistanceToggleable GroupOn—Splashes Fire Resistance when you don't have the effect.
Pot → Potions → JumpBoostToggleable GroupOn—Splashes Jump Boost when you don't have the effect.
Pot → Potions → WaterBreathingToggleable GroupOn—Splashes Water Breathing when you don't have the effect.
Pot → TillGroundDistanceDecimal2.01.0..5.0Only throws when you're within this many blocks of the ground, so the splash lands on you.
Pot → DoNotBenefitOthersTogglefalse—Holds the throw if a nearby enemy would also catch the effect.
Pot → AllowLingeringTogglefalse—Also allows lingering potions, not just splash potions.
DrinkToggleable GroupOff—Drinks regular (non-splash) potions to apply missing beneficial effects.
Drink → PotionsSetting Group——Choose which effects AutoBuff will drink for.
Drink → Potions → HealthToggleable GroupOn—Drinks an Instant Health potion when you're hurt.
Drink → Potions → Health → HealthInteger401..100 %HPTrigger a health drink once health falls to this percent of your max.
Drink → Potions → RegenToggleable GroupOn—Drinks a Regeneration potion when you're hurt and don't have it.
Drink → Potions → Regen → HealthInteger401..100 %HPTrigger a regen drink once health falls to this percent of your max.
Drink → Potions → StrengthToggleable GroupOn—Drinks a Strength potion when you don't have the effect.
Drink → Potions → SpeedToggleable GroupOn—Drinks a Speed potion when you don't have the effect.
Drink → Potions → FireResistanceToggleable GroupOn—Drinks a Fire Resistance potion when you don't have the effect.
Drink → Potions → JumpBoostToggleable GroupOn—Drinks a Jump Boost potion when you don't have the effect.
Drink → Potions → WaterBreathingToggleable GroupOn—Drinks a Water Breathing potion when you don't have the effect.
GappleToggleable GroupOff—Eats a golden apple when your health is low.
Gapple → HealthInteger401..100 %HPTrigger the apple once health falls to this percent of your max.
Gapple → ConsiderAbsorptionToggletrue—Counts absorption (yellow) hearts toward your health when deciding whether to eat.
Gapple → EnchantedToggletrue—Also allows enchanted golden apples, not just regular ones.
AutoSwapToggleable GroupOff—Silently switches to the needed buff item if it isn't already selected, then switches back.
AutoSwap → DelayInInteger Range1..10..20 ticksRandom wait after swapping to the item before using it.
AutoSwap → DelayOutInteger Range1..10..20 ticksRandom wait after using the item before swapping back.
RefillToggleable GroupOn—Moves spare buff items from your inventory into the hotbar to keep you stocked.
Refill → ConstraintsSetting Group——See Shared: Inventory Constraints.
RotationsSetting Group——See Shared: Rotations.
CombatPauseTimeInteger20..40 ticksPauses combat actions for this long when a buff is used.
NotDuringCombatTogglefalse—Stops buffing entirely while you're in combat.

Last updated: 2026-06-08 — Based on source code