Skip to content

Economy Bridge

CoreLib provides a shared economy bridge so business modules can use similar configuration for costs, rewards, and formulas.

Common fields

FieldMeaning
enabledEnable economy logic.
providerEconomy provider: auto, vault, or excellenteconomy.
currencyCurrency ID. Leave blank for the Vault default currency.
base_costBase cost.
cost_formulaDynamic cost formula.
currenciesMulti-currency list.

Providers

Provider IDPluginNotes
vaultVaultWorks with any Vault-compatible economy plugin.
excellenteconomyExcellentEconomySupports multiple currencies.

Automatic provider selection

When provider is blank or auto:

ConditionResult
currency is not blankPrefers ExcellentEconomy.
currency is blankUses Vault with its default currency.
An explicit provider is givenLooked up by ID; fails when unavailable.

ExcellentEconomy always requires a non-blank currency, and auto never infers a default ExcellentEconomy currency — set currency explicitly.

Economy actions

Action IDParameters
givemoneyrequired amount; provider=auto; currency=""
takemoneyrequired amount; provider=auto; currency=""
setmoneyrequired amount; provider=auto; currency=""
yaml
actions:
  - 'givemoney amount=100 provider=vault'
  - 'takemoney amount=25.5 provider=excellenteconomy currency=gems'

Check Vault or ExcellentEconomy loading if economy actions do not work.