> 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/pinnaprison/tools-and-items/abilities.md).

# Abilities

Pickaxe **abilities** are perks unlocked by dragging an ability item onto the pickaxe. There are two kinds:

* **Lucky Block abilities** — always on once equipped; each mined block has a chance to grant a [lucky block](/p/pinnaprison/tools-and-items/luckyblocks.md) and charges the ones in your inventory.
* **Booster abilities** — activated with the drop key **\[Q]** (or auto-cast); grant timed boosters on a cooldown.

Configured in `abilities.yml`.

```yaml
unlock-sound: 'ENTITY_PLAYER_LEVELUP'
selected-text: '&a▶ EQUIPPED &7(click to unequip)'
unselected-text: '&eᴄʟɪᴄᴋ ᴛᴏ ᴇǫᴜɪᴘ ᴛʜɪѕ ᴀʙɪʟɪᴛʏ'
selected-none: '&cNone'

abilities:
  luckyblock:
    type: luckyblock
    material: 'texture-…'
    name: '&6&lLucky Block &e&lAbility'
    grant-chance: 0.5             # % chance per mined block to grant a lucky block
    lucky-blocks:
      common: 70
      rare: 25
      legendary: 5
    lore-locked: [ … ]
    lore-unlocked: [ … '{selected}' ]
    item: { material: 'texture-…', name: '…', lore: [ … ] }

  booster:
    type: booster
    name: '&5&lBooster &d&lAbility'
    duration: 30
    cooldown: 300
    boosts:
      tokens: 1.0
      money: 1.0
    lore-unlocked: [ … '&a&lUNLOCKED &8- &7{state}' … '{selected}' ]
    item: { … }
```

## Global

| Key               | Description                                        |
| ----------------- | -------------------------------------------------- |
| `unlock-sound`    | Played when an ability is unlocked.                |
| `selected-text`   | The `{selected}` line when an ability is equipped. |
| `unselected-text` | The `{selected}` line when not equipped.           |
| `selected-none`   | Shown where no ability is selected.                |

## Per-ability (`abilities.<id>`)

| Key                             | Description                                                                  |
| ------------------------------- | ---------------------------------------------------------------------------- |
| `type`                          | `luckyblock` or `booster`.                                                   |
| `material`                      | Icon material (supports `texture-<base64>` heads).                           |
| `name`                          | Display name.                                                                |
| `lore-locked` / `lore-unlocked` | Lore shown before / after unlocking (use `{selected}` for the equip status). |
| `item`                          | The drag-and-drop unlock item.                                               |

### Lucky Block ability

| Key            | Description                                                                          |
| -------------- | ------------------------------------------------------------------------------------ |
| `grant-chance` | % chance per mined block to drop a random lucky block while equipped.                |
| `lucky-blocks` | Weighted list of which lucky-block tier is granted (`common`, `rare`, `legendary`…). |

### Booster ability

| Key        | Description                                                                                                                            |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `duration` | How long the boost lasts (seconds).                                                                                                    |
| `cooldown` | Cooldown between activations (seconds).                                                                                                |
| `boosts`   | The multipliers granted, keyed by currency id (`1.0` = +1.0x → x2). `{state}` and `{duration}`/`{cooldown}` are available in the lore. |

## Usage

* **Drag and drop** an ability item onto the pickaxe to unlock it.
* **\[Q]** (drop key) activates the equipped booster ability (or enable auto-cast in the menu).
* **`/abilities`** (alias `/ability`) — open the abilities menu (`guis/abilities.yml`).
* Admins: `/abilities give <player> <ability>`.


---

# 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/pinnaprison/tools-and-items/abilities.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.