🤖 Commands

On this page, you will find the voucher commands and their permissions.

#Player Commands

/crate redeem <code> - Redeems a code. Needs no permission, though an individual code can require one through its own permission option.

#Admin Commands

/crate createVoucher <code> <key> [amount] [uses] - Creates a code granting a number of one key. Pass - as the code to generate one instead of choosing it. uses is the total across the server, -1 for unlimited. Requires phoenixcrates.command.createvoucher.
/crate deleteVoucher <code> - Deletes a code. Requires phoenixcrates.command.deletevoucher.
/crate vouchers - Lists every code with its usage count and status. Requires phoenixcrates.command.vouchers.
/crate resetVouchers <player> - Clears which codes a player has redeemed, letting them redeem them all again. Requires phoenixcrates.command.resetvouchers.

#Permissions

Permission	What it allows
`phoenixcrates.command.createvoucher`	Creating codes.
`phoenixcrates.command.deletevoucher`	Deleting codes.
`phoenixcrates.command.vouchers`	Listing codes.
`phoenixcrates.command.resetvouchers`	Resetting a player's redeemed codes.

#Creating a code in game

/crate createVoucher SUMMER25 vote 5 100

Creates SUMMER25, granting five vote keys, redeemable a hundred times across the server and once per player.

/crate createVoucher - legendary 1 1

Generates a code granting a single legendary key that only one player can ever use, which is the shape a personal reward or a single-winner giveaway takes.

A code made this way is written straight into vouchers.yml and works immediately, with no reload. Anything the command does not cover — items, commands, an expiry date, a permission — is edited into the file afterwards.

The command refuses a code that already exists rather than overwriting it, so an accidental repeat cannot wipe the usage count of a live giveaway.

#Status in the list

/crate vouchers marks each code as one of:

Status	Meaning
`active`	Redeemable.
`disabled`	`enabled` is off.
`expired`	Past its `expires-at`.
`exhausted`	Has reached `max-uses`.

Last updated 9 days ago