Health — Editor Tools¶
Editor inspectors and debugging utilities for the Health System.
Overview¶
These tools support authoring, inspection, and play-mode QA for Health system components such as health state, authority, rules, shields, regeneration, invincibility, and combat-related behaviour.
They are intended to help developers: - configure Health components more clearly - inspect live runtime state during Play Mode - verify rule and shield setup - run quick Health QA flows without writing temporary test code
Contents¶
| Type | Description |
|---|---|
| Windows | HealthDebuggerWindow — runtime-focused debugger for live state, previews, rules, shields, events, and saved damage cases.RuleOrderInspector — advanced read-only rule ordering window for inspecting sorted PRE-rule stacks and priority ties. |
| Inspectors | Custom editors for: • HealthSystem• HealthAuthorityBinder• DamageRuleHub• HealRuleHub• ShieldChain |
Menu Paths¶
Windows¶
-
Window / RevFramework / Health / Debugger
Opens the full Health debugger window for live runtime inspection and testing. -
Window / RevFramework / Health / Debug / Rule Order
Opens the advanced rule-order inspection window forDamageRuleHubandHealRuleHub.
Included Editors¶
HealthSystemEditor¶
Custom inspector for the main HealthSystem component.
It provides: - grouped authoring sections for core setup and behaviour - defaults asset assignment - optional shield provider assignment - authority guidance and best-effort authority diagnostics - live shield summaries - UnityEvent inspection - last damage report display - read-only runtime state display - quick add-on helpers for common Health-adjacent components - play-mode QA actions for common Health flows
HealthAuthorityBinderEditor¶
Custom inspector for the built-in local authority binder.
It explains:
- what the binder is for
- when it is used
- how it interacts with HealthSystem.RequireAuthority
- why multiplayer projects typically replace it with a custom authority implementation
DamageRuleHubEditor / HealRuleHubEditor¶
Custom inspectors that:
- list discovered rules implementing IDamageRule / IHealRule
- sort them by priority
- make effective runtime rule order easier to inspect at a glance
ShieldChainEditor¶
Custom inspector for ShieldChain.
It: - displays the current shield composition on the GameObject - exposes Up / Down controls for changing component order - makes runtime shield execution order easier to inspect and adjust
Windows¶
HealthDebuggerWindow¶
Runtime-focused debugger for a selected Health target.
It includes tabs for: - Live — current health state, runtime actions, combat, invincibility, and last damage report - Preview — damage/heal previews and direct apply actions - Rules — damage/heal PRE-rule summaries and post-observer summaries - Shields — live shield summaries and preview-capable shield info - Events — event and damage-attempt logging with filtering - Cases — saved reusable damage test cases
This window is intended for play-mode debugging and QA, not normal serialized authoring.
RuleOrderInspector¶
Advanced read-only inspection window for Health rule ordering.
It helps with: - checking sorted PRE-rule order - spotting priority ties - verifying built-in ordering expectations
This is mainly useful for: - debugging unexpected Health behaviour - validating custom rule stacks - extension and integration work
Notes¶
- All editor scripts are wrapped in:
#if UNITY_EDITOR && REV_HEALTH_PRESENT - These tools are editor-only and do not ship into player builds.
- The debugger and advanced inspection tools are intended to complement, not replace, the normal component inspectors.
TL;DR¶
You’ve got: - a full Health debugger window - an advanced rule-order inspection window - focused custom inspectors for core Health components - play-mode QA support - no runtime build overhead