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. > > **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. <details> <summary><strong>Click to see a detailed explanation of config.yml</strong></summary> ```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