> For the complete documentation index, see [llms.txt](https://mcpets.gitbook.io/mcpets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mcpets.gitbook.io/mcpets/tutorials/placeholder-api-support.md).

# 📜 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)             |