Skip to main content

RPG Core Placeholders

The RPG Core extension provides extensive PlaceholderAPI support for professions, stats, and items.

Global Placeholders

PlaceholderDescription
%typewriter_player_level%Player’s class level (based on Health or configured stat).
%typewriter_profession_xp%Total experience across all professions.
%typewriter_party_size%Number of players in the party.
%typewriter_guild_size%Number of players in the guild.
%typewriter_xp_share_mode%Current XP share mode (party, guild, party+guild, or disabled).
%typewriter_xp_share_multiplier%Current XP share multiplier.

Profession Placeholders

Replace <id> with the profession ID (e.g., mining, woodcutting).
PlaceholderDescription
%typewriter_profession_<id>_level%Current level of the profession.
%typewriter_profession_<id>_xp%Current XP in the current level.
%typewriter_profession_<id>_total_xp%Total accumulated XP.
%typewriter_profession_<id>_xp_to_next%XP remaining until the next level.
%typewriter_profession_<id>_total_xp_required%Total XP required for the next level.
%typewriter_profession_<id>_xp_progress_percentage%Progress percentage towards the next level.
%typewriter_profession_<id>_max_level%Maximum achievable level for the profession.

Stat Placeholders

Replace <id> with the stat ID (e.g., strength, defense).
PlaceholderDescription
%typewriter_stat_<id>%Current value of the player stat.
%typewriter_stat_<id>_max%Maximum value of the player stat.

Item Placeholders

PlaceholderDescription
%typewriter_item_count_<material>%Count of items in inventory by Vanilla Material.
%typewriter_item_count_id_<custom_id>%Count of specific custom items in inventory.
%typewriter_has_item_<custom_id>%true/false if player holds the custom item in main or off hand.

Activity & Boost Placeholders

PlaceholderDescription
%typewriter_profession_activity_points_<prof>_<activity>%Points earned for a specific activity (e.g. mining_break).
%typewriter_profession_activity_events_<prof>_<activity>%Number of events for a specific activity.
%typewriter_profession_activity_multiplier_<prof>_<activity>_xp%XP multiplier for an activity.
%typewriter_profession_activity_multiplier_<prof>_<activity>_score%Score multiplier for an activity.
%typewriter_profession_boost_<prof>_percent%Total active boost percentage for a profession.
%typewriter_profession_boost_<prof>_remaining%Time remaining on the longest active boost.