🫀 Body Health System

NeoForge 1.21.1 · v12.3.4

Tired of a single health bar? Body Health System replaces Minecraft's vanilla health with a full localized injury system — every part of your body can be wounded, fractured, or destroyed independently.

⚙️ How it works

Each attack targets a specific body part based on impact height and trajectory. An arrow to the head deals 1.5× damage and counts against head HP — not a shared pool. Every part has its own hearts, its own fracture state, and its own consequences.

🦴 Fracture system

Parts move through four states:

Healthy → Sprained → Broken → Shattered

Each state brings real consequences. Broken legs slow you down, a shattered torso is immediately lethal. Fractures heal naturally over time or faster with the right items.

⚡ Consequences per part

All debuffs are silent — no visible effect icons, only action bar messages so your HUD stays clean.

💊 Medical items

🩹 Bandage

Craft: White Wool + String (×4)

Heals the most injured part and improves its fracture state by one level. Works on Sprained and Broken — not on Shattered.

🏥 Medical Kit

Craft: Bandages + Chest + Gold Ingots

Heals all parts and can fix even Shattered bones. The only way to recover from a destroyed limb.

💉 Morphine Syringe

Craft: Glass + Blaze Powder + Iron Ingot (×2)

Suppresses all pain effects for 30 seconds. Use sparingly — overdose triggers after 3 doses and causes blindness, nausea and poison.

❤️ Absorption hearts

Golden apples and Enchanted golden apples grant yellow absorption hearts on the most injured part. The Totem of Undying grants 2 extra hearts on the torso when it activates. Absorption is consumed before HP when that part takes damage.

🛡️ Enchantment support

Since the vanilla health bar is hidden and health is managed separately, all protection enchantments are applied manually per hit:

• Protection — 4% reduction per level (all damage)
• Fire Protection — 8% per level (fire/lava)
• Blast Protection — 8% per level (explosions)
• Projectile Protection — 8% per level (arrows)
• Feather Falling — 12% per level on legs only
• Slow Falling (potion) — cancels all fall damage on legs
• Resistance (potion) — 20% per level, level 5 = immunity

🖥️ HUD

A custom pixel-art panel in the bottom-right corner displays:

• Your character assembled from 6 individual sprites, each colored independently:
  • 🟢 Green = healthy (>65%)
  • 🟠 Orange = injured (35–65%)
  • 🔴 Red = critical (1–34%)
  • ⚫ Black = destroyed (0%)
  • Each part's hearts next to its label
  • Fracture icons next to the hearts when applicable
  • Yellow absorption hearts shown in surplus after the red hearts

🧰 Admin commands

/bodyhealth heal <player> [part]      — Heals a part or all parts
/bodyhealth set <player> <part> <hp>  — Sets HP directly
/bodyhealth setmax <player> <part> <hp> — Sets max HP
/bodyhealth addhearts <player> <n>    — Adds n hearts everywhere
/bodyhealth fracture <player> <part> <state> — Sets fracture state
/bodyhealth status <player>           — Shows full health status
/bodyhealth reset <player>            — Resets to default

👨‍💻 Developer API

Full Java API available via BodyHealthAPI:

// Read
float hp  = BodyHealthAPI.getHealth(player, BodyPart.HEAD);
boolean dead = BodyHealthAPI.isDead(player, BodyPart.TORSO);
FractureState fr = BodyHealthAPI.getFracture(player, BodyPart.LEG_LEFT);

// Write
BodyHealthAPI.heal(player, BodyPart.HEAD, 4f);
BodyHealthAPI.damage(player, BodyPart.TORSO, 2f);
BodyHealthAPI.fullHeal(player);
BodyHealthAPI.addMaxHealthAll(player, 4f); // +2 hearts everywhere
BodyHealthAPI.setFracture(player, BodyPart.ARM_RIGHT, FractureState.BROKEN);

A MCreator plugin is also available with 13 visual procedure blocks — no Java required.

✅ Compatibility

• Works with any mod using standard NeoForge damage events
• Food from third-party mods heals via FoodProperties automatically
• The Totem of Undying is fully supported
• Requires: NeoForge 21.1.172+ · Minecraft 1.21.1