?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Total Economy

Total Economy

Total Economy is a plugin that aims to provide a full-fledged economy for your server

3.6Kdownloads
3followers
3.6Kdownloads
3followers

Compatibility

Minecraft: Java Edition

26.1.2
1.21.3–1.21.4
1.21–1.21.1
1.20–1.20.4
1.19.3–1.19.4

Platforms

Links

Report issues View source Visit wiki
Sponsor on GitHub

Tags

Creators

Details

Licensed MIT
Published 3 years ago
Updated last week

Total Economy

A modular economy plugin for Minecraft.

License: MIT Paper Vault Modrinth Downloads GitHub Stars

A large overhaul is currently in the works. The 1.0.0-alpha release 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

  1. Download the latest release from Modrinth
  2. Place the JAR file in your server's plugins/ directory
  3. Start (or restart) your server
    • This will fail on initial run; modify your config.yml to point to your database
  4. Configure plugins/TotalEconomy/config.yml to your liking
  5. 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

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.