Economy
Currencies, player balances, payments between players and money leaderboards, shared by your whole network.
The Economy module gives your server its own money. You can run one currency or several (for example coins and gems), let players pay each other, and follow every operation from the web editor. Other InglisCore modules such as the shop, kits, daily rewards and the auction house use it to charge and pay players.
Features
- Several currencies, each with its own name, symbol, number of decimals and starting balance.
- Payments between players with
/pay, with a minimum amount and a delay between payments. You choose which currencies can be sent. - Leaderboard with
/baltop, page by page, for any currency. - Vault support: if Vault is installed, the currency marked "Vault" becomes the server money for every other plugin that uses Vault (shops, jobs, chat plugins and so on).
- Network wide: balances are shared by all the servers of your network. A player paid on one server is notified on the server they are playing on.
- Full history: every change of balance is logged with its reason (payment, purchase, kit, reward, staff change and so on).
- Friendly amounts: players and staff can type
1500,1 500,12,5,2k,1.5mor1b.
Setting it up
Open the Economy module in the web editor.
Economy tab
This tab is an overview of your economy:
- One tile per currency with the total money in circulation and the number of accounts.
- Leaderboard: the 10 richest players of the selected currency.
- History: every operation on every balance, with a search by player name and a filter by currency.
To change the balance of one player, open their profile in Players, then the Economy tab. You see their balances and their last operations, and Change balance lets you Add, Remove or Set an amount, with an optional reason.
Settings tab
Currencies is a table with one row per currency:
| Column | What it does | Default |
|---|---|---|
| ID | Short name used in commands, for example /pay Steve 10 gems. Lowercase letters, digits and _. |
coins, gems |
| Name | Name shown to players. | Coins, Gems |
| Symbol | Shown after amounts. | ⛃, ✦ |
| Decimals | 0, 1 or 2 digits after the decimal point. | 2 for coins, 0 for gems |
| Starting balance | What every player gets the first time they join. | 100 coins, 0 gems |
| Vault | The currency other plugins see through Vault. It is also the main currency of InglisCore: when a module has no currency set, it uses this one. | On for coins |
| Sendable | Whether players can send this currency with /pay. |
On for coins, off for gems |
If no currency is marked Vault, the first one of the table is the main currency.
Payments
| Setting | What it does | Default |
|---|---|---|
| Minimum amount | Smallest amount a player can send with /pay. |
1 |
| Delay between payments | Time a player waits between two payments. | 2s |
Leaderboard
| Setting | What it does | Default |
|---|---|---|
| Players per page | Number of players on each page of /baltop (3 to 50). |
10 |
Commands
| Command | What it does | Permission |
|---|---|---|
/balance [currency] |
Shows your balance in every currency, or only the one you name. Aliases: /bal, /money. |
inglis.economy.balance (everyone) |
/balance <player> [currency] |
Shows the balance of another player, online or not. | inglis.economy.balance.others |
/pay <player> <amount> [currency] |
Sends money to another player, online or not. Without a currency, the main currency is used. | inglis.economy.pay (everyone) |
/baltop [currency] [page] |
Richest players. Aliases: /moneytop, /topmoney. |
inglis.economy.baltop (everyone) |
/eco give <player> <amount> [currency] |
Adds money to a player. Alias: /economy. |
inglis.economy.admin (operators) |
/eco take <player> <amount> [currency] |
Removes money from a player. Refused if they do not have enough. | inglis.economy.admin (operators) |
/eco set <player> <amount> [currency] |
Sets the exact balance of a player. | inglis.economy.admin (operators) |
/eco reset <player> [currency] |
Puts a player back to the starting balance. | inglis.economy.admin (operators) |
inglis.economy.balance.others is not given to anyone by default except operators: grant it to your staff ranks.
Placeholders
These work with PlaceholderAPI and anywhere InglisCore accepts placeholders. Replace <id> with the ID of a currency, for example %ingliscore_balance_gems%.
| Placeholder | Shows |
|---|---|
%ingliscore_balance% |
Balance in the main currency, as a plain number (1234.5). |
%ingliscore_balance_formatted% |
Balance in the main currency with separators and symbol (1,234.50 ⛃). |
%ingliscore_balance_number% |
Balance in the main currency with separators, without symbol. |
%ingliscore_balance_<id>% |
Balance in this currency, as a plain number. |
%ingliscore_balance_<id>_formatted% |
Balance in this currency with separators and symbol. |
%ingliscore_balance_<id>_number% |
Balance in this currency with separators, without symbol. |
Formatted amounts follow the language of the player.
Tips
- Pick the ID of a currency once and keep it: balances are attached to the ID, so renaming the ID starts that currency from zero. You can change the name and symbol at any time.
- Use a non sendable currency (like the default gems) for rewards you do not want players to trade.
- Coming from another economy plugin? You can bring the balances over with a migration.