VZone Plugins/API/Methods

Available Methods

MethodReturnsDescription
getAllVouchers()List<VoucherDefinition>Returns every loaded voucher, including disabled ones.
getEnabledVouchers()List<VoucherDefinition>Returns only vouchers that are currently enabled.
isVoucher(ItemStack itemStack)booleanChecks the persistent voucher marker on the item.
getVoucher(ItemStack itemStack)VoucherDefinitionResolves voucher data from a tagged item instance.
getVoucher(String configKey)VoucherDefinitionLooks 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.