Total Economy
A modular economy plugin for Minecraft.
Overview
Total Economy is a Minecraft plugin that provides a full-fledged economy for your server. Rather than packing every feature into a single plugin with toggles, Total Economy takes a modular approach: a lightweight core handles the essentials, and additional features are added as separate plugins that hook into the core API. Install only what your server needs, and skip what it doesn't.
Features
- Multi-Currency Support - Define multiple currencies with configurable starting balances
- Player Accounts - Automatic player account creation for each currency
- Money Transfers - Send and receive payments between players in any currency
- Extensible API - Build custom add-on plugins that extend core functionality
- Vault Integration - Full Vault API implementation for compatibility with many plugins
Planned Add-Ons
Additional features are being developed as separate plugins that extend the core Total Economy plugin:
| Add-On | Status | Description |
|---|---|---|
| Jobs | In-development | Assign roles to players with configurable rewards for in-game actions |
| Shops | Planned | Buy and sell items through player-run or server-controlled shops |
| Web UI | Planned | Browser-based dashboard for managing data and viewing analytics |
Installation
- Download the latest release from Modrinth
- Place the JAR file in your server's
plugins/directory - Start (or restart) your server
- This will fail on initial run; modify your config.yml to point to your database
- Configure
plugins/TotalEconomy/config.ymlto your liking - Restart to apply changes
Minimum Requirements
These are the current versions that the latest release was tested against. Older/Newer versions may still work.
| Requirement | Version |
|---|---|
| Minecraft | 26.1.2 |
| Java | 25+ |
| Server | Paper 26.1.2 |
| MySQL | 8.0+ |
Documentation
- Documentation - Guides and configuration reference
- Issues - Bug reports and feature requests
- Discussions - Questions, ideas, and community talk
Contributing
Contributions are welcome! Fork the repo, create a feature branch, and open a pull request. If you're planning a larger change, consider starting a discussion first so we can align on direction.
All Versions
+ Add Version- This update completely changes the structure of the database storage in order to better prep for future updates. Therefore, this version is no longer compatiable with previous versions (<1.0.0-alpha) of Total Economy.**
# Added
- Accounts for each currency are now created when a player joins
- Balance command now provides suggested currency codes
getSupportedCurrenciesadded to the API- Default currency and supported currencies are now cached on plugin start, reducing database round trips
- A command will be added in the future to reload this cache. Currently reloading requires restarting the server.
# Updated
- Support for Minecraft 26.2
# Fixed
- Empty currency symbols now properly default to the singular/plural name on format
- This update completely changes the structure of the database storage in order to better prep for future updates. Therefore, this version is no longer compatiable with previous versions (<1.0.0-alpha) of Total Economy.**
## Added
- Configuration for default currency
- VaultAPI implementation added, allowing for plugins that depend on Vault to interact with TotalEconomy
- Additional Total Economy API functionality and registration to allow for plugins to interact with TotalEconomy
- This update completely changes the structure of the database storage in order to better prep for future updates. Therefore, this version is no longer compatiable with previous versions of Total Economy.**
This is the first step towards the full 1.0.0 release. With it being an **Alpha** release, there are things that are missing that were originally available in the previous releases (such as jobs and Vault support). These will be added back to better align with the new structure of Total Economy. For the time being, this release supports the following:
- Multi-currency support
- Default currency is currently hardcoded to always be USD, though this will change in future alpha releases
- Balance command (multi-currency supported)
- /balance [CURRENCY_CODE]
- Pay command (multi-currency supported)
- /pay PLAYER_NAME AMOUNT [CURRENCY_CODE]
- A very early version of the Total Economy API to allow extending it with additional functionality
- [Change]** Pay command is now standard between Bukkit and Sponge
- No changes to how the command works
- [Added]** Pay command (/pay PLAYER AMOUNT)
- [CHANGE]** Vault API implemenation updated to use a more standardized set of code
- [CHANGE]** Sponge Economy API implemenation updated to use a more standardized set of code
# Important Note for Users of the Older Sponge Versions
This is a complete rewrite of the Sponge version of Total Economy. If you were using the old Sponge version you will need to start fresh. Please read the docs [here](https://ericgrandt.github.io/TotalEconomy/installation.html) for install instructions.
- [Added]** Database script ([schema.sql](https://github.com/ericgrandt/TotalEconomy/blob/master/src/main/resources/schema.sql)) is now automatically executed on server start. With this addition, you no longer need to manually execute the SQL.
- [Added] Farmer job and place action
NOTE: Be sure to execute the SQL in [schema.sql](https://github.com/ericgrandt/TotalEconomy/blob/master/src/main/resources/schema.sql) before launching the server. The entire file can be run, and existing tables and such will be ignored if they already exist.