PartsVitality

Minecraft 版本： 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8

平台： paper purpur

标签： adventure game-mechanics

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

• Part-Based HP System: Health is not a single bar but is managed individually across four body parts: "Head," "Chest," "Legs," and "Feet."
• 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!
• Realistic Injury Penalties:
  • Debuff Effects: Taking damage to a specific part triggers corresponding debuffs (e.g., Nausea from head damage, Slowness from leg damage).
  • Broken Parts: When a part's HP drops to 0, it becomes "broken," reducing the player's maximum HP until they respawn.
• Manual Healing System:
  • No Natural Regeneration: Automatic health regeneration from saturation is disabled. All healing must be done manually.
  • Part-Specific Healing: Use items defined in config.yml to heal by clicking the corresponding armor piece for the injured part in the inventory.
  • 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.
• Enhanced Importance of Armor:
  • Part Protection: Armor plays a crucial role in protecting the specific body part it covers.
  • Realistic Wear and Tear: Armor durability can be configured to decrease significantly based on the damage received, making it a critical resource to manage.
• Highly Customizable: 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 Paper API 1.20.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

• 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.

  

• 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.

  

• 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.