Body Health

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