# PartsVitality<\/p>\n
**A hardcore damage and healing system for Minecraft, inspired by “Escape from Tarkov.”**<\/p>\n
PartsVitality completely overhauls Minecraft’s standard health system by introducing a detailed part-based HP system. This plugin demands more tactical thinking, careful injury management, and a new level of awareness from players. Deciding which body part to target and which to protect, constantly monitoring your own condition and surroundings, and engaging in tense gameplay where a single moment of carelessness can be fatal becomes crucial.<\/p>\n
> [!NOTE] > **No Resource Pack Required!** All features, including the part HP display, are achieved using vanilla mechanics. Players don’t need to download anything extra to get the full experience.<\/p>\n
## Key Features<\/p>\n
– **Part-Based HP System**: Health is not a single bar but is managed individually across four body parts: “Head,” “Chest,” “Legs,” and “Feet.”
\n– **Precise Hit Detection**: Using Ray Tracing technology, the plugin accurately determines which body part an attack hits. Tactics like headshots or aiming for the legs become vital!
\n– **Realistic Injury Penalties**:
\n – **Debuff Effects**: Taking damage to a specific part triggers corresponding debuffs (e.g., Nausea from head damage, Slowness from leg damage).
\n – **Broken Parts**: When a part’s HP drops to 0, it becomes “broken,” reducing the player’s maximum HP until they respawn.
\n– **Manual Healing System**:
\n – **No Natural Regeneration**: Automatic health regeneration from saturation is disabled. All healing must be done manually.
\n – **Part-Specific Healing**: Use items defined in `config.yml` to heal by clicking the corresponding armor piece for the injured part in the inventory.
\n – **Surgery for Critical Injuries**: “Broken” parts cannot be healed with regular items. A special “surgery” item is required for first aid, making the part treatable again.
\n– **Enhanced Importance of Armor**:
\n – **Part Protection**: Armor plays a crucial role in protecting the specific body part it covers.
\n – **Realistic Wear and Tear**: Armor durability can be configured to decrease significantly based on the damage received, making it a critical resource to manage.
\n– **Highly Customizable**: Nearly every aspect of the plugin\u2014part HP, damage multipliers, healing items, debuffs, and more\u2014can be freely adjusted in `config.yml`.
\n– **Multi-Language Support**: All messages displayed to players are translatable. It supports English (`en`) and Japanese (`ja`) by default.<\/p>\n
## Installation<\/p>\n
1. Download the latest `.jar` file.
\n2. Place the downloaded `PartsVitality-v1.0.0-beta.1.jar` file into your server’s `plugins\/` folder.
\n3. Restart or reload the server. The configuration file (`config.yml`) and language files (`messages_en.yml`, `messages_ja.yml`) will be automatically generated in the `plugins\/PartsVitality\/` folder.<\/p>\n
## Compatibility<\/p>\n
This plugin was developed on the **Paper API 1.20.1** and tested on a **Purpur 1.21.1** server.<\/p>\n
It is expected to work on most modern Paper\/Purpur versions, but these are the officially supported environments for this release.<\/p>\n
## Configuration (`config.yml`)<\/p>\n
You can edit the `config.yml` file to fine-tune the plugin’s behavior to match your server’s difficulty and playstyle.<\/p>\n “`yaml # Max HP for each body part # Damage calculation settings # Settings for regular healing # Settings for surgery (healing broken parts) # Max health penalty for each broken part (2.0 = 1 heart). # Items used for regular healing and their heal amount. # Items used for surgery (only usable on parts with 0 HP). # Debuffs applied when a part’s HP falls below a certain threshold. # Durability settings ## How to Play<\/p>\n – **Check Part HP**: In your inventory, hover over any armor piece and **Shift + Right-Click** to switch to Part HP display mode. The armor’s durability bar will now show the HP of that part. Repeat the action to switch back.<\/p>\n <\/p>\n – **Heal a Part**: Hold a healing item (e.g., Iron Ingot) on your cursor and **Left-Click** the armor piece of the part you want to heal in your inventory. A timer will start, and upon completion, the part’s HP will be restored.<\/p>\n <\/p>\n – **Perform Surgery**: If a part is broken (HP is 0), you must first treat it with a surgery item (e.g., Diamond). This will slightly restore the part’s HP, allowing it to be healed with regular healing items again.<\/p>\n <\/p>\n ## License<\/p>\n This plugin is released under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":" A hardcore damage and healing system for Minecraft, inspired by “Escape from Tarkov.”<\/p>\n","protected":false},"featured_media":119602,"template":"","meta":{"_minecraft_slug":"partsvitality","_minecraft_project_id":"WPAqlPEC","_minecraft_author":"Braur0","_minecraft_license":"MIT","_minecraft_downloads":71,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"partsvitality.zip","_minecraft_size_bytes":77540,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:26:28.426532Z","_minecraft_date_created":"2025-09-22T05:39:21.601451Z","_minecraft_date_modified":"2025-09-21T08:29:15.247952Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/partsvitality","_minecraft_icon_attachment_id":119602,"_minecraft_imported_at":"2026-06-07T00:52:07+00:00","_minecraft_import_hash":"e5c76361dfa828ac701841f368e38215","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,128],"mod_loader":[132,133],"minecraft_version":[36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-119601","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nClick to see a detailed explanation of config.yml<\/strong><\/summary>\n
\n# Set the language to use (e.g., en, ja)
\nlanguage: “en”<\/p>\n
\nparts:
\n head:
\n max-hp: 20.0
\n chest:
\n max-hp: 29.0
\n # … and so on<\/p>\n
\ndamage:
\n # Multiplier to convert vanilla heart damage to part damage.
\n # A higher value makes parts break more easily, increasing difficulty.
\n damage-multiplier: 5.0
\n # Precision of the hit detection. Larger values reduce server load but decrease accuracy. (Recommended: 0.1 ~ 0.5)
\n ray-trace-step: 0.1<\/p>\n
\nhealing:
\n # Time required for healing (in seconds).
\n duration-seconds: 3
\n # … sound settings …<\/p>\n
\nsurgery:
\n # Time required for surgery (in seconds).
\n duration-seconds: 10
\n # Amount of part HP restored by surgery. Setting this to 1.0 will make the part usable again and allow normal healing.
\n restored-hp: 1.0
\n # … sound settings …<\/p>\n
\nhealth-penalty-per-broken-part: 5.0 # 2.5 hearts<\/p>\n
\nhealing-items:
\n IRON_INGOT: 10.0
\n GOLD_INGOT: 15.0<\/p>\n
\nsurgery-items:
\n DIAMOND: true<\/p>\n
\ndebuffs:
\n head:
\n – threshold: 0.5 # 50% or less
\n effect: CONFUSION
\n level: 0
\n # … and so on<\/p>\n
\ndurability:
\n # If true, armor durability decreases based on the amount of part damage received.
\n use-custom-durability-damage: true
\n # How much part damage equals 1 point of durability damage.
\n # A smaller value means armor wears out faster. 0.4 is balanced around leather armor.
\n damage-per-durability-point: 0.4
\n“`<\/p>\n<\/details>\n