# Placeholders

**Need** [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/)**:**

* **%documents\_name%**: Retrieves the player's full name (first name and surname). This can be used to address players more personally in messages or documents within the game.
* **%documents\_gender%**: Returns the gender of the player. This placeholder allows for gender-specific interactions or content, making the game more inclusive and personalized.
* **%document\_age%**: Displays the age of the player. This information can be used to tailor content or restrictions based on age, ensuring appropriate gameplay experiences.

#### Placeholder Loading Behavior

When the information required by a placeholder is not immediately available, the plugin will display a "Not loaded" status. This is a temporary state, indicating that the plugin is in the process of retrieving the necessary data.

**Customizing 'Not Loaded' Status**

To enhance user experience and maintain immersion, you can customize the message displayed when a placeholder's information is not yet loaded. This customization is done through the `messages.yml` file, specifically the `not_loaded_placeholder_yet` setting. By adjusting this setting, you can provide a more fitting message for your server's theme or simply inform players that information is on the way without breaking their immersion.

For example, to change the "Not loaded" status to "Loading...", you would modify the `messages.yml` file as follows:

```yaml
yamlCopy codenot_loaded_placeholder_yet: "Loading..."
```

This small change can significantly improve how players perceive the loading process, making it feel more integrated into the game.


---

# 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/documents/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.