> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Placeholders

> List of available placeholders for RPG Core.

# RPG Core Placeholders

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

## Global Placeholders

| Placeholder                        | Description                                                             |
| :--------------------------------- | :---------------------------------------------------------------------- |
| `%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`).

| Placeholder                                           | Description                                  |
| :---------------------------------------------------- | :------------------------------------------- |
| `%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`).

| Placeholder                  | Description                       |
| :--------------------------- | :-------------------------------- |
| `%typewriter_stat_<id>%`     | Current value of the player stat. |
| `%typewriter_stat_<id>_max%` | Maximum value of the player stat. |

## Item Placeholders

| Placeholder                              | Description                                                         |
| :--------------------------------------- | :------------------------------------------------------------------ |
| `%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

| Placeholder                                                           | Description                                                  |
| :-------------------------------------------------------------------- | :----------------------------------------------------------- |
| `%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.                  |