Placeholders

With PlaceholderAPI installed, MythicHUD provides placeholders showing the state of a player's HUD.
These can be used in scoreboards, chat formats, other plugins, or even in MythicHUD itself.

General

Placeholder Value
%mythichud_version% The running plugin version.
%mythichud_build% The commit the plugin was built from.

Layouts and Pop-Ups

Placeholder Value
%mythichud_enabled% true if the player currently has their HUD enabled.
%mythichud_layouts% The player's active layout keys, comma separated.
%mythichud_popups% The player's active pop-up keys, comma separated.
%mythichud_layout_<key>% true if that layout is active for the player.
%mythichud_popup_<key>% true if that pop-up is showing for the player.

Listeners

Any Listener, default or custom, can be read with these placeholders.
Listener keys containing underscores work as well.

Placeholder Value
%mythichud_listener_<key>_value% The listener's current value.
%mythichud_listener_<key>_max% The listener's maximum.
%mythichud_listener_<key>_percent% The value as a percentage of the maximum, from 0 to 100.
%mythichud_listener_<key>_coefficient% The value as a fraction of the maximum, from 0 to 1.
%mythichud_listener_<key>_empty% true if the listener is at or below zero.
%mythichud_listener_<key>_full% true if the listener is at or above its maximum.

For example, %mythichud_listener_health_percent% shows the player's health as a percentage.

Numbers follow the decimal-format from config.yml.
A custom listener built from other placeholders reads its value from the same cache the HUD uses, so it shows its real value one placeholder update after it is first used.

Updated Oct 24, 2026