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