# Placeholders

Using the external [PlaceholderAPI ](https://www.spigotmc.org/resources/placeholderapi.6245/)(PAPI) expansion for PrisonPick, different data can be fetched. Using a placeholder where a plugin parses a string for placeholders will result in the placeholders being replaced with the returned values.\
\
PrisonPick fetches the data that is returned based upon how the plugin is configured. For more information on saving data and configuration, [click here](/plugins/prisonpick/saving-data.md).

### Installation

1. Download the expansion from here. \[Not yet published]
2. Add this .jar file to the /plugins/PlaceholderAPI/expansions folder on the server
3. Restart PlaceholderAPI

### Placeholders

Currently, there are two different types of statistics that are supported: number of blocks mined and enchantment levels. Placeholder parameters are not case-sensitive.

{% hint style="info" %}
For enchantments with names that are longer than one word, use `_` to separate words within the placeholder.
{% endhint %}

{% tabs %}
{% tab title="Placeholders" %}

| Placeholder               | Returned String                                                           |
| ------------------------- | ------------------------------------------------------------------------- |
| %prisonPick\_blocksMined% | Gets the player's statistic for total blocks mined with their custom item |
| %prisonPick\_enchantName% | Gets the player's level of the defined enchantment                        |
| {% endtab %}              |                                                                           |

{% tab title="Examples" %}

| Input                                       | Output                |
| ------------------------------------------- | --------------------- |
| `Blocks Mined: %prisonPick_blocksMined%`    | `Blocks Mined: 534`   |
| `Jump Boost Level: %prisonPick_jump_boost%` | `Jump Boost Level: 3` |
| {% endtab %}                                |                       |
| {% endtabs %}                               |                       |


---

# Agent Instructions: 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://wiki.darrionatplugins.com/plugins/prisonpick/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.