Skip to main content

Vouchers

A voucher is a physical item (a paper) that represents a vehicle. Instead of giving a vehicle straight into someone's garage, you can hand them a voucher they redeem whenever they want — perfect for crate rewards, kits, shops or giveaways.


Creating a voucher

/v getvoucher <vehicle> [red] [green] [blue]

This gives you a voucher item for the chosen model. The optional RGB values bake a color into the voucher, so the redeemed vehicle comes out in that color. Requires the vp.voucher permission.

The voucher's tooltip shows the vehicle and color, e.g.:

Vehicle Voucher
Vehicle: Audi A6
Color: #010101
Right click to redeem it.
tip

Vouchers are normal items, so you can drop them into crate plugins, kits, /give-style reward commands, or trade them between players.


Redeeming a voucher

The player simply right-clicks the voucher. The vehicle is added to their personal garage, and one voucher is consumed from the stack. Stacked vouchers redeem one per click.

If a voucher carries a color, the spawned vehicle uses it automatically.


Notes

  • Redeeming respects the same checks as receiving any vehicle (the VehicleGiveEvent), so other plugins can hook into or cancel it.
  • A voucher is consumed only on a successful redeem — if the vehicle can't be created, the voucher stays in the player's hand.