> For the complete documentation index, see [llms.txt](https://obey.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://obey.gitbook.io/wiki/kits/features/vouchers.md).

# Kit Vouchers

Physical, tradeable kit vouchers in CrownKits.

CrownKits provides a built-in voucher system that allows server administrators to generate physical, tradeable voucher items for any kit.

***

## Generating Vouchers

Administrators with the `command.kits.voucher` permission can create vouchers using:

* `/kit getvoucher <kitName>`: Gives a voucher for the specified kit to yourself.
* `/kit givevoucher <kitName> <player|all>`: Gives a voucher to a specific online player or all connected players.

***

## Redeeming Vouchers

* Players can simply **Right-Click** the voucher item while holding it in hand.
* The voucher item is consumed (1 count), and the kit's contents are directly equipped or added to the player's inventory according to the configured overflow behavior.
* Claiming a voucher ignores kit cooldowns.

***

## Configuration

In `config.yml`:

```yaml
# this is the material for the kit vouchers
voucher-material: PAPER
```

In `messages.yml`:

```yaml
voucher-displayname: "%crownkits_accent%&lᴋɪᴛ ᴠᴏᴜᴄʜᴇʀ &8- %kit%"

voucher-lore:
  - "&8Player Kits"
  - ""
  - "&bDescription"
  - " &fThis Voucher can be redeemed to"
  - " &fget the content of the Kit."
  - ""
  - "&6Information"
  - " #56FF00🗡 &fKit&8:&r %kit%"
  - ""
  - "&e&l➡ &nRIGHTCLICK&r &eto redeem the voucher"
```