# PlaceholderAPI support

## BattlePass Installation Guide

### Step 1: Download PlaceholderAPI

First, download PlaceholderAPI from its official source. Ensure you have the correct version compatible with your server.

### Step 2: Install PlaceholderAPI

* **Installation**:
  * Locate the downloaded `PlaceholderAPI.jar` file.
  * Move this file into your server's `plugins` folder.
* **Server Restart**:
  * After placing the file, restart your server to complete the installation process.

### Step 3: Using Placeholders

BattlePass integrates seamlessly with PlaceholderAPI, providing various placeholders to enhance your server experience.

#### Testing Placeholders

* To test a placeholder, use the command: `/papi parse me <placeholder>`
  * Example: `/papi parse me %albattlepass_exp%`

#### List of Placeholders

* **Player Experience**: `%albattlepass_exp%`
  * *Description*: Returns the player's current experience points.
* **Player Level**: `%albattlepass_level%`
  * *Description*: Shows the player's current BattlePass level.
* **Experience for Level Up**: `%albattlepass_required_exp%`
  * *Description*: Indicates the amount of experience required for the next level.

### Customization

You can personalize user experience by modifying messages in the `messages.yml` file.

#### Editing Loading Messages

* Locate `messages.yml` in the BattlePass plugin folder.
* Modify the `placeholder_loading` entry to change the loading message.
  * Example:

```yaml
# in messages.yml file
placeholder_loading: "Loading.."
```


---

# 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://docs.anotherlevel.it/documentation/battlepass/placeholderapi-support.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.