> For the complete documentation index, see [llms.txt](https://obey.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://obey.gitbook.io/wiki/tools/placeholders.md).

# Placeholders

Internal placeholders supported by CrownTools.

CrownTools includes a set of internal placeholders used dynamically in tool display names, tool item lore, and chat messages.

## Lore & Message Placeholders

The following placeholders can be used in `messages.yml` under tool lore templates and system messages:

| Placeholder              | Description                                                                                              | Example Output            |
| ------------------------ | -------------------------------------------------------------------------------------------------------- | ------------------------- |
| `%uses%`                 | Current number of uses consumed by the tool.                                                             | `15`                      |
| `%max-uses%`             | Maximum uses allowed before breaking (`Unlimited` if `-1`).                                              | `1,000`                   |
| `%remaining%`            | Remaining uses left (USES mode) or remaining duration (TIME mode) before breaking (`Unlimited` if `-1`). | `985` / `1d 12h 30m`      |
| `%expires%`              | Expiration date and time for `TIME` based tools.                                                         | `22/07/2026 21:45:00`     |
| `%secondary%`            | Secondary metric (Blocks broken, rocket uses, or liquid ops).                                            | `2,450`                   |
| `%liquid%`               | Stored liquid material for the Endless Bucket.                                                           | `WATER` / `LAVA` / `None` |
| `%amount%`               | Total liquid blocks stored or processed by Endless Bucket.                                               | `42`                      |
| `%price%`                | Cost required to repair the tool via Vault economy.                                                      | `10,000,000`              |
| `%tool%` / `%tool-type%` | The name/type of the custom tool.                                                                        | `DRILL`                   |
| `%usage-type%`           | The durability usage mode of the tool.                                                                   | `USES` / `TIME`           |
| `%value%`                | Configured duration or max uses value given to the tool.                                                 | `100` / `1d`              |
| `%player%`               | Name of the player holding or receiving the tool.                                                        | `Obey`                    |

***

## Placeholder Processing

Placeholders are parsed dynamically whenever a tool's stats update (e.g., after breaking blocks, launching fireworks, or soaking liquids). Standard number formatting (with comma separators) is automatically applied to numeric placeholders such as `%secondary%`, `%price%`, `%uses%`, and `%remaining%`.