🫀 Body Health System

Localized injuries for Minecraft 1.21.1 · NeoForge

Tired of a single health bar? Body Health System replaces vanilla health with a body-part system: your head, torso, arms and legs each have their own hearts, their own critical state and their own consequences.

📦 Install on both the server and the clients. 🔁 Full off switch: set enabled = false in the server config and the game goes back to pure vanilla.

---

⚙️ How damage works

Every hit lands on a specific body part and is multiplied by that zone:

Zone	Damage
Head	×1.5
Torso	×1.0
Legs	×0.9
Arms	×0.85

Where a hit lands depends on its source:

Source	Body part
Melee and projectiles	Resolved from the impact position (an arrow to the head hits the head)
Falling, hot floor	A leg
Falling anvil / block / stalactite, flying into a wall	Head
Explosions, lightning	Random part
Drowning, starvation, suffocation, fire, lava	Torso
Poison, wither, magic	A random arm or leg — never head or torso, so a poison tick can't kill you outright

Armor enchantments are applied to every hit: Protection, Fire / Blast / Projectile Protection, Feather Falling (legs), and the Resistance and Slow Falling effects.

---

🩸 Critical states and effects

• Head and torso become critical below ⅓ of their max HP.
• Arms and legs have no intermediate state — they are destroyed at 0 HP.

Condition	Consequence
Head or torso critical	Weakness
Head critical	Nausea (blurred vision)
Arms destroyed	Mining Fatigue
Legs destroyed	Slowness
Right arm destroyed	Cannot break or place blocks
Left arm destroyed	Drops the offhand item
Torso at 0 HP	Death

Effects are applied silently (no effect icons cluttering your screen). Warnings appear above the hotbar and can be switched off.

---

💛 Absorption

Golden apples (and Notch apples) give yellow absorption hearts on the most injured body part. The Totem of Undying saves you once and grants +2 ❤ on the torso. Absorption is consumed before real HP.

---

💊 Medical items

Item	Recipe	Effect
🩹 Bandage	Wool + String (×4)	+1.5 ❤ on the most injured part (3 s)
🏥 Medical Kit	Bandages + Chest + Gold	+3 ❤ on every part (5 s)
💉 Morphine Syringe	Glass + Blaze Powder + Iron (×2)	Suppresses effects for 30 s and grants Resistance II, but blocks regeneration — 3 injections in 2 minutes cause an overdose
📖 Survival Guide	Book + Bone	Right-click for your current status and a quick reference

Parts also regenerate slowly on their own, and food and potions heal your body parts.

---

🖥️ HUD

A pixel-art character in the bottom-right corner, one sprite per body part, colour-coded from green (healthy) through orange and red to black (destroyed), with each part's hearts next to it. Absorption shows as yellow hearts after the red ones.

Press H (rebindable in Controls) to move and resize it. It is hidden in Creative mode.

---

🔧 Configuration

Server — bodyhealth-server.toml

Option	What it does
enabled	false restores vanilla behaviour completely (health bar, food, potions, golden apples, totem)
startingHearts	Hearts per body part for new players
actionBarMessages	Show or hide the warnings above the hotbar
enableNausea, enableSlowness, enableOffhandDrop, enableBlockingDisable	Toggle individual effects
[regeneration], [food]	Natural regeneration rate and how much food heals

Client — bodyhealth-client.toml

Option	What it does
compactGuide	The Survival Guide only lists injured parts instead of the full reference

Your data is saved twice: in the player's NBT and as a readable world/bodyhealth/<UUID>.json.

---

🧰 Commands (operators)

/bodyhealth heal <players> [part]
/bodyhealth set <players> <part> <hp>
/bodyhealth setmax <players> <part|all> <hp>
/bodyhealth addhearts <players> <hearts>
/bodyhealth status <players>
/bodyhealth reset <players>

Parts: head, torso, arm_right, arm_left, leg_right, leg_left.

---

👨‍💻 For developers

float hp     = BodyHealthAPI.getHealth(player, BodyPart.HEAD);
boolean dead = BodyHealthAPI.isDead(player, BodyPart.TORSO);

BodyHealthAPI.heal(player, BodyPart.HEAD, 4f);
BodyHealthAPI.fullHeal(player);
BodyHealthAPI.addMaxHealthAll(player, 4f);

// Every player — online now, or offline (applied at their next login)
BodyHealthAPI.applyToAll(data -> data.addMaxHealthAll(4f));

Add the mod as a dependency to use it from your own mod or from MCreator custom-code blocks.

---

🌍 Languages

English and French are complete. Item tooltips are also translated into German, Spanish, Portuguese, Italian, Dutch, Russian, Ukrainian, Polish, Czech, Chinese, Japanese, Korean, Turkish and Arabic. Anything untranslated falls back to English.

---

✅ Requirements

• Minecraft 1.21.1
• NeoForge 21.1.172+

📂 Source code and release notes: https://github.com/Smiley-droid/bodyhealth

🙏 Credits

The Medical Kit texture and the critical-effect design are inspired by Body-Health-System by SrGnis (MIT).