> 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/edperks/essential/perks/boost-stats.md).

# Boost Stats

A perk's power comes from its **boosts** — a map of `stat-key: value` under each level. The value is a **multiplier expressed as a decimal**: `0.25` means **+25%**, `1.00` means **+100%**, `0.05` means **+5%**.

```yaml
levels:
  '1':
    lore: '&a&lI &8— &fMoney &75%'
    boosts: { money: 0.05 }            # +5% money
  '5':
    lore: '&a&lV &8— &fMoney &725%'
    boosts: { money: 0.25 }            # +25% money
```

A single level can boost several stats at once:

```yaml
boosts: { money: 0.50, shards: 0.50, souls: 0.75, essence: 0.75 }
```

***

### How stats reach the host

EdPerks does **not** keep a fixed list of legal stats. Each [host plugin](/p/edperks/extra/host-integrations.md) decides which keys it understands. When a perk is applied, the host turns each boost into a permanent booster on the matching economy. A boost whose key the active host **doesn't** recognise simply contributes nothing on that platform — it is inert, not an error.

This is the whole point of the design: **one perk file works on every host**, and each host quietly ignores the stats that don't apply to it.

***

### Stats supported by EdDungeons

The EdDungeons host can boost **any** of its economies plus three special keys. The keys advertised in the menus are:

| Key            | Boosts                                      |
| -------------- | ------------------------------------------- |
| `damage`       | Sword damage                                |
| `money`        | Money currency                              |
| `souls`        | Souls currency                              |
| `essence`      | Essence currency                            |
| `shards`       | Shards currency                             |
| `credits`      | Credits currency                            |
| `enchant`      | Global enchant proc chance                  |
| `tool-exp`     | Sword XP (alias for EdDungeons' `sword-xp`) |
| `attack-speed` | Auto-hit speed                              |

{% hint style="info" %}
EdDungeons applies boosts through its public booster API, so **any** EdDungeons currency id works as a key — not just the ones listed above. For example a perk could boost `rebirth-points` directly. The only friendly alias is `tool-exp` → `sword-xp`.
{% endhint %}

***

### Stats supported by EdTools

The EdTools host advertises:

| Key          | Boosts                                          |
| ------------ | ----------------------------------------------- |
| `money`      | Money currency                                  |
| `farm-coins` | Farm Coins currency                             |
| `mine-coins` | Mine Coins currency                             |
| `enchant`    | Global enchant booster                          |
| `tool-exp`   | The block currency bound to the perk's own tool |

As with EdDungeons, **any** EdTools currency id works as a key. The special `tool-exp` key is resolved at apply time to the **block currency of the tool the perk is on** (e.g. `crop-tool` → `crop-blocks`). Because EdTools auto-levels a tool from that currency, boosting it makes the tool level up faster. If the tool has no bound block currency, `tool-exp` does nothing for it.

***

### The `attack-speed` stat

`attack-speed` is treated as an **inverted** stat by hosts: a higher value is better for the player (it represents a reduction in the auto-hit cooldown). EdPerks stores the raw value as configured; the host decides how to interpret it. Bundled EPIC/LEGENDARY perks use small values like `0.05`–`0.10`.

***

### Quick reference: bundled stat usage

| Stat           | Used by perks                                               |
| -------------- | ----------------------------------------------------------- |
| `damage`       | Attack, Strength, Godly, Demon, Power, Master, Universal    |
| `money`        | Money, Goldrush, Mermaid, Fortune, Power, Master, Universal |
| `souls`        | Souls, Ancestral, Banker, Fortune, Universal                |
| `essence`      | Essence, Spirit, Banker, Fortune, Universal                 |
| `shards`       | Shard, Power, Fortune, Universal                            |
| `enchant`      | Wizard, Magnet, Demon, Godly, Master, Universal             |
| `tool-exp`     | Blacksmith, Magnet, Mermaid, Universal                      |
| `attack-speed` | Godly, Master, Universal                                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://edseries-plugins.gitbook.io/p/edperks/essential/perks/boost-stats.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.
