> For the complete documentation index, see [llms.txt](https://mrlarkyy.gitbook.io/aquaticcrates-v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mrlarkyy.gitbook.io/aquaticcrates-v3/configuring/crate.md).

# Crate

## Options

### Key

Info regarding **Crate Keys** can be found [here](/aquaticcrates-v3/configuring/keys.md).

{% content-ref url="/pages/2Fjn5YI7hAVW780dlz6L" %}
[Keys](/aquaticcrates-v3/configuring/keys.md)
{% endcontent-ref %}

### Display Name

A display name of the crate that is being used for placeholders in plugin messages.

This display name is not being used in preview or any other places. This is completely intentional, so you can modify everything to your needs!

### Mass Open

Info regarding **Mass Opening** can be found [here](/aquaticcrates-v3/configuring/mass-opening.md).

{% content-ref url="/pages/8TeNK4kRyb8gNxnaYxvx" %}
[Mass Opening](/aquaticcrates-v3/configuring/mass-opening.md)
{% endcontent-ref %}

### Interactables

Info regarding **Interactables** can be found [here](/aquaticcrates-v3/configuring/crate/visuals.md).

{% content-ref url="/pages/vHhuxZyaojnOInjBlhJR" %}
[Visuals](/aquaticcrates-v3/configuring/crate/visuals.md)
{% endcontent-ref %}

### Rewards

Info regarding **Rewards** can be found [here](#rewards).

{% content-ref url="/pages/2FE0ZnXSxPJvoJC3ycAn" %}
[Rewards](/aquaticcrates-v3/configuring/rewards.md)
{% endcontent-ref %}

### Possible Rewards

Info regarding **Possible Rewards** can be found [here](/aquaticcrates-v3/configuring/rewards.md#possible-rewards).

{% content-ref url="/pages/2FE0ZnXSxPJvoJC3ycAn" %}
[Rewards](/aquaticcrates-v3/configuring/rewards.md)
{% endcontent-ref %}

### Example configuration

This is an example config that the plugin is being tested with.

This configuration <mark style="color:red;">**does not**</mark> contain stuff such as [**rerolls**](/aquaticcrates-v3/configuring/reroll.md), [**preview** ](/aquaticcrates-v3/configuring/preview.md)& [**animations**](/aquaticcrates-v3/configuring/animation.md)!

<pre class="language-yaml" data-line-numbers data-full-width="false"><code class="lang-yaml"><strong>key:
</strong>  material: STONE
  display-name: "&#x3C;red>Example Pouch 2!"
  lore:
    - " "
    - "&#x3C;gray>Example line!"
  enchants:
    - "aqua_affinity:1"
  interaction:
    RIGHT:
      type: "open-crate"
display-name: "Example Pouch"
mass-open:
  final-tasks:
    - type: message
      message: "You have won %total-won-excluded% rewards in Mass Opening!"
  per-reward-tasks:
    - type: message
      message: "- %amount%x %reward%"
interactables:
  - type: ITEM_MODEL
    offset: "0;0.5;0"
    item-transform: "NONE"
    scale: "1;1;1"
    item:
      material: "STONE"
    billboard: FIXED
  - type: BLOCK
    material: BARRIER
possible-rewards:
  - min: 1
    max: 1
    chance: 100
rewards:
  example:
    amount-ranges:
      - min: 1
        max: 1
        chance: 100
    item:
      material: DIAMOND
      display-name: "example 1"
    give-item: true
    chance: 100
    actions:
      - type: message
        message: "You have won %random-amount%x diamond!"
        mass-open-execute: false
  example2:
    amount-ranges:
      - min: 1
        max: 1
        chance: 100
    item:
      material: IRON_INGOT
      display-name: "example 2"
    give-item: true
    chance: 100
    actions:
      - type: message
        message: "You have won %random-amount%x iron ingot!"
        mass-open-execute: false
  example3:
    amount-ranges:
      - min: 1
        max: 1
        chance: 100
    item:
      material: EMERALD
      display-name: "example 3"
    give-item: true
    chance: 100
    actions:
      - type: message
        message: "You have won %random-amount%x emerald!"
        mass-open-execute: false
</code></pre>