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

# Crystals

Crystals are items players **drag and drop onto their pickaxe** to apply a permanent percentage boost. Each pickaxe has a limited number of crystal **slots**. A crystal rolls a random multiplier and a chance to apply when used. Configured in `crystals.yml`.

```yaml
default-crystal-slots: 3
can-have-same-booster-crystal: false

crystal-applied-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
crystal-broke-sound: "BLOCK_ANVIL_DESTROY"
crystal-invalid-sound: "ENTITY_VILLAGER_NO"

gui: 'crystals'

pickaxe-crystal-format: ' &b| {crystal-format}'
pickaxe-no-crystals-format: ' &b| &cNo crystals applied!'

formats:
  tokens: "&c{multiplier}% &4Tokens Boost"
  money: "&a{multiplier}% &2Money Boost"
  all-enchants: "&9{multiplier}% &3All Enchants Boost"

items:
  tokens-crystal:
    boost: tokens
    multiplier: 25-100
    chance: 50-100
    item:
      material: RED_DYE
      name: '&4&lTokens &c&lCrystal'
      lore:
        - ' &4* &cChance: &f{chance}% Chance to apply'
        - ' &4* &cBoost: &f{multiplier}% &4Tokens &cBoost'
```

## Settings

| Key                                                                       | Description                                                                 |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `default-crystal-slots`                                                   | Crystal slots every player starts with. Add more with `/crystals addslots`. |
| `can-have-same-booster-crystal`                                           | Whether a player may apply more than one crystal of the same boost.         |
| `crystal-applied-sound` / `crystal-broke-sound` / `crystal-invalid-sound` | Sounds for apply / fail / invalid (out of slots or duplicate).              |
| `gui`                                                                     | The crystals menu (`guis/crystals.yml`).                                    |
| `pickaxe-crystal-format`                                                  | How an applied crystal renders in the pickaxe lore (`{crystal-format}`).    |
| `pickaxe-no-crystals-format`                                              | Shown in the pickaxe lore when no crystals are applied.                     |
| `formats.<boost>`                                                         | How each boost type renders (`{multiplier}`).                               |

## Crystal items (`items`)

| Key          | Description                                                                                                     |
| ------------ | --------------------------------------------------------------------------------------------------------------- |
| `boost`      | The boost type — a currency id (e.g. `tokens`, `money`) or `all-enchants` (boosts every enchant's proc chance). |
| `multiplier` | The boost %. A **range** like `25-100` rolls a random value when the crystal is created.                        |
| `chance`     | The % chance the crystal **applies** when dropped on the pickaxe. Also a range.                                 |
| `item`       | The crystal item. Lore placeholders: `{multiplier}`, `{chance}`.                                                |

{% hint style="info" %}
When a crystal is given/created, its `multiplier` and `chance` are rolled from their ranges. On apply, the `chance` decides whether it sticks — if it fails, the crystal breaks.
{% endhint %}

## Usage

* **Drag and drop** a crystal item onto the pickaxe to apply it.
* **`/crystals`** (alias `/crystal`) — open the crystals menu.
* Admins:
  * `/crystals give <player> <crystal-id>` — give a crystal item.
  * `/crystals addslots\|removeslots\|setslots <player> <amount>` — manage crystal slots.

## Placeholders

```
%pinnaprison_crystals_slots%  -> total slots
%pinnaprison_crystals_used%   -> applied crystals
```


---

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