# 📜 Placeholder API support

MCPets 3.0.4 recently implemented [Placeholder API](https://www.spigotmc.org/resources/placeholderapi.6245/) support.

The placeholders are referring to the pet of the player that is requesting the placeholder (the owner of a given pet).

The available placeholders are given below (to be surrounded by `%` or `{}` depending on your config):

| Placeholder                       | String returned                                              |
| --------------------------------- | ------------------------------------------------------------ |
| mcpets\_pet\_name                 | Custom name of the pet (given by the player)                 |
| mcpets\_pet\_id                   | Internal name of the pet (id)                                |
| mcpets\_pet\_distance             | Current distance of the pet from the owner                   |
| mcpets\_pet\_health               | Current health value                                         |
| mcpets\_pet\_max\_health          | Level's max health value                                     |
| mcpets\_pet\_icon\_name           | Name of the icon of the pet in the summoning menu            |
| mcpets\_pet\_owner\_name          | Name of the owner of the pet                                 |
| mcpets\_pet\_owner\_uuid          | UUID of the owner of the pet                                 |
| mcpets\_pet\_level\_name          | Name of the level the pet is currently at (Living pet only)  |
| mcpets\_pet\_level\_index         | Index of the level the pet is currently at (Living pet only) |
| mcpets\_pet\_exp                  | Experience of the pet (Living pet only)                      |
| mcpets\_pet\_power                | Power modifier of the pet (Living pet only)                  |
| mcpets\_pet\_damage\_modifier     | Damage modifier of the pet (Living pet only)                 |
| mcpets\_pet\_resistance\_modifier | Resistance modifier of the pet (Living pet only)             |


---

# 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://mcpets.gitbook.io/mcpets/tutorials/placeholder-api-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.