🫀 Body Health System

NeoForge 1.21.1 · v12.0.3

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.

Stat Value Body parts 6 Fracture states 4 Medical items 3 Version 12.0.3

🦴 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

Part Effect when damaged Head Nausea (vision trouble) Torso Death at 0 HP Right arm Cannot break or place blocks Left arm Drops offhand item when destroyed Legs Slowness — worse as fracture progresses

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