Vitality Aids

Clarifaction: Just to be clear im definitely not a doctor.

Vitality Aids introduces a dynamic and strategic layer to Minecraft's health management, shifting the focus from passive regeneration to active, tactical medical intervention. Prepare for a more immersive and challenging survival experience where every wound matters.

In short it add base medicines that can cure all of the vanilla negative effects(plus Hemorrhage) and grant health, remove natural regeneration and been highly configurable for almost every aspect of the mod.

And into further details:

The Hemorrhage Effect: A Bleeding Edge Challenge

Hemorrhage is a debilitating status effect that transforms how you approach combat and survival. When applied, victims suffer from:

*Progressive Blood Loss: Taking continuous, painful damage over time.

*Debilitating Ailments: Inflicting additional negative status effects like Mining Fatigue and Weakness, severely impairing your ability to gather, fight, or escape.

*Healing Blocked: Standard food consumption will not restore health while Hemorrhage is active.

Activation [default] Conditions:

Hemorrhage can be triggered by critical combat scenarios, making careful maneuvering and preparation key:

*Massive Trauma: Taking 50% or more of your maximum health from a single, overwhelming attack.

*Low Health Vulnerability: Sustaining any damage while at or below 25% of your maximum health. This activation has a 50% chance for players and a 20% chance for other living entities (excluding undead).

This dangerous effect persists and escalates until specifically treated with specialized medicines, making prompt intervention crucial for survival.

Specialized Medicines: Your Lifeline

Vitality Aids introduces a wide array of unique medicines designed for specific treatments and recoveries. Unlike vanilla potions, these medicines require active application and offer targeted effects:

*Active Application: Medicines have a configurable application_time (e.g., 2-3 seconds) during which the player is slowed and vulnerable, adding a tactical element to healing in combat.

*Unique Animations & Particles: Each medicine can be configured to use distinct vanilla animations (like eating, drinking, or even crossbow loading) and emit unique particle effects during application and upon completion.

Targeted Effects: Medicines can be configured to:

1. Directly heal health points.
2. Clear specific negative status effects (e.g., Poison, Wither, Slowness, Nausea).
3. Grant beneficial status effects (e.g., Regeneration, Speed, Absorption, Glowing) with custom durations and amplifiers.
4. Hemorrhage Cure: Certain potent medicines are the only way to stop and cure the Hemorrhage effect, making them indispensable.

Control Over Your Healing Experience

*Natural Regeneration Control: The mod provides a configurable option to automatically set the vanilla natural_regeneration game rule. By default, this is set to false, effectively prioritizing Vitality Aids' medicines as the primary method of health recovery.

*Milk Bucket Override: By default, consuming a milk bucket will no longer clear all status effects. This ensures that the strategic importance of Vitality Aids' specialized medicines for cleansing specific ailments remains paramount.

*Can also apply medicines to others.

Highly Configurable: Tailor Your Survival

Vitality Aids is designed with extensive configurability, allowing modpack creators and players to fine-tune nearly every aspect of the mod to fit their desired difficulty and gameplay style and to add new custom medicines(to remove medicines delete their entry in the medicines field).
The configuration file, vitality_aids.json, found in your config directory, contains all tunable parameters:

