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.yml to 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.