BattleUnitWorldBar

World-space unit chrome — segmented HP, AP pips, ally/enemy tint, optional predamage threat, tooltip identity.

Package

SusGame · HUD (commercial)

Open in Playground

SusGame · HUD

Props

Name	Type	Default
UnitName	Prop<string>	""	v-model
Rank	Prop<string>	""	v-model
Description	Prop<string>	""	v-model
PositionLabel	Prop<string>	""	v-model
TipExtra	Prop<string>	""	v-model
CurrentHp	Prop<int>	10	v-model
MaxHp	Prop<int>	10	v-model
CurrentAp	Prop<int>	2	v-model
MaxAp	Prop<int>	2	v-model
PredamageMin	Prop<int>	0	v-model
PredamageAccuracy	Prop<int>	0	v-model
Predamage	Prop<bool>	false	v-model
Ally	Prop<bool>	true	v-model
BarActive	Prop<bool>	true	v-model
EntityId	Prop<int>	-1	v-model
DisplayName	Prop<string>	""
HpText	Prop<string>	"0"

Slots

No slots.

Events

No public events.

Style hooks

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

• battle-unit-world-bar
• battle-unit-world-bar__ap-pip
• battle-unit-world-bar__ap-pip--active
• battle-unit-world-bar__ap-pip--hidden
• battle-unit-world-bar__ap-pip--spent
• battle-unit-world-bar__ap-row
• battle-unit-world-bar__ap-spacer
• battle-unit-world-bar__content
• battle-unit-world-bar__counter
• battle-unit-world-bar__counter-label
• battle-unit-world-bar__hp-row
• battle-unit-world-bar__hp-seg
• battle-unit-world-bar__hp-seg--empty
• battle-unit-world-bar__hp-seg--filled
• battle-unit-world-bar__hp-seg--hidden
• battle-unit-world-bar__hp-seg--spent
• battle-unit-world-bar__hp-seg--threat
• battle-unit-world-bar__hp-seg-fill
• battle-unit-world-bar__main
• battle-unit-world-bar__name
• battle-unit-world-bar__row
• battle-unit-world-bar__statuses
• battle-unit-world-bar__statuses--hidden
• battle-unit-world-bar__tip
• battle-unit-world-bar--ally
• battle-unit-world-bar--enemy
• battle-unit-world-bar--inactive
• battle-unit-world-bar--predamage
• sus-icon
• sus-status-effect
• sus-status-effect__icon

Usage

var bar = new BattleUnitWorldBar();
bar.UnitName.Value = "Ranger";
bar.Rank.Value = "Sgt";
bar.Ally.Value = true;
bar.CurrentHp.Value = 7;
bar.MaxHp.Value = 10;
bar.CurrentAp.Value = 2;
bar.MaxAp.Value = 3;
bar.BarActive.Value = true;
bar.Init(wounds: 10, actionPoints: 3);
bar.ShowPredamage(minDamage: 2, accuracy: 75);

<template>
  <sus:BattleUnitWorldBar :UnitName="Name.Value"
                          :Rank="Rank.Value"
                          :Description="Desc.Value"
                          :PositionLabel="Pos.Value"
                          :CurrentHp="Hp.Value"
                          :MaxHp="HpMax.Value"
                          :CurrentAp="Ap.Value"
                          :MaxAp="ApMax.Value"
                          :Ally="Ally.Value"
                          :BarActive="Active.Value"
                          :Predamage="Threat.Value"
                          :PredamageMin="ThreatMin.Value"
                          :PredamageAccuracy="ThreatAcc.Value"
                          :EntityId="Entity.Value" />
</template>

<script>
public Prop<string> Name = new("Ranger");
public Prop<string> Rank = new("Sgt");
public Prop<string> Desc = new("Scout · medium armor");
public Prop<string> Pos = new("A3");
public Prop<int> Hp = new(7);
public Prop<int> HpMax = new(10);
public Prop<int> Ap = new(2);
public Prop<int> ApMax = new(3);
public Prop<bool> Ally = new(true);
public Prop<bool> Active = new(true);
public Prop<bool> Threat = new(false);
public Prop<int> ThreatMin = new(0);
public Prop<int> ThreatAcc = new(0);
public Prop<int> Entity = new(-1);
</script>

Prop / API	Role
UnitName · Rank · Description	Identity / tooltip
PositionLabel · TipExtra	Extra tooltip lines
CurrentHp / MaxHp	Wound segments (1:1)
CurrentAp / MaxAp	AP pips (≤8)
Ally	Ally vs enemy chrome
BarActive	Inactive / dimmed
Predamage*	Threat overlay on HP
EntityId	Host / ECS bridge id
Init / ResolveDamage / SpendAction	Combat helpers
ShowPredamage / ResetHealthVisual	Threat + visual reset

Notes

• DisplayName and HpText are derived — bind the source props above, not those two.
• One HP segment per wound point (not a padded 10-seg strip when MaxHp differs).
• Prefer kit SusHealthBar / SusUnitNameplate for simpler world labels; this bar is the tactical segmented variant.