Wikis / MythicRPG / Placeholders

Placeholders

All placeholders provided by MythicRPG.

MythicMobs Placeholders

These can be used inside any Mythic skill, condition, mechanic, or menu lore via <...> syntax (with the appropriate scope prefix — typically caster., target., or trigger.).

Archetypes

Placeholder Returns
<caster.archetype.<group>> Caster's archetype id in the given group. Returns NONE if no archetype is held.
<caster.archetype.level.<group>> Caster's archetype level in the given group.
<caster.archetype.exp.<group>> Caster's current experience in the given group.
<caster.archetype.exp.goal.<group>> Caster's experience needed to reach the next level in the given group.
<caster.archetype.display.<group>> Caster's archetype display name in the given group. Accepts <group>|<fallback>; the fallback is returned when no archetype is held.
<caster.archetype.byid.display.<id>> Display name of the archetype with the given id (not tied to any player). Accepts <id>|<fallback>; the fallback is returned when the id is blank or unknown.

Points

Placeholder Returns
<caster.points.available.<type>> Available (unspent) points of the given type.
<caster.points.earned.<type>> Total points the caster has ever earned of the given type.
<caster.points.spent.<type>> Total points the caster has spent of the given type.
<caster.points.archetype.<type>.<key>> Points the caster has invested in the talent tree named by <key> (a talent tree id, or an archetype id whose tree is used), counted for point type <type>. Returns 0 if the tree's own point type differs from <type>. Aliases: tree, talenttree.
<caster.points.archetypeearned.<type>.<archetype>> Points the caster has earned via the given archetype, for point type <type>. Alias: earnedarchetype.

Reagents

Placeholder Returns
<caster.reagent.<name>> Current amount of the named reagent, rounded to the nearest whole number.
<caster.reagent.max.<name>> The named reagent's max value for the scoped player, rounded to the nearest whole number. Follows a stat. max.

The reagent name is case-insensitive. Both return 0 for an unknown reagent, and for entities that are not players or have no active profile.

Spells

Placeholder Returns
<caster.spell.level> Level of the spell currently being cast (only meaningful inside spell skill execution).
<caster.spell.level{class=<spellId>}> Caster's level in a specific learned spell.
<caster.spell.levels> List form of spell.level for spells with stacked sources.
<caster.spell.mod{m=<key>}> The current spell's modifier value at the caster's spell level.
<caster.spell.mod{m=<key>;c=<spellId>}> A specific learned spell's modifier value, evaluated at that spell's level.

Aliases for spell.mod: spell.modifier, modifier. Argument aliases: m/mod/modifier for the modifier key, c/class for the spell id.

Talents

These only resolve when used inside a talent skill context (e.g. inside the Configuration.Talents.OnInvest / OnDivest hooks documented on Talents).

Placeholder Returns
<caster.talent.invested_points> Points the caster has currently invested in the talent in scope.
<caster.talent.max_points> The talent's MaxPoints value.
<caster.talent.pointed_needed> Points the caster still needs to invest in the tree before the talent unlocks.
<caster.talent.mod{m=<key>}> The scoped talent's modifier value, evaluated at the caster's invested rank. Returns the default (0, or the value after | in the key) when the talent, modifier key, or rank is missing.

Aliases for talent.mod: talent.modifier. Argument aliases: m/mod/modifier for the modifier key.

Cast State

These resolve against the target entity's current cast-time cast. If the target isn't casting, defaults are returned (false / 0 / empty string, depending on the metric).

Placeholder Returns
<caster.cast.active> true while the entity is casting; false otherwise.
<caster.cast.spell> Internal id of the spell being cast.
<caster.cast.display> Display name of the spell being cast.
<caster.cast.remaining> Remaining cast time in seconds (e.g. 1.34).
<caster.cast.total> Total cast time in seconds.
<caster.cast.progress> Cast progress as a 0.00–1.00 value.
<caster.cast.interruptible> true if the active cast is interruptible.

<target.cast.*> and <trigger.cast.*> work the same way against their respective scopes.

Party / Friends

These resolve against the scoped player's friend list and party. isfriend is relational: it compares the scoped entity against the skill's caster, so it is normally used with a target. or trigger. scope.

Placeholder Returns
<caster.friends.online> Number of the scoped player's friends who are currently online.
<caster.friends.total> Total number of friends the scoped player has.
<caster.friends.names> Comma-separated names of the scoped player's friends.
<target.isfriend> 1 if the scoped entity is a friend of the caster, otherwise 0.
<caster.party.leader> Name of the scoped player's party leader (empty if not in a party).
<caster.party.size> Number of members in the scoped player's party (0 if not in a party).
<caster.party.members> Comma-separated names of the scoped player's party members.
<caster.party.isleader> 1 if the scoped player leads their party, otherwise 0.

