Placeholders

Requires PlaceholderAPI. Identifier: shs.

Use on scoreboards, tab, chat plugins, and in weight.yml scaling placeholders.

All placeholders (27)

Placeholder	Returns	Example
%shs_stamina%	Current stamina (integer)	78
%shs_stamina_max%	Max stamina (integer)	100
%shs_stamina_percent%	Stamina 0-100 (integer)	78
%shs_stamina_bar%	Text bar from ui.bar settings	████████░░
%shs_weight%	Total inventory weight (1 decimal)	42.5
%shs_penalty_weight%	Carry burden after pack-animal relief (1 decimal)	34.0
%shs_encumbered%	NONE, NORMAL, or SEVERE (uses penalty weight)	NORMAL
%shs_overexertion%	Overexertion accumulation (1 decimal)	8.3
%shs_overexerted%	Actively overexerting	true / false
%shs_stat_drained%	Session total drained (1 decimal)	254.3
%shs_stat_regened%	Session total regened (1 decimal)	180.7
%shs_stat_second_winds%	Session second wind count	2
%shs_stat_overexertions%	Session overexertion events	1
%shs_stat_time_at_zero%	Session seconds at 0 stamina (1 decimal)	12.5
%shs_well_fed%	Well Fed buff seconds left (0 if off)	25
%shs_well_rested%	Well Rested buff seconds left (0 if off)	90
%shs_dodge_cooldown%	Dodge cooldown seconds left (0 if ready)	1.2
%shs_sprint_burst_cooldown%	Sprint burst cooldown seconds left (0 if ready)	22.5
%shs_biome%	Biome category: COLD, HOT, or NEUTRAL	COLD
%shs_winded%	Player is winded	true / false
%shs_display%	Display preference: actionbar, bossbar, off, or default	bossbar
%shs_carry_burden%	Load burden after stat relief (2 decimals, 0 = light)	0.40
%shs_scaling_drain_mult%	Action drain multiplier from scaling-drain (2 decimals)	1.12
%shs_weather%	CLEAR, RAIN, or THUNDER	RAIN
%shs_weather_drain_mult%	Weather sprint drain multiplier (2 decimals)	1.05
%shs_pack_animals%	Nearby qualifying pack animals	1
%shs_pack_relief%	Burden relief 0–1 (2 decimals)	0.20

Notes

%shs_stamina_bar% uses config.yml → ui.bar.length, filled-char, empty-char. Same settings as %stamina_bar% in messages.yml.

%shs_weight% vs %shs_penalty_weight%: %shs_weight% is raw inventory sum. Pack animals lower penalty weight used for encumbrance tiers, fall damage scaling, %shs_encumbered%, %shs_carry_burden%, and %shs_scaling_drain_mult%. Check %shs_pack_relief% for the active relief fraction. Weight/burden placeholders refresh the pack-animal scan on read so scoreboards stay in sync without waiting for the next engine tick.

%shs_carry_burden% and %shs_scaling_drain_mult% only matter when scaling-drain.enabled: true. Both use penalty weight (after pack relief). Burden 0 means the player's stat fully covers the load; 1.0+ means at or over effective carry cap after stat relief.

%shs_weather_drain_mult% is 1.00 when weather is off or the sky is clear.

%shs_display% is default until the player picks a HUD. Preference persists in playerdata/<uuid>.yml.

Session stats reset on disconnect. They are not persisted.

HUD format tokens (messages.yml → ui.format)

These are MiniMessage placeholders for the stamina ActionBar / BossBar / Chat line (not PlaceholderAPI):

Token	Meaning
%well_fed% / %well_rested%	Seconds left on that buff (0 if inactive)
%well_fed_chip% / %well_rested_chip%	Short colored chip text, or empty when inactive

While a buff chip is active, the HUD stays visible even at full stamina so the timer remains readable.

Example layouts

Stamina: %shs_stamina%/%shs_stamina_max%

%shs_stamina_bar% %shs_stamina_percent%%

Weight: %shs_weight% burden %shs_penalty_weight% [%shs_encumbered%] pack %shs_pack_animals% relief %shs_pack_relief%

Weather %shs_weather% x%shs_weather_drain_mult%