VVOUCHER API
Examples
Practical integration examples for provider setup, voucher lookup, event lookup, and reusable event execution.
Provider Setup
VVoucherApi api = VVoucherProvider.get();
if (api == null) {
getLogger().warning("VVoucher is not available.");
return;
}List Enabled Vouchers
for (VoucherDefinition voucher : api.getEnabledVouchers()) {
getLogger().info("Enabled voucher: " + voucher.getId());
}List Loaded Events
for (EventDefinition eventDefinition : api.getAllEvents()) {
getLogger().info("Loaded event: " + eventDefinition.getId());
}Check Item
ItemStack item = player.getInventory().getItemInMainHand();
if (api.isVoucher(item)) {
player.sendMessage("This item is a VVoucher voucher.");
}Get Event Data
EventDefinition eventDefinition = api.getEvent("example-event");
if (eventDefinition != null) {
getLogger().info("Found event: " + eventDefinition.getId());
}Execute Event
VoucherDefinition.RandomCommandEntry reward = api.executeEvent("example-event", player);
if (reward != null) {
player.sendMessage("Selected reward: " + reward.getId());
}Usage Event
@EventHandler
public void onVoucherUsage(VVoucherUsage event) {
if (event.getVoucher().getId().equalsIgnoreCase("fly-permission")) {
event.setCancelled(true);
}
}