# Economy

## Economy available

* [BeastTokens](https://www.spigotmc.org/resources/13409/) - `BeastTokens`
* [CoinsEngine](https://www.spigotmc.org/resources/84121/) - `COINSENGINE`
* [EcoBits](https://www.spigotmc.org/resources/109967/) - `ECOBITS`
* [ElementalGems](https://builtbybit.com/resources/14920/) - `ELEMENTALGEMS`
* [ElementalTokens](https://builtbybit.com/resources/16707/) - `ELEMENTALTOKENS`
* [Experience](https://www.minecraft.net) - `EXPERIENCE`
* [Item](https://www.minecraft.net) - `ITEM`
* [Level](https://www.minecraft.net) - `LEVEL`
* [PlayerPoints](https://www.spigotmc.org/resources/80745/) - `PLAYERPOINTS`
* [RedisEconomy](https://www.spigotmc.org/105965/) - `REDISECONOMY`
* [Vault](https://www.spigotmc.org/resources/34315/) - `VAULT`
* [VotingPlugin](https://www.spigotmc.org/resources/15358/) - `VOTINGPLUGIN`
* [zEssentials](https://www.spigotmc.org/resources/118014/) - `ZESSENTIALS`
* [zMenu](https://www.spigotmc.org/resources/110402/) - `ZMENUITEMS`

zAuctionHouse integrates with the CurrenciesAPI, which you can find here: [CurrenciesAPI](https://github.com/Traqueur-dev/CurrenciesAPI).

You can configure multiple economies using the `economies.yml` file. For more advanced customization, you can also use the api: [Economy API](https://zauctionhouse.groupez.dev/development-portal/custom-economy)

```yaml
#########################################################################################################################################
#
# ███████╗░█████╗░██╗░░░██╗░█████╗░████████╗██╗░█████╗░███╗░░██╗██╗░░██╗░█████╗░██╗░░░██╗░██████╗███████╗██╗░░░██╗██████╗░
# ╚════██║██╔══██╗██║░░░██║██╔══██╗╚══██╔══╝██║██╔══██╗████╗░██║██║░░██║██╔══██╗██║░░░██║██╔════╝██╔════╝██║░░░██║╚════██╗
# ░░███╔═╝███████║██║░░░██║██║░░╚═╝░░░██║░░░██║██║░░██║██╔██╗██║███████║██║░░██║██║░░░██║╚█████╗░█████╗░░╚██╗░██╔╝░█████╔╝
# ██╔══╝░░██╔══██║██║░░░██║██║░░██╗░░░██║░░░██║██║░░██║██║╚████║██╔══██║██║░░██║██║░░░██║░╚═══██╗██╔══╝░░░╚████╔╝░░╚═══██╗
# ███████╗██║░░██║╚██████╔╝╚█████╔╝░░░██║░░░██║╚█████╔╝██║░╚███║██║░░██║╚█████╔╝╚██████╔╝██████╔╝███████╗░░╚██╔╝░░██████╔╝
# ╚══════╝╚═╝░░╚═╝░╚═════╝░░╚════╝░░░░╚═╝░░░╚═╝░╚════╝░╚═╝░░╚══╝╚═╝░░╚═╝░╚════╝░░╚═════╝░╚═════╝░╚══════╝░░░╚═╝░░░╚═════╝░
#
# Documentation : https://zshop.groupez.dev/
# Sponsor : https://serveur-minecraft-vote.fr/
#
# Economy available:
# - ITEM (Use items like economy, for example gold)
# - LEVEL (Minecraft player level)
# - EXPERIENCE (Minecraft player level experience point)
# - VAULT (requires https://www.spigotmc.org/resources/vault.34315/)
# - PLAYERPOINTS (requires https://www.spigotmc.org/resources/playerpoints.80745/)
# - TOKENMANAGER (requires https://www.spigotmc.org/resources/tokenmanager.8610/)
# - COINSENGINE (requires https://www.spigotmc.org/resources/84121/)
# - OPTECO (requires https://www.spigotmc.org/resources/76179/)
# - MYSQLTOKEN (requires https://www.spigotmc.org/resources/7535/)
# - BEASTTOKEN (requires https://www.spigotmc.org/resources/20806/)
#
#########################################################################################################################################

economies: # Default Economy
  VAULT:
    name: vault # Name of the economy, the name can be specified in the items
    type: VAULT # Economy type
    currency: "%price%$" # Placeholder to display the price
    format: "v"
    isEnable: true # Activate or not the economy
    denyMessage: "&cYou don't have enough money to buy this." # Message if the player does not have the money for a purchase.
  # Economy with an item, here diamond
  ITEM1:
    name: item_diamond # Name of the economy, the name can be specified in the items
    type: ITEM # Economy type
    currency: "%price% diamond%s%" # Placeholder to display the price
    format: "id"
    isEnable: false # Activate or not the economy
    denyMessage: "&cYou don't have enough money to buy this." # Message if the player does not have the money for a purchase.
    permission: "zauctionhouse.item.diamond"
    item: # Configure the item : https://zauctionhouse.groupez.dev/inventories/items
      material: DIAMOND
  # Economy with an item, here emerald
  ITEM2:
    name: item_emerald # Name of the economy, the name can be specified in the items
    type: ITEM # Economy type
    currency: "%price% emerald%s%" # Placeholder to display the price
    format: "ie"
    isEnable: false # Activate or not the economy
    denyMessage: "&cYou d'ont have enough money to buy this." # Message if the player does not have the money for a purchase.
    permission: "zauctionhouse.item.emerald"
    item: # Configure the item : https://zauctionhouse.groupez.dev/inventories/items
      material: EMERALD
  # Minecraft player level experience point
  EXPERIENCE:
    name: experience # Name of the economy, the name can be specified in the items
    type: EXPERIENCE # Economy type
    currency: "%price% xp"
    format: "xp" # Placeholder to display the price
    isEnable: false # Activate or not the economy
    denyMessage: "&cYou dont' have enough experience to buy this." # Message if the player does not have the money for a purchase.
  # Minecraft player level
  LEVEL:
    name: level # Name of the economy, the name can be specified in the items
    type: LEVEL # Economy type
    currency: "%price% level"
    format: "level" # Placeholder to display the price
    isEnable: false # Activate or not the economy
    denyMessage: "&cYou don't have enough level to buy this." # Message if the player does not have the money for a purchase.
  playerpoints:
    name: playerpoints # Name of the economy, the name can be specified in the items
    type: playerpoints # Economy type
    currency: "%price% P" # Placeholder to display the price
    format: "P"
    isEnable: false # Activate or not the economy
    denyMessage: "&cYou don't have enough points to buy this." # Message if the player does not have the money for a purchase.
  # coinsEngine:
  #  name: coinsengine # Name of the economy, the name can be specified in the items
  #  type: coinsengine # Economy type
  #  currency: "%price% c"
  #  format: "C" # Placeholder to display the price
  #  isEnable: true # Activate or not the economy
  #  currencyName: "coins" # Coins engine currency name
  #  denyMessage: "&cYou don't have enough points to buy this." # Message if the player does not have the money for a purchase.
```