> 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/momentum/boosters.md).

# Boosters

Boosters are **live**: the moment a player reaches a level, its boosters flow straight into PinnaPrison's income and enchant math — no delay, no commands. The moment momentum drops below the level, they vanish.

{% hint style="info" %}
Boosters are a **PinnaPrison** feature. On EdPrison, EdTools and EdDungeons, momentum levels still track and display — reward them through each level's `effects.commands` instead (see [Levels](/p/codexmomentum/momentum/levels.md)).
{% endhint %}

## Booster types

Each level can hold any number and mix of these:

```yaml
boosters:
  - type: currency          # +10% income of one currency
    currency: tokens        # PinnaPrison currency id
    multiplier: 0.10
  - type: enchant           # +25% proc chance of one enchant
    enchant: jackhammer     # PinnaPrison enchant id
    multiplier: 0.25
  - type: all-enchants      # +10% proc chance on EVERY enchant
    multiplier: 0.10
```

| Type           | Effect                                                   |
| -------------- | -------------------------------------------------------- |
| `currency`     | Multiplies income of the given currency (`0.10` = +10%). |
| `enchant`      | Multiplies the proc chance of one specific enchant.      |
| `all-enchants` | Multiplies the proc chance of every enchant at once.     |

## Stacking

**`boosters.stack-levels`** in `config.yml` controls how the ladder composes:

* `false` (default) — only the **current** level's boosters apply. Each level should list its full loadout (this is how the default ladder is written: level V lists +25% Tokens, not +5%).
* `true` — levels **inherit and add up** all previous levels' boosters. Each level then only lists its increment.

## Displaying the boost

Set `multiplier-display` on each level to describe its boost; it feeds `{multiplier}` in the boss bar/titles and `%codexmomentum_multiplier%`. Per-economy values are also exposed as `%codexmomentum_multiplier_<id>%` — see [Placeholders](/p/codexmomentum/reference/placeholders.md).