VVOUCHER API
Methods
This page collects the public API methods and the related usage event in one place.
Available Methods
| Method | Returns | Description |
|---|---|---|
getAllVouchers() | List<VoucherDefinition> | Returns every loaded voucher, including disabled ones. |
getEnabledVouchers() | List<VoucherDefinition> | Returns only vouchers that are currently enabled. |
isVoucher(ItemStack itemStack) | boolean | Checks the persistent voucher marker on the item. |
getVoucher(ItemStack itemStack) | VoucherDefinition | Resolves voucher data from a tagged item instance. |
getVoucher(String configKey) | VoucherDefinition | Looks up a voucher directly by config id. |
Usage Event
The API also exposes a cancellable VVoucherUsage Bukkit event.
@EventHandler
public void onVoucherUsage(VVoucherUsage event) {
if (event.getVoucher().getId().equalsIgnoreCase("fly-permission")) {
event.setCancelled(true);
}
}Behavior Notes
getAllVouchers()includes disabled vouchers too.getEnabledVouchers()filters only active ones.getVoucher(item)works from persistent metadata, not display name.getVoucher(configKey)can still resolve disabled vouchers.