{
  // --- Global Mod Settings ---
  "global_settings": {
    "natural_regeneration_enabled": false, // If true, the vanilla 'natural_regeneration' game rule will be set to true; if false, it will be set to false.
    "disable_milk_clears_effects": true // If true, consuming a milk bucket will NOT clear all status effects.
  },
  // --- Hemorrhage Effect Settings ---
  "hemorrhage_settings": {
    "hemorrhage_effect_enabled": true, // Global toggle to enable/disable the Hemorrhage system.
    "hemorrhage_prevent_food_healing_enabled": true, // If true, players with Hemorrhage cannot heal from food (prevents natural regeneration and specific status effects like vanilla Regeneration).
    "damage_threshold_percent_single_hit": 0.5, // Hemorrhage activates if damage taken is > this % of max health from a single hit (e.g., 0.5 = 50%).
    "damage_at_low_health_threshold_percent": 0.25, // Hemorrhage activation condition: if damage taken when health is <= this % of max health.
    "low_health_activation_chance_player": 0.5, // Chance (0.0-1.0) for players to get Hemorrhage if low health damage condition met.
    "low_health_activation_chance_mob": 0.2, // Chance (0.0-1.0) for other mobs to get Hemorrhage if low health damage condition met (excluding undead).
    "damage_per_tick": 0.1, // Amount of health lost per tick while under the Hemorrhage effect.
    "mining_fatigue_level": 1, // Level of Mining Fatigue applied while under Hemorrhage (0-indexed, so 0=Level I, 1=Level II).
    "weakness_level": 1, // Level of Weakness applied while under Hemorrhage (0-indexed).
    "effect_duration_in_ticks": 9999, // Default duration (in ticks, 20 ticks = 1 second) for the Hemorrhage status effect if not cleared.
    "effect_amplifier": 0, // Default amplifier (level) for the Hemorrhage status effect (0-indexed).
    "effect_particles": true, // Whether Hemorrhage status effect shows particles.
    "effect_ambient": false, // Whether Hemorrhage status effect is ambient (less intrusive particles/sound).
    "effect_icon": true // Whether Hemorrhage status effect shows an icon in the GUI.
  },
  // --- Medicines Definition ---
  "medicines": [
    {
      "id": "bandage", // Unique identifier for this medicine item.
      "max_stack_count": 64, // Maximum stack size for this item in inventory (e.g., 16 or 64).
      "texture_path": "item/bandage", // Path to the item's texture within your mod's assets (e.g., assets/vitality_aids/textures/item/bandage.png).
      "healing_amount": 2.0, // Amount of health restored by this medicine (2.0 = 1 heart).
      "clears_hemorrhage": true, // If true, using this medicine will remove the the Hemorrhage effect.
      "cooldown_ticks": 160, // Cooldown (in ticks) after using this medicine before it can be used again (20 ticks = 1 second).
      "application_time_ticks": 60, // Time (in ticks) the player spends "using" the medicine (e.g., eating animation duration).
      "slowness_level_on_apply": 2, // Level of Slowness applied to the player while applying this medicine (1-indexed, so 1=Level I).
      "use_action": "CROSSBOW", // Animation played by the player during use ("EAT", "DRINK", "BOW", "CROSSBOW", "SPEAR", "BLOCK", "BRUSH", "TOOT_HORN", "CUSTOM").
      "usage_tick_particle_id": "minecraft:instant_effect", // ID of the particle to spawn repeatedly during item application (e.g., "minecraft:happy_villager", "minecraft:instant_effect").
      "usage_tick_particle_frequency": 4, // Frequency of particles during application (lower number = more frequent, e.g., 4 means 1/4 chance per tick).
      "finish_use_particle_id": "minecraft:heart", // ID of the particle to spawn in a burst when item application is finished.
      "finish_use_particle_count": 6, // Number of particles in the burst when item application is finished.
      "gives_effects": {}, // Map of status effects given by this medicine. Format: "minecraft:effect_id": { "duration_ticks": X, "amplifier": Y }.
      "clears_effects": [], // List of status effect IDs that this medicine will clear (e.g., "minecraft:poison").
      "tooltip_lines": [ // Custom tooltip lines for the item, supports Minecraft's section formatting codes (§).
        "§7A basic vital item, the bandage stops bleeding and restore health.",
        "§aHeals 1 heart."
      ]
    },
    {
      "id": "fermented_spider_eye_serum",
      "max_stack_count": 8,
      "texture_path": "item/fermented_spider_eye_serum",
      "healing_amount": 0.0,
      "clears_hemorrhage": false,
      "cooldown_ticks": 280,
      "application_time_ticks": 60,
      "slowness_level_on_apply": 3,
      "use_action": "DRINK",
      "usage_tick_particle_id": "minecraft:effect",
      "usage_tick_particle_frequency": 2,
      "finish_use_particle_id": "minecraft:witch",
      "finish_use_particle_count": 10,
      "gives_effects": {
        "minecraft:absorption": {
          "duration_ticks": 2400,
          "amplifier": 0
        }
      },
      "clears_effects": [
        "minecraft:wither"
      ],
      "tooltip_lines": [
        "§7This serum uses potent properties of fermented spider eyes.",
        "§bClears Wither.",
        "§6Grants Absorption."
      ]
    }
   // ... (other medicine entries would follow here with similar detailed comments) ...
  ]
}

Default Medicines Included:

Vitality Aids comes with a set of default medicines, each with unique properties and tactical uses:

*Bandage: A basic vital item that stops bleeding (Hemorrhage) and restores health. It's also effective at alleviating physical exhaustion, making it a reliable cure for Mining Fatigue.

*Slime Plaster: Made from sticky slime, this plaster is highly effective in severe conditions, providing robust healing.

*Kelp Plaster: A simple and natural remedy known for its quick application, offering healing and effectively combating Levitation.

*Fermented Spider Eye Serum: This potent serum uses unique properties to clear the debilitating Wither effect and grant temporary Absorption.

*Mushroom Tincture: Extracted from mushrooms, this tincture is a powerful cure, restoring health and cleansing both Weakness, Blindness, and Hemorrhage.

*Glow Berry Poultice: Made from glowing berries, this poultice not only illuminates the user (Glowing) and promotes Regeneration but also effectively clears Darkness.

*Herbal Salve: A blend of forest herbs, this versatile salve is a remedy for those who suffer from Slowness and Nausea.

*Honey Ointment: Honey, nature's miracle, is mixed to create this ointment. It not only promotes Regeneration and energizes the user with Speed but also clears Hunger.

*Spider Eye Antiseptic: Despite its gruesome ingredients, this antiseptic is highly effective. Made from spider eyes, it neutralizes Poison and restores health.

Recommendations:

*ToolTipFix: To prevent tooltips from going off-screen, especially with detailed medicine descriptions.
*REI/JEI (Roughly Enough Items/Just Enough Items): For easy access to all crafting recipes and item information.
*First-person Model: For better animation.

*Complete remake from scratch of the project that was formerly known as First Aid(Fabric)

*For Forge version it does work with Sinytra Connector mod(1.20.1)

Don't forget to carry Medicines at all times – they are a life-saver!