DoxPartHealth

### Short description

A **per-limb health** system. Each body part — head, torso, both arms, both legs — has its **own HP pool** (100 total), and the vanilla health bar mirrors the sum. Damage is routed to the hit part: it absorbs first, overflow **cascades** to the torso (with falloff); a destroyed limb “blacks out”. Zeroing the head is lethal; a zeroed torso spreads overflow across surviving parts. Blacked-out limbs apply **debuffs** (movement/attack slowness, weapon spread, recoil, view tremor via DoxEffect). Restore parts with **Tarkov-style healing items** — bandages/medkits over a cast time, and a **surgery kit** to revive a blacked-out limb. A read-only part-health grid overlays the vanilla inventory.

### Features

– **6-part HP** (head/torso/arms/legs), proportional vanilla-health mirroring (works at any max health).

– **Damage cascade** — hit part absorbs, overflow transfers to torso; head 0 = death, torso 0 = spread to survivors.

– **Blackout debuffs** via DoxEffect — legs slow movement, arms slow attacks and worsen gun spread/recoil/tremor (stacking, mirrored to vanilla effect icons).

– **Healing** — cast-time channels (bandage/medkit/large medkit) + **surgery kit** to un-blackout a limb; cancel on move/swap; in-world progress bar and heal motion. All four items are **craftable from vanilla materials** (no Create dependency).

– **Vanilla damage & healing routed to parts** — falls split across both legs, other environmental damage (fire/drown/explosion/poison) to the torso; vanilla healing (natural regen, golden apple, regen potions) refills damaged parts too, keeping the part sum and the health bar in lockstep (blacked-out parts still need a surgery kit).

– **Inventory overlay** — a body-part health grid beside the vanilla inventory.

– **Auto-track on join** (config `autoTrackOnJoin`, default on) — part health active out-of-the-box, independent of any backpack/grid.

– **Translated into 20 languages** — including body part names, which were hardcoded before and could not be changed even with a resource pack.

### Commands

– `/doxhealth` — show your own part health. `status`, `reset`, `damage <region> <amount>`, `heal <region> <amount>` for testing.

– `/doxtacz hp …` — the old name, still accepted. It dates from when this was part of another mod.

### Minecraft versions

This mod ships two lines, and they are not interchangeable:

– **1.x** — Minecraft 1.20.1, Forge

– **2.x** — Minecraft 1.21.1, NeoForge

Both are maintained. Pick the file whose major version matches your loader; a 1.x file will simply not load on 1.21.1, and vice versa. Dependencies follow the same rule — 2.x mods require 2.x of the Dox mods they depend on.

### Requirements

– **DoxCore** + **DoxEffect** (required, matching version line). **DoxHitbox** (optional — enables per-part hit resolution; without it, damage hits total HP only).

### For modders

– `PartHealthManager.applyGunDamage(player, regionId, dmg)` — route damage to a body part (returns the vanilla delta / lethal signal); `isTracked`, `heal`, `blackedArms`, `syncToClient`.

– Tracking is a player tag (`doxparthealth`); auto-assigned on join (configurable).