Skip to main content

Economies Configuration

The economies.yml file defines all available economy types that can be used in your shop.

Economy Structure​

Each economy follows this structure:

economies:
  ECONOMY_ID:
    name: economy_name      # Internal name (used in item configs)
    type: ECONOMY_TYPE      # Economy type
    currency: "%price%$"    # Display format
    is-enable: true         # Enable/disable
    deny-message: "..."     # Message when insufficient funds

Built-in Economy Types​

Vault​

Standard Vault economy integration:

economies:
  VAULT:
    name: vault
    type: VAULT
    currency: "%price%$"
    is-enable: true
    deny-message: "&cYou don't have enough money to buy this."

Item Economy​

Use items as currency (e.g., diamonds, emeralds):

economies:
  ITEM_DIAMOND:
    name: item_diamond
    type: ITEM
    currency: "%price% diamond%s%"
    is-enable: true
    deny-message: "&cYou don't have enough diamonds to buy this."
    item:
      material: DIAMOND

  ITEM_EMERALD:
    name: item_emerald
    type: ITEM
    currency: "%price% emerald%s%"
    is-enable: true
    deny-message: "&cYou don't have enough emeralds to buy this."
    item:
      material: EMERALD

The %s% placeholder adds "s" for plural (e.g., "1 diamond", "5 diamonds").

Custom Items

You can use any item configuration supported by zMenu, including custom model data, NBT, etc.

Experience​

Use Minecraft XP points:

economies:
  EXPERIENCE:
    name: experience
    type: EXPERIENCE
    currency: "%price% XP"
    is-enable: true
    deny-message: "&cYou don't have enough experience to buy this."

Level​

Use Minecraft player levels:

economies:
  LEVEL:
    name: level
    type: LEVEL
    currency: "%price% levels"
    is-enable: true
    deny-message: "&cYou don't have enough levels to buy this."

PlayerPoints​

Integration with PlayerPoints plugin:

economies:
  PLAYERPOINTS:
    name: playerpoints
    type: PLAYERPOINTS
    currency: "%price% points"
    is-enable: true
    deny-message: "&cYou don't have enough points to buy this."

CoinsEngine​

Integration with CoinsEngine plugin:

economies:
  COINSENGINE:
    name: coinsengine
    type: COINSENGINE
    currency: "%price% coins"
    is-enable: true
    currency-name: "coins"  # CoinsEngine currency name
    deny-message: "&cYou don't have enough coins to buy this."

ExcellentEconomy​

Integration with ExcellentEconomy plugin (multi-currency support):

economies:
  EXCELLENTECONOMY:
    name: excellenteconomy
    type: EXCELLENTECONOMY
    currency: "%price% coins"
    is-enable: true
    currency-name: "coins"  # ExcellentEconomy currency name
    deny-message: "&cYou don't have enough coins to buy this."

TokenManager​

Integration with TokenManager plugin:

economies:
  TOKENMANAGER:
    name: tokenmanager
    type: TOKENMANAGER
    currency: "%price% tokens"
    is-enable: true
    deny-message: "&cYou don't have enough tokens to buy this."

VotingPlugin​

Integration with VotingPlugin:

economies:
  VOTINGPLUGIN:
    name: votingplugin
    type: VOTINGPLUGIN
    currency: "%price% vote points"
    is-enable: true
    deny-message: "&cYou don't have enough vote points to buy this."

BeastToken​

Integration with BeastToken plugin:

economies:
  BEASTTOKEN:
    name: beasttoken
    type: BEASTTOKEN
    currency: "%price% tokens"
    is-enable: true
    deny-message: "&cYou don't have enough tokens to buy this."

Using Economies in Items​

Specify economy per item in your shop configuration:

items:
  diamond:
    type: ZSHOP_ITEM
    item:
      material: DIAMOND
    buyPrice: 100.0
    sellPrice: 50.0
    economy: vault  # Uses vault economy

  special_sword:
    type: ZSHOP_ITEM
    item:
      material: DIAMOND_SWORD
    buyPrice: 10.0
    sellPrice: 5.0
    economy: item_diamond  # Uses diamond items as currency

If economy is not specified, the defaultEconomy from config.yml is used.

Complete Example​

economies:
  # Main server currency (Vault)
  VAULT:
    name: vault
    type: VAULT
    currency: "$%price%"
    is-enable: true
    deny-message: "&cYou need $%price% to purchase this item."

  # Diamond currency for special items
  DIAMONDS:
    name: diamonds
    type: ITEM
    currency: "%price% &b&l\u2666"  # Diamond symbol
    is-enable: true
    deny-message: "&cYou need %price% diamonds to purchase this."
    item:
      material: DIAMOND

  # Emerald currency for villager trades
  EMERALDS:
    name: emeralds
    type: ITEM
    currency: "%price% emerald%s%"
    is-enable: true
    deny-message: "&cYou need %price% emeralds to purchase this."
    item:
      material: EMERALD

  # Nether Star for legendary items
  STARS:
    name: nether_stars
    type: ITEM
    currency: "%price% Nether Star%s%"
    is-enable: true
    deny-message: "&cYou need %price% Nether Stars to purchase this."
    item:
      material: NETHER_STAR

  # XP economy for enchantments
  XP:
    name: xp
    type: EXPERIENCE
    currency: "%price% XP"
    is-enable: true
    deny-message: "&cYou need %price% XP to purchase this."

  # Level economy for skills
  LEVELS:
    name: levels
    type: LEVEL
    currency: "%price% level%s%"
    is-enable: true
    deny-message: "&cYou need to be level %price% to purchase this."

  # Vote points for vote rewards
  VOTES:
    name: votes
    type: VOTINGPLUGIN
    currency: "%price% vote point%s%"
    is-enable: true
    deny-message: "&cYou need %price% vote points to purchase this."

  # Premium tokens
  TOKENS:
    name: tokens
    type: TOKENMANAGER
    currency: "%price% token%s%"
    is-enable: true
    deny-message: "&cYou need %price% tokens to purchase this."

Currency Placeholder​

The currency field supports:

  • %price% - The numeric price
  • %s% - Adds "s" if price > 1 (for pluralization)
  • Color codes (&6, &#FF5500)
  • Unicode characters

Examples:

currency: "$%price%"           # $100
currency: "%price% coins"      # 100 coins
currency: "%price% diamond%s%" # 1 diamond, 5 diamonds
currency: "&6%price%&e gold"   # Colored text

Custom Item Economy​

For advanced item currencies with custom properties:

economies:
  CUSTOM_COIN:
    name: custom_coin
    type: ITEM
    currency: "%price% &6Gold Coin%s%"
    is-enable: true
    deny-message: "&cYou need %price% Gold Coins to purchase this."
    item:
      material: GOLD_NUGGET
      name: "&6Gold Coin"
      lore:
        - "&7A valuable currency"
      model-id: 1001  # Custom model data
      glow: true

The item configuration follows zMenu item format.

Copyright © 2026 GroupeZ|Build #loading...|-