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

# Crate configuration

{% code overflow="wrap" fullWidth="true" %}

```yaml
# Cooldown in seconds until a player can collect a new crate of this type
# THIS OVERRIDES THE SAME SETTING IN THE ENVOY'S CATEGORY! If you do NOT want to override it, remove it from here
collect-cooldown: 10
broadcast-collect: false

display-name: "&cCommon"
block: diamond_block

falling-block:
  enabled: true # If a falling block should be spawned where a crate is spawned
  height: 10 # The height where the falling block will fall from
  block: end_rod # The type of the block that is falling
  speed: -1 # The speed at which the block will fall (blocks per second) -1 because we want downwards momentum

rewards:
  - chance: 10.0
    commands:
      - "eco give %player% 1000"
  - chance: 30.0
    commands:
      - "eco give %player% 500"
  - chance: 100.0
    commands:
      - "eco give %player% 50"

hologram:
  enabled: true
  height: 2.0
  lines:
    - "&7Envoy!"
    - "&fRarity: &acommon."
```

{% endcode %}

## Options

#### General

collect-cooldown: The collect cooldown for this crate. Remove this option entirely from the crate's config file if you don't want to override it from the envoy.

broadcast-collect: Whether the collection of this crate should be broadcasted.

block: The material of the spawned crate

#### Falling block

enabled: Whether or not the plugin should spawn falling blocks above the spawn location of a crate

height: The height from which the crate will fall

block: The material used for the falling block

speed: The y vector applied to the block before falling. If you want it to fall down at 1 blocks per second, set it to -1 

#### Rewards

Currently, only command rewards are supported, but soon items will be supported aswell.

chance: The chance of the player getting the reward. Note: setting this to 100 does not guarantee you getting the reward always as the chances always add up to 100%.

commands: The commands that will be executed when this reward is selected.

#### Hologram

**Currently ONLY DecentHolograms is supported for holograms! The holograms will NOT work if you don't have DecentHolograms!**

enabled: If we should try to place holograms above the spawned crate.

height: The height added to the y coordinate from the spawned crate's location. 

lines: The lines of the hologram

#### Want to add a new crate? 

To add a new crate, all you need to do is copy the default file into a new file, named differently and make your edits to the new one.

After that, you need to reload the plugin and voila, the new crate will be loaded.