Total Economy
A modular economy plugin for Minecraft.
A large overhaul is currently in the works. The
1.0.0-alpharelease is the first release in a complete rewrite with a temporary slimmed-down feature set. Additional modules (jobs, shops, achievements, web UI, and more) will be released as separate add-on plugins that extend Total Economy.
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 (currently only creates the default currency account)
- 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 | Planned | Assign roles to players with configurable rewards for in-game actions |
| Shops | Planned | Buy and sell items through player-run or server-controlled shops |
| Achievements | Planned | Economy-linked achievement tracking with milestone rewards |
| 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+ |
Building from Source
Requirements: Java 25+, Gradle 9+
git clone https://github.com/ericgrandt/TotalEconomy.git
cd TotalEconomy
./gradlew :totaleconomy-paper:shadowJar
The built JAR will be in totaleconomy-paper/build/libs/TotalEconomyPaper-{version}.jar.
Project Structure
TotalEconomy/
├── totaleconomy-api/ # Public API for add-on plugins
├── totaleconomy-core/ # Shared economy logic and data layer
├── totaleconomy-paper/ # Paper platform implementation
└── docs/ # Documentation site (Jekyll)
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.
