VZone Plugins/API/Examples

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);
    }
}