ProVouchers

Integrations

Which plugins ProVouchers works with, and how it connects to them.

ProVouchers integrates with other plugins through Strata's hooks rather than talking to each plugin directly. The benefit: support is by capability, so any plugin that provides a capability (an economy, a permission system, a custom item) works the same way, with no ProVouchers-specific configuration. Install the plugin, and the matching feature lights up.

Economy

Used by the economy condition and the currency reward.

ProVouchers reads the economy provider registered with Vault, so it works with any Vault-compatible economy for that provider's currency:

  • EssentialsX Economy
  • CMI Economy
  • ExcellentEconomy, CoinsEngine (their Vault-registered currency)
  • PlayerPoints (via its Vault bridge)
rewards:
  - "currency: give 500"
conditions:
  - type: economy
    amount: 1000

Nothing to configure: install Vault and an economy plugin, and both the reward and the condition work.

Vault's economy interface is single-currency. Multi-currency plugins expose only their default currency through Vault, so additional named currencies (tokens, gems) are not reachable today.

Permissions and ranks

Used by the permission and rank conditions.

  • The permission condition works with plain Bukkit permissions, so it functions with any permissions plugin.
  • The rank condition needs a group-aware provider; LuckPerms is supported and resolves the player's groups.
conditions:
  - type: permission
    permission: "provouchers.use.vip"
  - type: rank
    groups: [ vip, mvp ]

Granting a rank or permission as a reward is native, backed by LuckPerms (Strata 0.10.0+):

rewards:
  - "group: add vip 7d"                 # temporary rank
  - "permission: add essentials.fly"    # set a permission node

See the group and permission rewards. These replace fragile lp user %player% parent addtemp ... command lines and run off the main thread.

Custom items

Used by the custom item field and the item reward.

ProVouchers references custom items as provider:id and asks Strata to build them:

item:
  custom: "itemsadder:ax_wings_pack:phoenix_wings"
rewards:
  - "item: oraxen:cool_sword 1"

Strata 0.10.0+ ships item hooks for ItemsAdder, Oraxen, and Nexo, so custom items work once the provider plugin is installed and the item exists. If a reference cannot be resolved, an item voucher falls back to its material and an item reward is skipped and logged.

Placeholders

Used everywhere text is rendered.

PlaceholderAPI is supported: its placeholders resolve in display names, lore, messages, broadcasts, titles, and action bars. See Text and Placeholders. Install PlaceholderAPI and the placeholders you reference, and they render automatically.

MiniPlaceholders is also supported (Strata 0.10.0+), for component-based, MiniMessage-native placeholders. It resolves in the same text alongside PlaceholderAPI.

Regions and claims

Used by the region condition.

Region restrictions (claim only in spawn, deny in PvP zones, and so on) work through a region hook. Strata 0.10.0+ ships a WorldGuard provider, so install WorldGuard and gate vouchers with type: region.

Everything else

For plugins ProVouchers does not integrate with natively, a command: reward covers almost every case:

rewards:
  - "command: crates give %player% vote 1"     # crate plugins
  - "command: ae givebook %player% Protection 5 100"   # enchant plugins
  - "command: kit give %player% starter"        # kits

This is intentional. Native integration is added only where commands are fragile or lossy. If /command %player% ... does the job cleanly, a command reward is the right tool.

Summary

Requires Strata 0.10.0 or newer.

CapabilityWorks viaStatus
Economy (give/take, balance check)VaultWorks now
Permissions (condition)BukkitWorks now
Ranks (condition)LuckPermsWorks now
PlaceholdersPlaceholderAPI, MiniPlaceholdersWorks now
Custom itemsItemsAdder, Oraxen, NexoWorks now
Regions (condition)WorldGuardWorks now
Everything elsecommand: rewardAlways available

On this page