EmeraldBank - A Simple Emerald Economy Plugin

A simple and lightweight economics plugin using Emerald. All messages and configurations are customizable in config.yml.

Dependencies

• Paper
• Vault

Optional Dependencies

• OpenInv

MC Version Policy

EmeraldBank basically supports latest version of Minecraft. However, we will support the previous version for a while. We will not support the version that is no longer supported by PaperMC. The following table shows the support status of each version.

Version	Support
1.21.8	✅ Active support
1.21.6 ~ 1.21.7	✅ Active support
1.21 ~ 1.21.5	🔁 May work, but not supported
< 1.20.X	🚧 No longer supported

Commands

• /bank Alias of /emeraldbank bank
• /balance Alias of /emeraldbank balance
• /pay Alias of /emeraldbank pay
• /wallet Alias of /emeraldbank wallet
• /em Alias of /emeraldbank
• /embank Alias of /emeraldbank
• /emeraldbank balance Show your balance that count of emeralds you have.
• /emeraldbank balance <player> Show other player's balance.
• /emeraldbank leaderboard Show all player's balance in leaderboard.
• /emeraldbank pay <player> <count> Pay emeralds to other player.
• /emeraldbank reload Reload config and messages
• /emeraldbank wallet add <count> Add emeralds to your wallet.
• /emeraldbank wallet add all Add all emeralds to your wallet.
• /emeraldbank wallet withdraw <count> Withdraw emeralds from your wallet.
• /emeraldbank wallet balance Show your wallet balance.
• /emeraldbank bank account create <name> Create a new bank account.
• /emeraldbank bank account delete <bank> Close the specified bank account.
• /emeraldbank bank account add <bank> <player> Add a member that can access the bank account.
• /emeraldbank bank account remove <bank> <player> Remove a member from the bank account.
• /emeraldbank bank account addowner <bank> <player> Add an owner that can manage the bank account.
• /emeraldbank bank account removeowner <bank> <player> Remove an owner from the bank account.
• /emeraldbank bank account list Show all bank accounts.
• /emeraldbank bank account list <bank> Show all members of bank.
• /emeraldbank bank balance <bank> Show bank balance.
• /emeraldbank bank deposit <bank> <count> Deposit to the bank account.
• /emeraldbank bank withdraw <bank> <count> Withdraw to the bank account.
• /emeraldbank bank send <bank> <target> <count> Transfer emeralds to other bank account.
• /emeraldbank bank pay <bank> <player> <count> Pay emeralds to specified player.

Permissions

• emeraldbank.admin
  • emeraldbank.balance.all
  • emeraldbank.reload
  • emeraldbank.currency.rate.set
• emeraldbank.bypass
  • emeraldbank.bypass.cost
  • emeraldbank.bypass.deposit
  • emeraldbank.bypass.member
  • emeraldbank.bypass.owner
• emeraldbank.default
  • emeraldbank.balance
  • emeraldbank.pay
  • emeraldbank.leaderboard
  • emeraldbank.banking
• emeraldbank.banking
  • emeraldbank.banking.balance
  • emeraldbank.banking.deposit
  • emeraldbank.banking.withdraw
  • emeraldbank.banking.send
  • emeraldbank.banking.pay
  • emeraldbank.banking.account
• emeraldbank.banking.account
  • emeraldbank.banking.account.create
  • emeraldbank.banking.account.delete
  • emeraldbank.banking.account.add
  • emeraldbank.banking.account.remove
  • emeraldbank.banking.account.list
  • emeraldbank.banking.account.transfer
• emeraldbank.currency
  • emeraldbank.currency.rate
  • emeraldbank.currency.exchange
  • emeraldbank.currency.exchange.<currency>
  • emeraldbank.currency.exchange.*
• emeraldbank.currency.rate
  • emeraldbank.currency.rate.get

Placeholders

• %emeraldbank_balance%
• %emeraldbank_balance_<player>%
• %emeraldbank_wallet%
• %emeraldbank_wallet_<player>%
• %emeraldbank_bank_balance_<bank>%
• %emeraldbank_bank_owner_<bank>%
• %emeraldbank_bank_members_<bank>%
• %emeraldbank_bank_list%

