❤️ Health Management

A new MonoBehaviour component adds health management to any entity. Entities can take damage, heal, die, and resurrect.

Set maximum health, track current health, and configure death thresholds. Everything integrates with the core framework's stats and attributes.

🗡️ Damage Types & Sources

Damage types represent categories of damage in your game—Physical, Magic, Fire, Poison, etc. Define your own types as ScriptableObjects.

Optionally link each damage type to a defensive statistic. For example, "Physical Damage" reduced by "Armor", or "Magic Damage" reduced by "Magic Resistance". True damage can be implemented as a damage type with no associated defensive stat.

Assign piercing statistics to ignore portions of defense. "Armor Pierce" could reduce the effectiveness of "Armor" when calculating net damage.

Damage sources represent the origin of damage—Skill, Trap, Environmental, etc. They can be used for advanced damage handling scenarios (e.g. damage source based damage reduction), or for tracking damage in combat logs (e.g. player took 350 damage from traps, 2400 damage from enemies, and 0 damage form environment). Also these are defined as ScriptableObjects, allowing flexible categorization to tailor damage handling to your needs.

🛡️ Damage Reduction Functions

Model how defensive stats reduce incoming damage using mathematical functions. The package includes three common functions:

• Flat reduction: Each point of defense reduces damage by a fixed amount. Predictable and easy to balance.
• Percentage reduction: Defense directly expresses damage reduction percentage. Effective across varying damage ranges.
• Logarithmic reduction: Diminishing returns as defense increases. Prevents complete damage negation.

Implement custom reduction functions if the defaults don't fit your needs.

🛡️ Defense Reduction Functions

Piercing stats use reduction functions too, determining how they bypass defense.

The same flat, percentage, and logarithmic functions are available out of the box.

⚙️ Damage Calculation Pipeline

The damage calculation pipeline transforms raw damage into net damage through customizable steps. Configure the order of operations to match your game's mechanics.

Pre-defined steps include:

• Defense mitigation: Apply defensive stats and piercing calculations
• Damage modifiers: Apply percentage-based buffs/debuffs for weaknesses, resistances, immunities
• Barrier absorption: Temporary hit points absorb damage before actual HP
• Critical multiplier: Multiply damage for critical hits

Set a default pipeline for all entities, or assign custom pipelines to specific entities. Override pipelines at runtime for temporary effects or boss mechanics.

For example, add a damage limiter step to boss entities to cap incoming damage at 10% of max HP. Or implement a debuff that doubles electric damage by swapping in a custom pipeline with an extra electric damage multiplier step.

This flexibility makes implementing complex damage mechanics straightforward.

🩹 Heal Sources

Heal sources identify where healing comes from—Potion, Skill, Regeneration, Lifesteal, Ally, Self, etc.

Use heal sources to implement mechanics like bonus healing from specific sources or reduced healing from enemies.

🧛 Lifesteal

Lifesteal converts dealt damage into health for the attacker. The system is highly configurable.

Link lifesteal stats to specific damage types and choose which pipeline step it applies to—raw damage, net damage, pre-mitigation, post-mitigation, before barrier, after barrier, etc.

You can fine-tune lifesteal application timing to fit your game's design.

💀 Death

Entities die when health reaches zero, or at a custom death threshold. Negative thresholds enable "down but not out" mechanics.

Death strategies define what happens on death. Set a default strategy and override for specific entities.

Pre-defined death strategies:

• Disable Game Object: Disables the entity for later resurrection
• Destroy Game Object: Removes the entity permanently
• No-op Strategy: Does nothing on death
• Multiple Death Strategies: Chain strategies together

Use death strategies to integrate with your architecture—return to object pools, trigger events, play animations, drop loot, etc.

😇 Resurrection

Bring dead entities back to life through the API. Restore health as a flat value or percentage of maximum health.

Resurrection strategies define behavior when resurrecting. Out of the box:

• Enable Game Object: Re-enables disabled entities
• No-op Strategy: Does nothing on resurrection
• Multiple Resurrection Strategies: Execute multiple strategies in sequence

📈 Health Scaling Component

Extend scaling formulas to use health values. Scale based on maximum health, current health, or missing health.

Build abilities that grow stronger as health decreases. Create healing that scales with max HP. Design berserker mechanics that reward risk. And more.

⚡ Health Game Events

New game events for health-related actions:

• Damage taken
• Healing received and applied
• Death and resurrection
• And many more...

Wire these events to your game logic for abilities, UI updates, sound effects, particles, etc.