⭐️ TheosisEconomy ⭐️ [1.7+]

❗❗❗ This plugin requires Vault to function! ❗❗❗

Overview
After struggling to find a decent, maintained, Vault-based economy provider plugin that wasn't bloated with random features that I would never use, I decided to make my own and share it. TheosisEconomy aims to be simple, yet powerful and customisable.

Just about everything in TheosisEconomy can be customised. It offers the ability to:

• Set a default balance (the balance a player will have upon first joining your server).
• Set a maximum balance.
• Specify the number of decimal places you want your currency to use.
• Specify your currency's name.
• Customise the format in which your currency will be displayed.

TheosisEconomy also features a customisable /balancetop command. This command displays a list of players from richest to poorest, as well as the combined total balance of all players. You can control:

• How often you want the list of players' balances to be sorted (sorting is done asynchronously, so it should not lag your server at all).
• The number of players that are shown per page.
• The minimum balance which players must have to show up in the list (balances below this minimum will still be added to the combined total balance).
• Whether to exclude players who are banned from your server from the list (currently supports LiteBans and vanilla bans).

As well as this, all chat messages from TheosisEconomy can be customised to your liking using the MiniMessage format!

Player Commands

• /balance | /bal | /money [player name] - Display your own or another player's balance.
• /balancetop | /baltop [page] - Display the balances of players from richest to poorest.
• /pay <player> <amount> - Pay another player a specified amount of money.
• /paytoggle - Toggle whether you want to be able to receive money from other players with /pay.

Admin Commands

• /economy | /eco - Display help regarding how to use the /economy command.
  
• /economy set <player> <amount> - Set the specified player's balance to the specified amount of money.
• /economy give <player> <amount> - Add the specified amount of money to the specified player's balance.
• /economy take <player> <amount> - Subtract the specified amount of money from the specified player's balance.
• /economy reset <player> - Set the specified player's balance to the configured default balance.
• /economy reload - Reload the plugin.

Permissions (Given By Default)

• theosiseconomy.command.balance - Access to /balance.
  
• theosiseconomy.command.balance.others - Access to /balance [player name].
• theosiseconomy.command.balancetop - Access to /balancetop.
• theosiseconomy.command.pay - Access to /pay.
• theosiseconomy.command.paytoggle - Access to /paytoggle.

Permissions (Not Given By Default)

• theosiseconomy.balancetop.exclude -
  Players with this permission will be excluded from the /balancetop list, but only if the configuration option settings.baltop.consider-exclude-permission is set to true.
• theosiseconomy.command.* - Access to all TheosisEconomy commands.
  
• theosiseconomy.command.economy.* - Access to /economy and all of its sub-commands.
  
• theosiseconomy.command.economy - Access to /economy.
  
• theosiseconomy.command.economy.set - Access to /economy set <player> <amount>.
  
• theosiseconomy.command.economy.give - Access to /economy give <player> <amount>.
  
• theosiseconomy.command.economy.take - Access to /economy take <player> <amount>.
  
• theosiseconomy.command.economy.reset - Access to /economy reset <player>.
• theosiseconomy.command.economy.reload - Access to /economy reload.

Placeholders
TheosisEconomy features the following PlaceholderAPI placeholders:

• %theosiseconomy_accepting_payments%
• %theosiseconomy_richest_<position>_name%
  
• %theosiseconomy_richest_<position>_uuid%
• %theosiseconomy_richest_<position>_balance%
  
• %theosiseconomy_richest_<position>_balance_formatted%
• %theosiseconomy_richest_<position>_entry%
• %theosiseconomy_richest_<position>_entry_legacy%
• %theosiseconomy_combined_total_balance%
• %theosiseconomy_combined_total_balance_formatted%

Other placeholders you might expect from an economy plugin, such as a specific player's balance, are already built into Vault. You can see them here: https://wiki.placeholderapi.com/users/placeholder-list/#vault.

API
TheosisEconomy features the following events that can be listened for by other plugins:

• PlayerPayPlayerEvent
• PreBaltopSortEvent

To listen for these events, you will have to add the TheosisEconomy jar to your plugin's build path.

Configuration File (config.yml)