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

# Placeholders

Requires [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/). All placeholders start with `%codexmomentum_`.

## Level & boost

| Placeholder                           | Value                                                                     |
| ------------------------------------- | ------------------------------------------------------------------------- |
| `%codexmomentum_level%`               | Current momentum level                                                    |
| `%codexmomentum_tier%`                | Same as `level`                                                           |
| `%codexmomentum_level_roman%`         | Current level as a Roman numeral                                          |
| `%codexmomentum_tier_roman%`          | Same as `level_roman`                                                     |
| `%codexmomentum_max_level%`           | Highest configured level                                                  |
| `%codexmomentum_multiplier%`          | The level's `multiplier-display` (or `placeholders.no-multiplier`)        |
| `%codexmomentum_multiplier_<id>%`     | The boost value for one economy, e.g. `%codexmomentum_multiplier_tokens%` |
| `%codexmomentum_multiplier_enchants%` | The `all-enchants` boost value                                            |

## Progress & streak

| Placeholder                    | Value                                                                        |
| ------------------------------ | ---------------------------------------------------------------------------- |
| `%codexmomentum_progress%`     | Progress blocks within the current level                                     |
| `%codexmomentum_required%`     | Blocks required for the next level                                           |
| `%codexmomentum_remaining%`    | Blocks still missing for the next level                                      |
| `%codexmomentum_percent%`      | Progress percentage                                                          |
| `%codexmomentum_blocks%`       | Total blocks this streak                                                     |
| `%codexmomentum_time_current%` | Current streak duration                                                      |
| `%codexmomentum_decaying%`     | Whether momentum is draining (styled via `placeholders.decaying-true/false`) |

## Records

| Placeholder                     | Value                          |
| ------------------------------- | ------------------------------ |
| `%codexmomentum_record_level%`  | Best level ever reached        |
| `%codexmomentum_streak_record%` | Longest streak duration        |
| `%codexmomentum_record_blocks%` | Most blocks in a single streak |