Configuration

#  ______                          _     _ ____              _    
# |  ____|                        | |   | |  _ \            | |   
# | |__   _ __ ___   ___ _ __ __ _| | __| | |_) | __ _ _ __ | | __
# |  __| | '_ ` _ \ / _ | '__/ _` | |/ _` |  _ < / _` | '_ \| |/ /
# | |____| | | | | |  __| | | (_| | | (_| | |_) | (_| | | | |   < 
# |______|_| |_| |_|\___|_|  \__,_|_|\__,_|____/ \__,_|_| |_|_|\_\
#                                                                 
#                                                                 

# DO NOT CHANGE THIS VALUE!
config_version: 1

# The cost for paying a player.
pay-cost: disabled

#################################################################
##                                                              #
##  Banking                                                     #
##                                                              #
#################################################################
banking:
  # Enable or disable banking.
  enabled: true
  tax:
    # The cost for creating a bank.
    create-cost: disabled

    # The cost for creating a bank.
    add-member-cost: disabled

    # The cost for removing a member from a bank.
    transfer-bank-cost: disabled

    # The cost for sending from a bank to another bank.
    deposit-cost: disabled

    # The cost for withdrawing from a bank.
    withdraw-cost: disabled

    # The cost for paying from a bank to a player.
    pay-cost: disabled

# The default destination for payments.
# INVENTORY: The player's inventory.
# WALLET: The player's wallet.
default-destination: INVENTORY

# Load offline players' inventories.
# This setting requires OpenInv (https://github.com/Jikoo/OpenInv).
# Change of this setting will require a restart of the server.
load-offline-players-inventories: false

# Enable or disable the exchange feature.

# WARNING: This setting is experimental feature.
# This setting may change in the future.
exchange-enabled: false

#################################################################
##                                                              #
##  Currencies                                                  #
##                                                              #
#################################################################

# The currencies used in the plugin.

# WARNING: Changing this setting is experimental feature.
# This setting may change in the future.
# You should not change this setting unless you know what you are doing.
currencies:
  emerald:
    # The name of the currency.
    name: Emerald

    # The plural name of the currency.
    name-plural: Emeralds

    # Use this currency as the default currency.
    default-currency: true

    # The rate of the currency.
    rate: 1.0

    # The item type of the currency.
    item-type: emerald

    # The children item type and rate of the currency.
    children:
      emerald_block: 9

    # The cost for exchanging.
    cost: disabled

#################################################################
##                                                              #
##  Database                                                    #
##                                                              #
#################################################################
database:
  # The type of database to use.
  # Change of database type will require a restart of the server.
  # H2: H2 Database
  # MYSQL: MySQL Database
  type: H2

  # The host of the database.
  host: localhost

  # The port of the database.
  port: 3306

  # The name of the database.
  database: emeraldbank

  # The username of the database.
  username: root

  # The password of the database.
  password: password

