Progressive Mechanics Library

This is a library mod aimed to allow my mods and other mods have great control over damage and some combat mechanics
By default this mod does this
Modifies damage type done when landing a critical strike, allowing mods to easily track down if an attack is a critical hit. Damage type is "pml:player_critical"
Modifies damage type done when dealing a sweeping attack. Damage type is "pml:sweeping_damage".

For Mod developers
It adds a new way to register and add damage bonuses and reductions alongside making this work with First Aid Mod to allow control over damaged bodyparts

The DamageControl class is a core component. It provides a structured way to modify, control, and calculate damage values before they are applied in the game.

This system allows for multiple modifiers, including flat bonuses, percentage-based bonuses, and reductions from armor, enchantments, and special mechanics.

🔧 How It Works:

• The system starts with raw base damage.

• It applies weapon-specific scaling (reducing damage before further calculations).

• Base bonuses are applied first (flat and percentage-based).

• Additional bonuses are applied next (flat and percentage-based).

• The system calculates reductions (armor, enchantments, special reductions).

• The final damage is stored and can be retrieved or modified in LivingDamageEvent.

📊 Breakdown of Variables:

🛠️ Modifiers for Increasing Damage

🛡️ Modifiers for Reducing Damage

📌 Original Values for Reference

🛠️ Key Methods

• 🛡️ getArmorReduction() 
✅ Returns: The amount of damage reduction due to armor.
💡 Usage: This value is set by setArmorReduction(float value) and represents the amount of damage blocked by armor-based mechanics (e.g., vanilla armor calculations or custom armor effects from other mods).

• 🔮 getEnchantmentReduction()
✅ Returns: The amount of damage reduction caused by enchantments.
💡 Usage: This tracks how much defensive enchantments (such as Protection or custom enchantments) reduce the final damage. Mods can use this to balance enchantment effects or display them in tooltips.

• ⚠️ getSpecialReduction()
✅ Returns: The amount of direct damage reduction applied through special mechanics.
💡 Usage: This is the most powerful form of damage reduction, as it is subtracted at the very end of the damage calculation. Mods should use this carefully because it can completely negate damage if too high.



  📌 First Aid Mod Compatibility System

  This system integrates with the First Aid mod, which modifies how damage is handled by introducing body-part-specific injuries. The following code helps track which body part was damaged when using the First Aid mod and ensures compatibility with the DamageControl system.

🛠️ Key Methods

🔍 getDamagedBodyPart(Player player)

✅ Purpose: Retrieves the body part that was damaged. Returns a EquipmentSlot var corresponding to the bodypart damaged.
💡 Usage:

• This method should only be used during LivingDamageEvent and when First Aid is present.

• If the player isn't mapped, it returns null.
  
  
  

One example of use is inside the mod Forgotten Nunchakus.

This is a library mod aimed to allow my mods and other mods have great control over damage and some combat mechanics By default this mod does this Modifies damage type done when landing a critical strike, allowing mods to easily track down if an attack is a critical hit. Damage type is "pml:player_critical" Modifies damage type done when dealing a sweeping attack. Damage type is "pml:sweeping_damage".

For Mod developers It adds a new way to register and add damage bonuses and reductions alongside making this work with First Aid Mod to allow control over damaged bodyparts

The DamageControl class is a core component. It provides a structured way to modify, control, and calculate damage values before they are applied in the game.

This system allows for multiple modifiers, including flat bonuses, percentage-based bonuses, and reductions from armor, enchantments, and special mechanics.

🔧 How It Works: The system starts with raw base damage.

It applies weapon-specific scaling (reducing damage before further calculations).

Base bonuses are applied first (flat and percentage-based).

Additional bonuses are applied next (flat and percentage-based).

The system calculates reductions (armor, enchantments, special reductions).

The final damage is stored and can be retrieved or modified in LivingDamageEvent.

📊 Breakdown of Variables: 🛠️ Modifiers for Increasing Damage Variable Description baseFlatBonus Flat bonus added before percentage multipliers (e.g., +10 damage). basePercentBonus Percentage-based increase applied before other calculations (e.g., 1.2 multiplier). flatBonus Flat bonus added after base bonuses (e.g., +5 damage). percentBonus Percentage-based increase applied after base calculations. 🛡️ Modifiers for Reducing Damage Variable Description weapondamagecontrol Controls weapon-based scaling before all calculations. armorReduction Damage reduced due to armor (handled separately). enchReduction Damage reduced due to enchantments (handled separately). specialReduction Directly reduces final damage, so it must be used carefully. 📌 Original Values for Reference

Variable Description originalDamage Stores the final damage after all calculations, ready for LivingDamageEvent. originalAbsorption Stores the absorption value before modifications.

🛠️ Key Methods ✔️ Adding Bonuses 🛡️ getArmorReduction() ✅ Returns: The amount of damage reduction due to armor. 💡 Usage: This value is set by setArmorReduction(float value) and represents the amount of damage blocked by armor-based mechanics(e.g., vanilla armor calculations or custom armor effects from other mods). 🔮 getEnchantmentReduction() ✅ Returns: The amount of damage reduction caused by enchantments. 💡 Usage: This tracks how much defensive enchantments (such as Protection or custom enchantments) reduce the final damage. Mods can use this to balance enchantment effects or display them in tooltips. ⚠️ getSpecialReduction() ✅ Returns: The amount of direct damage reduction applied through special mechanics. 💡 Usage: This is the most powerful form of damage reduction, as it is subtracted at the very end of the damage calculation. Mods should use this carefully because it can completely negate damage if too high.

📌 First Aid Mod Compatibility System This system integrates with the First Aid mod, which modifies how damage is handled by introducing body-part-specific injuries. The following code helps track which body part was damaged when using the First Aid mod and ensures compatibility with the DamageControl system.

🛠️ Key Methods 🔍 getDamagedBodyPart(Player player)

✅ Purpose: Retrieves the body part that was damaged. Returns a EquipmentSlot var corresponding to the bodypart damaged. 💡 Usage:

This method should only be used during LivingDamageEvent and when First Aid is present.

If the player isn't mapped, it returns null.

One example of use is inside the mod Just a lot more Enchantments.