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.

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.

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 Aug 19, 2026