> 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/edperks/essential/placeholders.md).

# Placeholders

EdPerks registers the PlaceholderAPI expansion `edperks`. [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) must be installed for any of these to resolve.

***

### Ticket & Roll Placeholders

These work for any player (online or offline, from cached data).

#### %edperks\_tickets%

The player's current Perk Ticket balance.

#### %edperks\_total\_rolls%

The player's lifetime number of rolls.

#### %edperks\_rolls\_until\_pity%

How many rolls the player has accumulated toward their pity (the rolls-since-pity counter).

#### %edperks\_pity\_max%

The pity threshold — the value of `pity.rolls` in `config.yml`.

{% hint style="info" %}
To show pity progress like `137/500`, combine `%edperks_rolls_until_pity%` and `%edperks_pity_max%`.
{% endhint %}

***

### Held-Tool Perk Placeholders

These read the perk on the tool the player is **currently holding**. They require the player to be **online**. If the tool has no perk (or no tool is held), they return the "no perk" values noted below.

#### %edperks\_current\_perk%

The display name of the perk on the held tool, followed by its level in Roman numerals (e.g. `&d&lFortune Perk V`). Returns the `placeholders.no-perk` text (default `&7None`) when there's no perk.

#### %edperks\_current\_perk\_level%

The numeric level (1–5) of the perk on the held tool. Returns `0` when there's no perk.

#### %edperks\_current\_perk\_roman%

The level of the perk on the held tool in Roman numerals (`I`–`V`). Returns an empty string when there's no perk.

#### %edperks\_perk\_boost\_{stat}%

The boost value the current perk grants for `{stat}` at its rolled level, formatted to up to 3 decimals (e.g. `0.25`). Returns `0` when there's no perk or the perk doesn't touch that stat.

**Examples:**

* `%edperks_perk_boost_money%` — the money boost of the held tool's perk.
* `%edperks_perk_boost_damage%` — the damage boost.
* `%edperks_perk_boost_enchant%` — the enchant boost.

See [Boost Stats](/p/edperks/essential/perks/boost-stats.md) for the valid stat keys.

***

### Usage Examples

**Scoreboard / menu line:**

```
&dTickets: &f%edperks_tickets%
&dPity: &f%edperks_rolls_until_pity%&7/&f%edperks_pity_max%
&dPerk: %edperks_current_perk%
```

**Conditional display (with a plugin that supports conditions):**

```
%edperks_current_perk_level% >= 5
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://edseries-plugins.gitbook.io/p/edperks/essential/placeholders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.