PlaceholderAPI Integration

These work in any plugin that resolves PAPI placeholders.

Archetypes

Placeholder Returns
%mythic_archetype_<group>% Player's archetype id in the given group. Returns NONE if none held.
%mythic_archetype_display_<group>% Player's archetype display name in the given group.
%mythic_archetype_byid_display_<id>% Display name of the archetype with the given id (not tied to any player). Empty if the id is unknown.
%mythic_archetype_level_<group>% Player's archetype level in the given group.
%mythic_archetype_exp_<group>% Player's current archetype experience in the given group.
%mythic_archetype_exp_goal_<group>% Experience needed for the next level.
%mythic_archetype_exp_last_<group>% Amount of XP gained from the most recent grant in this group.

Experience Sources

Placeholder Returns
%mythic_expsource_last_<group>% Amount of XP gained from the most recent grant via the named source group.

Points

Placeholder Returns
%mythic_point_available_<type>% Available (unspent) points of the given type.
%mythic_point_earned_<type>% Total points ever earned of the given type.
%mythic_point_spent_<type>% Total points spent of the given type.
%mythic_point_archetype_<type>_<archetype>% Points earned via a specific archetype.
%mythic_point_display_<type>% The configured display name of the point type.

Reagents

Placeholder Returns
%mythic_reagent_<name>% Current value of the named reagent. Returns [Invalid_Resource] if it doesn't exist.
%mythic_reagent_max_<name>% Max value of the named reagent.

Spell Bindings

Placeholder Returns
%mythic_binding_id_<slot>% The spell id bound to the given hotbar slot.
%mythic_binding_name_<slot>% The display name of the spell bound to the slot.
%mythic_binding_cooldown_current_<slot>% Current remaining cooldown of the bound spell.
%mythic_binding_cooldown_max_<slot>% Max cooldown of the bound spell.
%mythic_binding_cost_<reagent>_<slot>% Reagent cost of the bound spell for the given reagent type.
%mythic_binding_key_<slot>% The button to press if quickcasting in hotbar mode.

Spells

Like the binding placeholders, but looked up by spell id instead of by slot, so they work whether or not the spell is bound.

Placeholder Returns
%mythic_spell_cooldown_current_<spell>% Remaining cooldown of the spell for the player, in whole seconds (0 when ready).
%mythic_spell_cooldown_max_<spell>% The spell's Cooldown, in whole seconds (0 if the spell has no cooldown).
%mythic_spell_cost_<reagent>_<spell>% The spell's cost in the given reagent (0 if the spell does not use that reagent).

<spell> is the spell's internal id and may contain underscores, e.g. %mythic_spell_cost_mana_WARRIOR_HEROIC_STRIKE%. Cooldown and cost are evaluated the same way as when the player casts the spell, so values that use spell modifiers follow the player's spell level. An unknown spell id returns [Invalid Spell].

Casting State

Placeholder Returns
%mythic_is_casting% true while quickcasting is active for the player, otherwise false.
%mythic_is_spell_casting% true while a cast-time cast is in progress, else false.
%mythic_casting_spell% Internal id of the spell currently being cast (empty if none).
%mythic_casting_spell_display% Display name of the spell currently being cast.
%mythic_cast_progress% Cast progress as a 0.00–1.00 value (0 if not casting).
%mythic_cast_time_remaining% Remaining cast time in seconds (0 if not casting).
%mythic_cast_time_total% Total cast time in seconds (0 if not casting).
%mythic_cast_interruptible% true if the active cast is interruptible (false if not casting).

Waystones

See the Waystones page for the full system.

Placeholder Returns
%mythic_waystone_discovered_<id>% true if the player has discovered the waystone with the given id, otherwise false.
%mythic_waystone_state_<id>% The player's current state for the waystone: UNDISCOVERED, DISCOVERED, or ACTIVE.
%mythic_waystone_name_<id>% The waystone's DisplayName (with formatting). Empty string if the id doesn't exist.
%mythic_waystone_distance_<id>% Distance in blocks from the player to the waystone, to one decimal place. Returns -1 if the player and waystone are in different worlds.
%mythic_waystone_discovered_count% Number of waystones the player has discovered.
%mythic_waystone_respawn% The id of the player's currently-bound respawn waystone, or empty if none.
%mythic_waystone_nearest% Id of the nearest discovered waystone in the player's world, or empty if none. Append _all to include undiscovered waystones too (%mythic_waystone_nearest_all%).
Updated Nov 2, 2026