PartsVitality
A hardcore damage and healing system for Minecraft, inspired by "Escape from Tarkov."
71
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
PartsVitality
PartsVitality
A hardcore damage and healing system for Minecraft, inspired by "Escape from Tarkov."
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.
> [!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.
Key Features
- Multi-Language Support: Health is not a single bar but is managed individually across four body parts: "Head," "Chest," "Legs," and "Feet." - Multi-Language Support: Using Ray Tracing technology, the plugin accurately determines which body part an attack hits. Tactics like headshots or aiming for the legs become vital! - Multi-Language Support: - Multi-Language Support: Taking damage to a specific part triggers corresponding debuffs (e.g., Nausea from head damage, Slowness from leg damage). - Multi-Language Support: When a part's HP drops to 0, it becomes "broken," reducing the player's maximum HP until they respawn. - Multi-Language Support: - Multi-Language Support: Automatic health regeneration from saturation is disabled. All healing must be done manually. - Multi-Language Support: Use items defined in `config.yml` to heal by clicking the corresponding armor piece for the injured part in the inventory. - Multi-Language Support: "Broken" parts cannot be healed with regular items. A special "surgery" item is required for first aid, making the part treatable again. - Multi-Language Support: - Multi-Language Support: Armor plays a crucial role in protecting the specific body part it covers. - Multi-Language Support: Armor durability can be configured to decrease significantly based on the damage received, making it a critical resource to manage. - Multi-Language Support: Nearly every aspect of the plugin—part HP, damage multipliers, healing items, debuffs, and more—can be freely adjusted in `config.yml`. - Multi-Language Support: All messages displayed to players are translatable. It supports English (`en`) and Japanese (`ja`) by default.
Installation
1. Download the latest `.jar` file. 2. Place the downloaded `PartsVitality-v1.0.0-beta.1.jar` file into your server's `plugins/` folder. 3. 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.
Compatibility
This plugin was developed on the Purpur 1.21.1 and tested on a Purpur 1.21.1 server.
It is expected to work on most modern Paper/Purpur versions, but these are the officially supported environments for this release.
Configuration (`config.yml`)
You can edit the `config.yml` file to fine-tune the plugin's behavior to match your server's difficulty and playstyle.
Click to see a detailed explanation of config.yml
```yaml
Set the language to use (e.g., en, ja)
language: "en"
Max HP for each body part
parts: head: max-hp: 20.0 chest: max-hp: 29.0
... and so on
Damage calculation settings
damage:
Multiplier to convert vanilla heart damage to part damage.
A higher value makes parts break more easily, increasing difficulty.
damage-multiplier: 5.0
Precision of the hit detection. Larger values reduce server load but decrease accuracy. (Recommended: 0.1 ~ 0.5)
ray-trace-step: 0.1
Settings for regular healing
healing:
Time required for healing (in seconds).
duration-seconds: 3
... sound settings ...
Settings for surgery (healing broken parts)
surgery:
Time required for surgery (in seconds).
duration-seconds: 10
Amount of part HP restored by surgery. Setting this to 1.0 will make the part usable again and allow normal healing.
restored-hp: 1.0
... sound settings ...
Max health penalty for each broken part (2.0 = 1 heart).
health-penalty-per-broken-part: 5.0 # 2.5 hearts
Items used for regular healing and their heal amount.
healing-items: IRON_INGOT: 10.0 GOLD_INGOT: 15.0
Items used for surgery (only usable on parts with 0 HP).
surgery-items: DIAMOND: true
Debuffs applied when a part's HP falls below a certain threshold.
debuffs: head: - threshold: 0.5 # 50% or less effect: CONFUSION level: 0
... and so on
Durability settings
durability:
If true, armor durability decreases based on the amount of part damage received.
use-custom-durability-damage: true
How much part damage equals 1 point of durability damage.
A smaller value means armor wears out faster. 0.4 is balanced around leather armor.
damage-per-durability-point: 0.4 ```
How to Play
- Shift + Right-Click: 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.
- Left-Click: 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.
- 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.
License
This plugin is released under the MIT License.
