For the complete documentation index, see llms.txt. This page is also available as Markdown.

Smart Blockhit

Automatically blocks with your sword during combat to reduce incoming damage while keeping your combo going.

The Smart Blockhit module triggers a block animation with your sword at the right moments in a fight β€” reducing the damage you take without requiring you to manually hold right-click. It can react to you taking damage, dealing damage, or fire proactively even before hits land.

Block Cooldown

A random delay chosen from this range between successive automatic block attempts, from 100 to 3000 ms (default 500 - 1500 ms). This prevents a perfectly metronomic blocking pattern.

Trigger thresholds

These settings decide how much combat must already be happening before the blocker engages.

  • Hurt Threshold β€” blocking will not trigger until you have taken this many hits in the current exchange, from 1 to 10 hits (default 2). Set higher to make blocking more reactive and less preemptive.

  • Target Hurt Threshold β€” blocking will not trigger until your target has taken this many hits, from 1 to 10 hits (default 2). Useful for ensuring you are actually in an active fight before the blocker engages.

  • Block On No Hits β€” when on, blocking can fire even if neither you nor the enemy has taken a hit yet. Useful for aggressive blocking at the start of a fight. Off by default.

Trigger modes

What rhythm the blocker keys off of.

  • Damage Take Mode β€” triggers a block when you take damage, reducing the impact of incoming hits. On by default.

  • Damage Give Mode β€” triggers a block immediately after you land a hit, the rhythm most commonly associated with natural blockhit play. On by default.

Whitelist

Smart Blockhit only fires while you hold one of the allowed item types. By default only Sword and Axe qualify. With nothing checked, blocking fires regardless of what you are holding.

  • Sword β€” any sword

  • Axe β€” any axe

  • Pickaxe / Shovel / Hoe β€” tools

  • Blocks β€” any placeable block

  • Potions β€” throwable or drinkable potions

  • Food β€” edible items

Conditions

Extra requirements that limit when Smart Blockhit is active. With nothing checked, it applies in any state.

  • Weapon Only β€” only while holding a weapon

  • Clicking Only β€” only while actively clicking

  • Standing, Sneaking, Walking, Sprinting β€” restrict to a movement state

  • On Ground / Air β€” restrict to grounded or airborne

  • Eating β€” only while eating

  • In Liquid β€” only while in water or lava

Auto disable

Turns Smart Blockhit off automatically when any selected event happens: On Death, On World Switch, On Server Leave, On Teleport, or On LagBack.

Last updated