Skip to content
Body Health

Quick rating

Community listing page, reviews may not be monitored by the author.

Body Health

By Smiley_53Owner

No reviews yet

Life in every part of the body.

Mod Loaders
Minecraft
26.3 26.2

About

Description

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