#################################################################
##                                                              #
##  Messages                                                    #
##                                                              #
#################################################################
messages:
  name: EmeraldBank
  reload: <green>Reloaded configuration and messages
  economy-format: <value> <green><currency></green>
  balance: '<green><player>''s Balance: <value> (Wallet: <wallet>)'
  balance-bank: '<green><bank>''s Balance: <value>'
  leaderboard: '<player>: <balance>'
  rate-value: 'rate: <value>'
  rate-value-of-currency: '<green>Rate of <currency>: <value>'
  set-rate: <green>Set rate of <currency> to <value>
  exchange-rate: '<green>Exchange rate: 1 <currency> = <value> <target>'
  exchange-cost: '<green>Exchange cost: <cost> <currency>'
  exchange-receive: '<green>Estimated exchange amount: <value> <currency>'
  exchange-start: <green>Exchanging <value> <currency> to <target>
  pay-success: <green>Successfully paid <value> to <player>
  error-pay: <red>Failed to pay <value> to <player>
  error-pay-self: <red>You cannot pay yourself!
  banking-create: <green>Created bank <bank>
  banking-delete: <green>Deleted bank <bank>
  banking-deposit: <green>Deposited <value> to <bank>
  banking-withdraw: <green>Withdrew <value> from <bank>
  banking-add-member: <green>Added <player> to bank <bank>
  banking-remove-member: <green>Removed <player> from bank <bank>
  banking-list: '<green>Banks: <banks>'
  banking-members: '<green>Members of <bank>: <members>'
  banking-add-owner: <green>Added <player> as owner of bank <bank>!
  banking-remove-owner: <green>Removed <player> as owner of bank <bank>!
  banking-send: <green>Sent <value> from <bank_from> to <bank_to>
  banking-pay: <green>Paid <value> from bank <bank> to <player>
  offline-transaction: <green><value> has been moved to your balance while you were offline!
  wallet: '<green><player>''s Wallet: <value>'
  add-wallet: <green>Added <value> to <player>'s wallet!
  withdraw-wallet: <green>Withdrew <value> from <player>'s wallet!
  received: <green>Received <value> from <source>
  receive-bank: <green>Received <value> to bank <destination> from <source>
  error-banking-disabled: <red>Banking is disabled!
  error-banking-create: <red>Failed to create bank <bank>!
  error-banking-delete: <red>Failed to delete bank <bank>!
  error-banking-exists: <red>Bank <bank> already exists!
  error-banking-no-bank: <red>Bank <bank> does not exist!
  error-banking-deposit: <red>Failed to deposit <value> to <bank>
  error-banking-withdraw: <red>Failed to withdraw <value> from <bank>
  error-banking-not-owner: <red><player> is not the owner of bank <bank>!
  error-banking-not-member: <red><player> is not a member of bank <bank>!
  error-banking-member-exists: <red><player> is already a member of bank <bank>!
  error-banking-add-member: <red>Failed to add <player> to bank <bank>!
  error-banking-remove-member: <red>Failed to remove <player> from bank <bank>!
  error-banking-delete-remaining: <red>Bank <bank> has a remaining balance of <value>!
  error-banking-send: <red>Failed to send <value> from bank <bank_from> to bank <bank_to>!
  error-banking-pay: <red>Failed to pay <value> from bank <bank> to <player>!
  error-banking-remove-owner: <red><player> is the owner of bank <bank>!
  error-banking-create-cost: <red>Failed to create bank due to insufficient funds <cost>!
  error-banking-add-member-cost: <red>Failed to add member <player> to bank <bank> due to insufficient funds <cost>!
  error-banking-transfer-cost: <red>Failed to transfer bank <bank> to <player> due to insufficient funds <cost>!
  error-banking-deposit-cost: <red>Failed to deposit <value> to bank <bank> due to insufficient funds <cost>!
  error-banking-withdraw-cost: <red>Failed to withdraw <value> from bank <bank> due to insufficient funds <cost>!
  error-banking-pay-cost: <red>Failed to pay <value> from bank <bank> to <player> due to insufficient funds <cost>!
  error-pay-cost: <red>Failed to pay <value> to <player> due to insufficient funds <cost>!
  error-add-wallet: <red>Failed to add <value> to <player>'s wallet!
  error-withdraw-wallet: <red>Failed to withdraw <value> from <player>'s wallet!
  error-reload: <red>Failed to reload configuration and messages!
  error-banking-remove-last-owner: <red>Failed to remove <player> as owner of bank <bank>!
  error-banking-remove-last-member: <red>Failed to remove <player> as member of bank <bank>!
  error-player-not-found: <red>Player <player> not found!
  error-same-currency: <red>You cannot exchange the same currency <currency>!
  error-currency-not-found: <red>Currency not found!
  error-not-enough-currency: <red>You do not have <value> of <currency> to pay!
  error-no-permission: <red>You do not have permission to do this!
  error-exchange-too-low: <red>Exchange amount is too low!