How do I install ImperialEco?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Spigot — not every file is mirrored on our own servers.

What Minecraft version does ImperialEco work with?

The listing gives Minecraft 1.20.6, 1.21. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›ImperialEco

ModsJava

ImperialEco

⬇ Download on Spigot

Open in MC Java Mods Get it on Google Play →

ImperialEco - Economy Plugin

A Comprehensive Economy System for Spigot/Paper
[IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Description

ImperialEco is a professional-grade economy plugin designed for Spigot/Paper servers. It provides a complete economic system with Vault integration, player-to-player transactions, admin management tools, and built-in data integrity checking.

Key Highlights:

Full Vault API Integration
Advanced RepCoin System (Data Integrity)
Kommerbetrag Technology (Invisible Buffer System)
Player-to-Player Transactions
Admin Economy Management
Tab-Completion for Commands
Inter-Plugin Communication (ImperialBeacon)
Fully Customizable Configuration
YAML-based Data Persistence

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Features

Player Commands

/money [player] (Alias: /balance, /bal)

Code (Text):

/money
/money OtherPlayer

Check your own balance or another player's balance

Shows balance without comma amounts (invisible buffer)
Permission: imperialeco.balance (default: all players)
Others: imperialeco.balance.others (default: ops)

/pay <player> <amount> (Alias: /send, /transfer)

Code (Text):

/pay OtherPlayer 500
/pay PlayerName 100

Send money to another player

Only whole numbers allowed (no decimal places)
Configurable transaction tax
Cooldown system available
Permission: imperialeco.pay (default: all players)

Admin Commands

All admin commands use /eco or /economyadmin and require imperialeco.admin permission:

/eco set <player> <amount>

Code (Text):

/eco set Player123 1000
/eco set OtherPlayer 5000

Set a player's balance to a specific amount

Amount is automatically normalized with Kommerbetrag (0.9)
Only whole numbers accepted
Example: /eco set Player123 1000 - Balance: 1000.90 (internally)

/eco add <player> <amount>

Code (Text):

/eco add Player123 500

Add money to a player's balance

/eco remove <player> <amount>

Code (Text):

/eco remove Player123 100

Remove money from a player's balance

/eco reset <player>

Code (Text):

/eco reset Player123

Reset a player's balance to starting amount

Automatically adds Kommerbetrag

/eco top [limit]

Code (Text):

/eco top
/eco top 20

Show the richest players (default: top 10)

/eco check <player>

Code (Text):

/eco check Player123

Check data integrity (RepCoin System)

Displays Balance and RepCoin values
Shows consistency status
Useful for debugging

/eco reload

Code (Text):

/eco reload

Reload configuration file

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Features

RepCoin System

A sophisticated parity-bit system that ensures data integrity:

Every player has a hidden RepCoin that mirrors their balance
Automatically synchronized with all balance changes
Detects data corruption or manual file editing
Admins can verify consistency with /eco check
Completely invisible to players

Kommerbetrag Technology

An invisible buffer system (0.9 per player):

Solves the "withdraw full balance" problem
Completely hidden from players in balance displays
Automatically added to new player balances
Used internally for transaction verification
Example: Player sees 500, internal balance is 500.9

ImperialBeacon

Inter-plugin communication system:

Allows other Imperial ecosystem plugins to detect ImperialEco
Provides plugin version information
Enables future scalability for Imperial plugins

Vault Integration

Full Vault API support
Can act as primary economy provider or hook into existing
Auto-detection of other economy plugins
Works with LiteBans, Essentials, PermissionsEx, etc.

Tab-Completion

Full tab-completion for admin commands
Player name suggestions
Subcommand auto-completion
Amount suggestions for quick setup

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration

The plugin generates a config.yml file automatically. Key settings:

Code (YAML):

economy:
enabled : true
starting-balance : 1000.0
max-balance : 999999999.0
kommerbetrag : 0.9

pay-command:
enabled : true
min-amount : 0.01
max-amount : 100000.0
transaction-tax : 0.0
cooldown-seconds : 0

vault:
enabled : true
register-provider : true

All settings are fully customizable - adjust them to your server's needs!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

Requirements:

Spigot/Paper 1.21.1+
Java 17 or higher
Vault plugin (recommended but optional)

Installation Steps:

Download ImperialEco-1.2.8.jar
Place it in your plugins/ folder
Start/restart your server
The plugin will auto-generate config.yml
Customize the config as needed
Restart the server again

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

Code (Text):

imperialeco.balance - Use /money command (default: all)
imperialeco.balance.others - Check other players' balance (default: ops)
imperialeco.pay - Use /pay command (default: all)
imperialeco.admin - Use admin commands (default: ops)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Developer API

Access ImperialEco from other plugins:

Code (Java):

import org.imperialeco.api.ImperialEcoAPI ;

// Check if ImperialEco is available
if (ImperialEcoAPI. isAvailable ( ) ) {
ImperialEcoAPI api = ImperialEcoAPI. getInstance ( ) ;

// Get balance
double balance = api. getBalance (player ) ;

// Set balance
api. setBalance (player, 1000.0 ) ;

// Add/Remove money
api. addBalance (player, 100.0 ) ;
api. removeBalance (player, 50.0 ) ;

// Transfer between players
api. transfer (player1, player2, 500.0 ) ;

// Format currency
String formatted = api. formatMoney ( 1000.0 ) ;
}

For detailed API documentation, see API-README.md included with the plugin

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FAQ

Q: Can players see the Kommerbetrag?
A: No! It's completely invisible. Players only see their actual balance.

Q: What if I don't want to use Vault?
A: You don't have to! Just disable it in config.yml. ImperialEco works standalone.

Q: Can I change the starting balance?
A: Yes! Edit economy.starting-balance in config.yml.

Q: How do I add transaction tax?
A: Set pay-command.transaction-tax to a percentage (e.g., 5.0 for 5%)

Q: What is RepCoin?
A: It's a hidden parity system that verifies data integrity. Admins can check it with /eco check.

Q: Can I use this with other economy plugins?
A: Yes! ImperialEco can hook into existing Vault providers or work standalone.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support & Issues

For issues, feature requests, or support:

Check the documentation files included with the plugin
Review the config.yml comments for configuration help
Enable debug mode in config.yml for detailed logging
Use /eco check to verify data integrity

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Specifications

Language: Java 17
Framework: Spigot/Paper 1.21.1+
Build System: Gradle
Dependency Management: Vault API 1.7
Data Storage: YAML (playerdata.yml)
Threading: Fully synchronized
Performance: Optimized for 100+ concurrent players

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Example Usage

Scenario 1: New Player Joins

Server automatically gives them 1000 Credits (+ 0.9 hidden Kommerbetrag)
Player sees: /money - $1000.00
Player can transfer: /pay OtherPlayer 500

Scenario 2: Admin Sets Balance

Admin runs: /eco set Player123 5000
Internally stored: 5000.9
Player sees: /money - $5000.00
Admin can verify: /eco check Player123

Scenario 3: Transaction Tax

Config: transaction-tax: 5.0
Player transfers: /pay OtherPlayer 100
5 credits go to server vault, 95 go to recipient

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ImperialEco v1.2.8
The Economy Plugin for the imperial Ecosystem

Commands

/money — Check your current balance
/money [player]
/pay — Send money to another player
/pay <player> <amount>
/economyadmin — Admin commands for economy management
/economyadmin <subcommand> [args]
/eco — Shortcut for economy commands
/eco <subcommand> [args]

Plugin details

Built for Minecraft 1.21+
Plugin version 1.2.8
Author ImperialTeam
Works with Vault

Read from the plugin's own plugin.yml.

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft versions listed: 1.20.6, 1.21
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Spigot — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

ImperialEco is a free Minecraft Java mod. Compatible with Minecraft 1.20.6, 1.21. Downloaded 14 times (via Spigot). Download it and open it directly in the game.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.20 Java mods for 1.21