> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/pinnapass/reference/placeholders.md).

# Placeholders

With PlaceholderAPI: `%pinnapass_<token>%`. Values exist for online players (empty otherwise) and are worked out at most once a second per player.

## Pass

| Placeholder                                                                                                                |                                         |
| -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| `tier`, `max_tier`, `completed_tiers`, `next_tier`, `finished`                                                             | tiers                                   |
| `xp`, `xp_raw`, `needed`, `needed_raw`, `xp_left`, `percent`, `bar`                                                        | progress through the current tier       |
| `claimable`                                                                                                                | rewards waiting to be claimed           |
| `status`                                                                                                                   | Free / Gold / Diamond / both            |
| `has_gold`, `has_diamond`, `has_premium`, `gold_status`, `diamond_status`                                                  | premium passes                          |
| `gold_name`, `diamond_name`, `gold_cost`, `diamond_cost`, `missed_gold`, `missed_diamond`                                  |                                         |
| `multiplier`, `next_multiplier`, `multiplier_level`, `max_multiplier_level`, `multiplier_cost`, `multiplier_maxed`         | bought multiplier                       |
| `total_multiplier`, `booster`, `boost`, `boost_time`, `has_boost`, `global_boost`, `global_boost_time`, `has_global_boost` | boosts                                  |
| `infinite_level`, `has_infinite`, `infinite_ready`, `infinite_cost`, `infinite_claimable`                                  | Infinite Pass                           |
| `season`, `season_number`, `season_ends`, `season_over`, `playtime`                                                        | season                                  |
| `quests_done`, `quests_total`                                                                                              | every category                          |
| `quests_<category>_done`, `quests_<category>_total`, `quests_<category>_name`, `quests_<category>_reset`                   | one category, e.g. `quests_daily_reset` |
| `currency`                                                                                                                 | the purchase currency's name            |

## One quest

`%pinnapass_quest_<category>_<n>_<field>%`, `n` counted from 1, fields `name`, `description`, `progress`, `goal`, `percent`, `bar`, `expires`, `state` (in-progress / completed / expired), `id`.

Example: `%pinnapass_quest_daily_1_name%: %pinnapass_quest_daily_1_progress%/%pinnapass_quest_daily_1_goal%`.

Every placeholder is also a `{token}` in menus (without `pinnapass_`).