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

# Attributes

Attributes are permanent pickaxe upgrades unlocked by **rebirthing**. Each level grants a set of percentage boosts (currencies + enchant proc chance) and is purchased with a currency. Configured in `attributes.yml`.

```yaml
unlocked-material: 'LIME_STAINED_GLASS_PANE'
locked-material: 'RED_STAINED_GLASS_PANE'
purchase-sound: 'ENTITY_PLAYER_LEVELUP'

purchased-status:
  - ''
  - '&a[ᴘᴜʀᴄʜᴀꜱᴇᴅ]'
available-status:
  - ''
  - '&a&l[ᴄʟɪᴄᴋ ᴛᴏ ᴘᴜʀᴄʜᴀꜱᴇ]'
locked-status: []

attributes:
  '1':
    level: 1
    unlock-level: 'rebirth'
    unlock-amount: 1
    cost-currency: 'shards'
    cost-amount: 1500
    name: '&cPickaxe Attribute &r[Level 1]'
    lore:
      - '&7Purchasing this provides the buffs below:'
    boosts:
      beacons: 5
      money: 5
      tokens: 5
      pickaxexp: 5
      rankupxp: 5
      enchant: 0.5
```

## Global

| Key                                                       | Description                                                       |
| --------------------------------------------------------- | ----------------------------------------------------------------- |
| `unlocked-material` / `locked-material`                   | Glass-pane materials for purchased vs locked entries in the menu. |
| `purchase-sound`                                          | Played on purchase.                                               |
| `purchased-status` / `available-status` / `locked-status` | Status lore appended to an attribute depending on its state.      |

## Per-attribute (`attributes.<id>`)

| Key                             | Description                                                                                          |
| ------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `level`                         | The attribute level (purchased in order).                                                            |
| `unlock-level`                  | The [leveling track](/p/pinnaprison/core/leveling.md) that gates this attribute (usually `rebirth`). |
| `unlock-amount`                 | The level required on that track to unlock it.                                                       |
| `cost-currency` / `cost-amount` | The currency and price.                                                                              |
| `name`                          | Display name.                                                                                        |
| `lore`                          | Item lore.                                                                                           |
| `boosts`                        | Percentage boosts granted, keyed by currency id or `enchant` (proc chance).                          |

{% hint style="info" %}
Attributes stack as the player buys higher levels, so each level's `boosts` are the **total** at that level (the default file ramps every currency +5% per level).
{% endhint %}

## Usage

* **`/attributes`** (alias `/attribute`) — open the attributes menu (`guis/attributes.yml`). Players purchase the next level if they meet the rebirth requirement and can afford the cost.


---

# 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/attributes.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.