Note

Join the Astra RPG Discord server!
There is now a dedicated Discord server for Astra RPG Framework and its extensions. Join to receive notifications about new extension releases and important updates, to ask for new features, report bugs, share ideas, and showcase your Astra creations with other developers.
💬 Join the Discord Server: https://discord.gg/nJVRMkGrZg

💚 Astra RPG Health

👉 Introduction

A complete health and damage system built on Astra RPG Framework's data-driven foundation.

Astra RPG Health adds robust health management to your entities. Handle damage, healing, death, and resurrection with a flexible pipeline that adapts to your game's mechanics.

Simple to set up, powerful in action. Customize damage types, reduction formulas, and calculation pipelines without touching code.

✨ Key Features

  • ❤️ Health Management: Complete system for HP, damage, healing, death, and resurrection
  • 🗡️ Damage Types & Sources: Define custom damage types with defensive stats and armor penetration. Define Damage Sources for damage tracking, or advanced game mechanics
  • 🛡️ Damage Reduction: Multiple reduction functions—flat, percentage, logarithmic, or custom
  • ⚙️ Damage Pipeline: Fully customizable calculation pipeline with reorderable steps
  • 🩹 Healing System: Heal sources and mechanics that integrate seamlessly with your game
  • 🧛 Lifesteal: Configurable lifesteal that works with any damage type
  • 💀 Death & Resurrection: Flexible strategies for death behavior and bringing entities back
  • 📈 Health Scaling: New scaling component for formulas based on current, max, or missing HP
  • ⚡ Health Events: Extended game events for damage, healing, death, and resurrection

⚙️ Implemented on top of ScriptableObjects architecture

  • 🎨 Inspector-driven: Configure damage types, sources, and strategies directly in the Unity Inspector
  • 🧩 Modular and reusable: Share damage calculation strategies across entities or customize per-entity
  • 🧪 Test in play mode: Tweak damage formulas, reduction functions, and pipeline steps without recompiling and without restarting play mode

🔍 Features Breakdown

❤️ 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

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

🛒 Where to Buy

Unity Asset Store: Astra RPG Health (coming soon)

📬 Information & Contact

Questions, feedback, or bugs? Email us at electricdrill.info@gmail.com.

Unity Forum: Astra RPG Health Discussion (coming soon)

Discord: Astra RPG Discord Server