RPG Core registers the MiniPlaceholders expansion btc. Use the values as MiniMessage tags in any text that supports placeholders. Arguments follow the tag name after a colon, for example <btc_stat:health>. An unknown profession or stat returns 0 (or an empty text where noted).
Player and global level
| Placeholder | Returns |
|---|
<btc_player_level> | The player's class level. |
<btc_global_level> | The player's global level. |
<btc_party_size> / <btc_guild_size> | Size of the player's party or guild. |
<btc_party_in_party> / <btc_guild_in_guild> | true when the size is greater than 1. |
<btc_party_leader>, <btc_guild_name>, <btc_guild_leader> | Always empty in this version. |
<btc_xp_share_mode> / <btc_xp_share_multiplier> | The XP sharing mode and multiplier. |
Professions
Replace profession with a profession id such as mining.
| Placeholder | Returns |
|---|
<btc_profession_xp> | Total XP across all professions. |
<btc_profession_xp:profession> | XP of that profession. |
<btc_profession_level:profession> | Current level. |
<btc_profession_total_xp:profession> | Total accumulated XP. |
<btc_profession_xp_to_next:profession> | XP missing for the next level. |
<btc_profession_total_xp_required:profession> | Total XP needed to reach the next level. |
<btc_profession_xp_progress_percentage:profession> | Progress towards the next level, 0 to 100. |
<btc_profession_max_level:profession> | Maximum level. |
<btc_profession_is_maxed:profession> | true or false. |
<btc_profession_name:profession> | Display name (the id itself if unknown). |
For menus that list every level, these take the profession and a level (<btc_profession_level_lore:mining:37>). The level is not capped at the maximum.
| Placeholder | Returns |
|---|
<btc_profession_level_requirement:profession:level> | Total XP needed to reach that level. |
<btc_profession_level_lore:profession:level> | The reward description written for that level, lines joined by newlines. |
<btc_profession_level_stats:profession:level> | Permanent stats gained at that level, for example STRENGTH +2, HEALTH +5. |
<btc_profession_level_reward_count:profession:level> | Number of triggers run at that level. |
<btc_profession_level_palette:profession:level> | A colour name (GREEN_LIGHT reached, GOLD current, INK locked). |
<btc_profession_level_status:profession:level> | ATTEINT, EN COURS or VERROUILLE. |
Boosts and activities
| Placeholder | Returns |
|---|
<btc_profession_boost_percent:profession> | Total active boost percentage. |
<btc_profession_boost_remaining:profession> | Time left on the active boost. |
<btc_profession_activity_points:profession:activity> | Competition points for an activity. |
<btc_profession_activity_events:profession:activity> | Number of events for an activity. |
<btc_profession_activity_multiplier:profession:activity:xp> | XP multiplier (use score for the score multiplier). |
Stats
Replace stat with a stat id such as health or crit_chance.
| Placeholder | Returns |
|---|
<btc_stat:stat> | The stat total value (base plus equipment, constrained) inserted into the stat's displayFormat; the raw internal value is used, not the percentage display value. |
<btc_stat_max:stat> | Its maxValue, or unbounded. |
<btc_stat_percent:stat> | Value as a percentage of maxValue (0 when there is no maximum). |
<btc_stat_missing:stat> | Distance to maxValue. |
Inventory
| Placeholder | Returns |
|---|
<btc_item_count:STONE> | Number of items of a vanilla material in the inventory. |
<btc_item_count_id:id> | Number of items with that BTC custom item id. |
<btc_has_item:id> | true if the main hand or off hand holds that custom item. |
<btc_inventory_free_slots> | Free storage slots. |
<btc_main_hand_item_name> | Material name of the held item, empty if none. |