> For the complete documentation index, see [llms.txt](https://docs.akiraghost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akiraghost.com/product-guides/akira-jni/features/combat/blockhit.md).

# Smart Blockhit

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**.

{% hint style="success" %}
**Recommended:** enable both **Damage Give Mode** and **Block On No Hits** together. This forces blocking throughout your combo aggressively, without requiring you to absorb damage before the blocker activates.
{% endhint %}