> 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

Blocks with your sword on the exact moment an incoming hit can land, cutting the damage you take without you holding right-click.

The *Smart Blockhit* module puts a short block pulse on the one moment it actually matters. Taking a hit starts a window of damage immunity, so the instant one lands the game tells you exactly when the next one can — and that is when the block goes down. You get at most one press per hit taken, never on your own clicks, so you soak damage without trading away your combo.

The first hit of a fight is never blocked. Nothing can block it — by the time you know a fight started, it has already landed.

{% hint style="warning" %}
Don't bind Smart Blockhit to right-click. While you physically hold right-click the module stands down and lets your hand own the button, so a right-click bind would do nothing at all.
{% endhint %}

## Block Lead

How early the block presses before your damage immunity lapses, from `0` to `300 ms` (default `80 ms`).

This is the setting that matters, and it scales with your connection — roughly your ping plus `50 ms`. Set it too low and the block reaches the server after their hit does, so you take the damage anyway. Set it too high and you spend time blocking instead of hitting.

## Block Duration

How long each block pulse lasts, from `50` to `500 ms` (default `180 ms`). The block is never held down — it is pressed for this long, then released.

Keep it above your **Block Lead**, or the block will already have lifted by the time the hit arrives.

## Yield Tail

How long the block stays down after each of your own left-clicks, from `0` to `200 ms` (default `0 ms`).

Leave this at `0`. Attacking while blocking works normally, so the tail is an escape hatch rather than a tuning knob — only raise it if you can see your hits being eaten.

## Whitelist

Smart Blockhit only fires while you hold one of the allowed item types. By default only **Swords** and **Axes** qualify, so it stays out of the way while you're placing blocks or holding tools.

* **Swords** — any sword
* **Axes** — any axe
* **Tools** — pickaxes, shovels, and hoes
* **Blocks** — any placeable block
* **Potions** — throwable or drinkable potions
* **Food** — edible items

## Conditions

Extra requirements that must all be true at once for Smart Blockhit to fire. Leave them unchecked to allow blocking 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:** set **Block Lead** to your ping plus about `50 ms` and leave everything else alone. That single number decides whether the module works — the defaults handle the rest.
{% endhint %}