Slag Saint
README.md
Emberward
The feel of the fight. Attaches to the local player's body; BattleBoot wires
it there the moment the component exists.
What it does
| System | Behaviour |
|---|---|
| Locomotion | Gates the body's CharacterController speed by state — free, guarding, committed to a swing, rolling, hurt, dead. |
| Dodge-roll | Space. 0.62 s, invulnerable from 0.06 s to 0.40 s, carried by a decelerating curve so it has weight. Costs stamina. |
| Light attack | Left mouse. 0.16 s windup / 0.12 s active / 0.30 s recovery. |
| Heavy attack | Right mouse. 0.46 / 0.16 / 0.62 — a real commitment. |
| Guard + parry | Hold Shift to block at a stamina cost. Release it into an incoming strike inside 0.22 s and the saint rings. |
| Stamina | Everything spends it; it regenerates 0.55 s after the last spend and never while the guard is up. |
| Hit detection | Reach + arc from the Emberward's own facing to the saint's root. |
| Quench | E, only while the saint is staggered and within reach. 110 damage. |
| Lock-on | Tab. On by default. |
| Camera | Sets the live Camera's behavior to CombatCamera — from this file, so the asset literal resolves. |
Events
Raises player:attack player:roll player:guard player:parry
player:damaged player:died player:stamina hit boss:damaged shake
hitstop camera:beat. Consumes boss:strike.
Ownership
The saint's health, poise and stagger belong to the boss slice. This component
reports damage and lets that slice apply it. While no SlagSaint component
exists on boss_root it applies the numbers itself, so the fight is playable
and testable alone — and it stands that fallback down the instant the boss
slice appears, so a hit is never applied twice.
Driving it without a keyboard
Every verb is a method: :light() :heavy() :roll() :guard(down)
:quench() :toggleLock() :revive(). :status() returns the whole state
machine — state name, time in state, attack window, stamina, i-frames — which
is what a claim about the fight should be checked against.