SusHudUnitRail

Top unit strip — allies left, enemies right; reconciles SusHudUnitCard children by id.

Package

SusGame · HUD (commercial)

SusGame · HUD

Props

Name	Type	Default
`ShowEnemies`	`Prop<bool>`	`true`
`Orientation`	`Prop<string>`	`"row"`

Slots

No slots.

Events

Name	Field	Payload
`UnitSelected`	`OnUnitSelected`	`SusHudUnitCard`

Style hooks

USS class contract — override appearance without touching C#. States toggle via these classes:

breakpoint-sm
sus-hud-unit-card
sus-hud-unit-card__portrait
sus-hud-unit-card--active
sus-hud-unit-rail
sus-hud-unit-rail__scroll
sus-hud-unit-rail__side
sus-hud-unit-rail__side--allies
sus-hud-unit-rail__side--enemies
sus-hud-unit-rail__spacer
sus-hud-unit-rail__spacer--empty
sus-hud-unit-rail--allies-only
sus-hud-unit-rail--belt-tight
sus-hud-unit-rail--column
sus-hud-unit-rail--tight

Usage

List-driven: SetUnits / SetAllies / SetEnemies. XML only toggles enemy side.

csharp

var rail = new SusHudUnitRail();
rail.ShowEnemies.Value = true;
rail.OnUnitSelected += card => { /* select */ };

rail.SetUnits(new List<SusHudUnitCardData>
{
    new() { Id = "a1", Name = "Mara", Ally = true, Active = true, ImageSrc = "portraits/mara" },
    new() { Id = "e1", Name = "Raider", Ally = false, Icon = "units/raider" },
});

rail.SetActiveUnit("a1");
rail.UpdateUnit(new SusHudUnitCardData { Id = "a1", Name = "Mara", Hp = 30f, MaxHp = 50f, Ally = true });
rail.SetUnitEffects("a1", new List<SusStatusEffectData>
{
    new() { Id = "burn", Icon = "flame", IsDebuff = true, TurnsLeft = 2 },
});

xml

<template>
  <sus:SusHudUnitRail :ShowEnemies="ShowEnemies.Value"
                      @unit-selected="OnUnitSelected" />
</template>

<script>
public Prop<bool> ShowEnemies = new(true);
void OnUnitSelected(SusHudUnitCard card) { /* … */ }
// Call SetUnits / SetAllies / SetEnemies after mount.
</script>

Prop / API	Role
`ShowEnemies`	Hide enemy side + spacer (deployment / allies-only)
`SetUnits(list)`	Split by `Ally` → both sides
`SetAllies` / `SetEnemies`	Partial side updates
`SetActiveUnit(id)`	Toggle `Active` on matching cards
`UpdateUnit(data)`	Patch one existing card
`SetUnitEffects(id, effects)`	Forward to card
`FindCard` / `ClearUnits`	Lookup / wipe
`AllyCards` · `EnemyCards`	Live card lists
`OnUnitSelected`	Bubbled from child `OnSelected`

Notes

Empty until fill API — in-place reconcile avoids remount storms on SusImg / icons.
SetUnits forces Ally true/false per side when reconciling.
Pair with SusHudUnitCard docs for payload fields.

SusHudUnitRail ​