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: 1000Nothing 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
permissioncondition works with plain Bukkit permissions, so it functions with any permissions plugin. - The
rankcondition 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 nodeSee 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" # kitsThis 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.
| Capability | Works via | Status |
|---|---|---|
| Economy (give/take, balance check) | Vault | Works now |
| Permissions (condition) | Bukkit | Works now |
| Ranks (condition) | LuckPerms | Works now |
| Placeholders | PlaceholderAPI, MiniPlaceholders | Works now |
| Custom items | ItemsAdder, Oraxen, Nexo | Works now |
| Regions (condition) | WorldGuard | Works now |
| Everything else | command: reward | Always available |