EcoXpert Pro is a next-generation economy plugin designed to solve the most common problem in Minecraft servers:
economic collapse and inflation. Unlike traditional economy plugins, EcoXpert implements intelligent algorithms that prevent economic breakdown and maintain a healthy, engaging economy for players.
Core Philosophy
Traditional servers follow this pattern:
[] Day 1: Players start with $100
[] Day 30: Average balance $50,000
[] Day 60: Average balance $500,000
[] Day 90: Economy broken - players have everything, nothing has value
EcoXpert prevents this through intelligent market dynamics, anti-inflation systems, and advanced economic modeling.
Key Features
Revolutionary Economic Intelligence System
[] Living Economy - Economy that "breathes" with natural expansion/contraction cycles
[] AI-Like Learning - System learns from player behavior and adapts accordingly
[] Economic Personality Profiling - Each player gets unique economic profile (Saver, Trader, Investor, etc.)
[] Predictive Modeling - Forecasts economic trends and prevents crises before they happen
[] Smart Interventions - Automatic economic stimulus, monetary policy adjustments
[] Crisis Prevention - Detects economic anomalies and prevents server economy collapse
Smart Integration
[] Economy Takeover System - Can replace or work alongside EssentialsX/CMI
[] Compatibility Mode - Seamless integration with existing plugins
[] Migration Tools - Import balances from other economy plugins
[] Vault Integration - Full compatibility with all Vault-dependent plugins
Advanced Banking System
[] Tiered Accounts - Basic, Silver, Gold, Platinum levels
[] Interest Calculations - Compound interest with anti-exploitation
[] Daily Limits - Configurable transaction limits per tier
[] Security Features - Account freezing, audit trails, transaction hashing
Dynamic Market System
[] Supply & Demand Analysis - Real market economics
[] Price Volatility - Realistic market fluctuations
[] Trend Analysis - 6 types of market trends (STABLE, UPWARD, VOLATILE, etc.)
[] Safety Constraints - Prevents extreme price manipulation
Cross-Platform Support
[] Java + Bedrock - Full GeyserMC/FloodGate compatibility
[] Multi-Server - Spigot, Paper, Purpur, Folia support
- Version Range - MC 1.19.4 through 1.21.9+
Installation
Requirements
[] Java 17+ (required)
[] Spigot/Paper/Purpur/Folia 1.19.4-1.21.9+
- Vault (dependency)
Quick Setup
[] Download EcoXpert-1.0.jar
[] Place in your plugins/ folder
[] Install Vault if not already present
[] Restart server
- Plugin auto-configures and detects existing economy plugins
With Existing Economy Plugins
EcoXpert automatically detects and integrates with:
[] EssentialsX - Full compatibility
[] CMI - Full compatibility
- Other Vault plugins - Generic compatibility
No configuration needed - works out of the box!
Economic Intelligence System - The Revolution
What Makes EcoXpert Different
Traditional economy plugins are
static - they provide commands and basic functionality, but the economy inevitably collapses as players accumulate infinite wealth.
EcoXpert's Economic Intelligence System creates a LIVING economy that:
Economic Cycles - The Economy "Breathes"
Code (Text):
DEPRESSION → RECESSION → STABLE → GROWTH → BOOM → BUBBLE → RECESSION...
The economy naturally cycles through different phases, just like real economies:
[] Depression: Deflation, low activity - System provides stimulus
[] Recession: Mild economic slowdown - Careful monetary policy
[] Stable: Balanced conditions - Normal operations
[] Growth: Economic expansion - Increased opportunities
[] Boom: High activity period - Great time for investments
[] Bubble: Overheated economy - System applies cooling measures
Player Economic Personalities
The system analyzes each player's behavior and assigns them an economic personality:
[] Saver - Tends to save money, low spending
[] Spender - High spending, low savings
[] Trader - Active market participant
[] Investor - Long-term wealth building
[] Speculator - High-risk, high-reward behavior
[] Hoarder - Accumulates wealth, minimal transactions
[] ❤️ Philanthropist - Generous, helps other players
[] ⚠️ Exploiter - Attempts to exploit economic systems
Predictive Economic Modeling
The system maintains an
Economic Memory that:
[] Learns from historical patterns
[] Predicts future economic conditions
[] Identifies potential crises before they happen
[] Recommends optimal intervention strategies
Intelligent Crisis Prevention
Automatic Anomaly Detection:
[] Rapid economic health changes
[] Extreme inflation/deflation
[] Wealth inequality spikes
[] Market volatility warnings
- Unusual activity patterns
Smart Interventions:
[] Emergency Stimulus - Crisis response with targeted money injection
[] Monetary Easing - Lower interest rates, increase money supply
[] Monetary Tightening - Combat inflation with policy changes
[] Market Stimulation - Encourage trading activity
- Wealth Redistribution - Address inequality issues
Economic Health Monitoring
Real-time tracking of:
[] Economic Health (0-100%) - Overall economy condition
[] Inflation Rate - Current price level changes
[] Velocity of Money - How fast money circulates
[] Gini Coefficient - Wealth inequality measurement
- Market Volatility - Economic stability indicator
⚙️ Economy Integration Modes
EcoXpert operates in different modes based on your server setup:
Takeover Mode
[] When: No other economy plugin detected
[] Result: EcoXpert becomes primary economy provider
- Benefits: Full intelligent economy features
Compatibility Mode
[] When: EssentialsX/CMI detected
[] Result: Works alongside existing plugins
- Benefits: Adds intelligent features without disrupting current setup
Sync Mode
[] When: In compatibility mode
[] Result: Automatic balance synchronization
- Benefits: Seamless data consistency between plugins
️ Safe Mode
[] When: Errors detected
[] Result: Minimal functionality to prevent server issues
- Benefits: Never breaks your server
Commands
⚠️ Command Compatibility Notice
IMPORTANT: EcoXpert
does NOT use /eco as its main command to avoid conflicts with EssentialsX/CMI.
Code (Text):
| Plugin | Main Command | EcoXpert Compatibility |
|-------------|---------------------|------------------------|
| EcoXpert | /ecoxpert, /ecox, /ex | ✅ Primary commands |
| EssentialsX | /eco | ✅ No conflict |
| CMI | /eco | ✅ No conflict |
Recommended usage:
[] Use /ecoxpert or /ecox for EcoXpert commands
[] Use /eco for EssentialsX/CMI commands (if installed)
- No configuration needed - works out of the box!
Basic Economy Commands
Code (Text):
/ecox balance [player] - Check balance
/ecox pay <player> <amount> - Pay another player
/ecox help - Show help menu
Market Commands
Code (Text):
/market buy <item> [amount] - Buy items
/market sell <item> [amount] - Sell items
/market prices - View current prices
/market stats - Market statistics
/market list <item> <qty> <unit_price> [hours] - Create a fixed-price listing
/market orders [item] - View open fixed-price orders
/market buyorder <id> <qty> - Buy from an order
/market help - Market help
Banking Commands
Code (Text):
/bank balance - Check bank balance
/bank deposit <amount> - Deposit money
/bank withdraw <amount> - Withdraw money
/bank transfer <player> <amount> - Transfer to another account
/bank help - Banking help
Loans Commands
Code (Text):
/loans request <amount> - Request a new loan
/loans pay <amount> - Pay towards your active loan
/loans status - View your current loan
/loans offer <amount> - View a personalized loan offer
/loans schedule - View your repayment schedule
GUI Commands
Code (Text):
/bankgui - Open Bank GUI
/loansgui - Open Loans GUI
/ecoevents - Open Events Admin GUI
/ecoadmin - Open EcoXpert Admin dashboard
/professiongui - Open Professions GUI
/market - Open Market GUI
Professions Commands
Code (Text):
/profession info - Show your current profession
/profession select <role> - Select a profession
/profession level - Show your current profession level
/profession levelup - Increase your profession level
Admin Commands
Code (Text):
/ecoxpert admin set <player> <amount> - Set player balance
/ecoxpert admin add <player> <amount> - Add money to player
/ecoxpert admin remove <player> <amount> - Remove money
/ecoxpert migrate balances - Import balances
Economic Intelligence Commands
Code (Text):
/ecoxpert economy status - Check economy system status
/ecoxpert economy diagnostics - Run system diagnostics
/ecoxpert economy health - View economic health details
/ecoxpert economy cycle - View current economic cycle
/ecoxpert economy forecast - View economic predictions
/ecoxpert economy anomalies - Check for economic anomalies
/ecoxpert economy intervention <type> - Force economic intervention
/ecoxpert player profile <player> - View player economic profile
/ecoxpert player personality <player> - View player economic personality
Dynamic Economic Events Commands
Code (Text):
/ecoxpert events active - View active economic events
/ecoxpert events history - View recent event history
/ecoxpert events trigger <type> - Force trigger specific event type
/ecoxpert events end <id> - End specific active event
/ecoxpert events status - View event engine status
Intelligence System Interventions
Code (Text):
emergency_stimulus - Crisis response with money injection
monetary_easing - Lower rates, increase money supply
monetary_tightening - Combat inflation, reduce money supply
market_stimulation - Encourage market trading activity
wealth_redistribution - Address wealth inequality
Configuration
Economy Takeover System
The plugin automatically detects your server setup. For manual control:
Code (YAML):
config.yml
economy:
takeover:
enabled
: true
mode
:
"auto"
# auto, takeover, compatibility, safe
sync_interval
: 60
# seconds
migration:
import_on_startup
: true
backup_before_import
: true
Update Checker
Code (YAML):
plugin:
updates:
check-enabled
: true
resource-id
: 0
check-url
:
""
download-url
:
"https://github.com/koyere/ecoxpert"
Configuration Mode (Simple vs Advanced)
[] plugin.config_mode: advanced (default) or simple.
[] Simple mode applies curated defaults.
Market Settings
Code (YAML):
market:
price_update_interval
: 300
# 5 minutes
max_price_change
: 0.20
# 20% max change per update
volatility_damping
: 0.85
# Reduces extreme volatility
trend_analysis_hours
: 24
# Historical data for trends
Banking Configuration
Code (YAML):
banking:
tiers:
basic:
interest_rate
: 0.01
# 1% annual
daily_deposit_limit
: 1000
daily_withdraw_limit
: 500
# Additional tiers...
Monitoring & Analytics
Built-in Diagnostics
Code (Text):
/ecoxpert economy status
System Health Check
Code (Text):
/ecoxpert economy diagnostics
Performance Metrics
[] bStats Integration (ID: 26446)
[] JMX Monitoring support
[] Database performance tracking
[] Transaction throughput metrics
Placeholders (PlaceholderAPI)
Identifier:
ecox
[] Global: %ecox_economy_health%, %ecox_inflation_rate%, %ecox_cycle%, etc.
[] Player: %ecox_balance%, %ecox_loans_outstanding%, %ecox_role%, etc.
Public API - Professional Integration
EcoXpert provides a comprehensive
public API for third-party plugin developers.
Getting Started with the API
Code (Java):
// Get the API instance
EcoXpertAPI api
= org.
bukkit.
plugin.
java.
JavaPlugin
.
getPlugin
(me.
koyere.
ecoxpert.
EcoXpertPlugin.
class
)
.
getServiceRegistry
(
)
.
getInstance
(me.
koyere.
ecoxpert.
api.
EcoXpertAPI.
class
)
;
// Check if API is ready
if
(api.
isReady
(
)
)
{
String version
= api.
getAPIVersion
(
)
;
}
Available Services
[] EconomyService: Basic economy operations
[] MarketService: Market analytics & pricing
[] BankingService: Banking operations
[] LoanService: Loan management
[] EventsService: Economic events
[] ProfessionService: Player professions
- InflationService: Economic metrics
Add EcoXpert as Dependency
Maven (pom.xml):
Code (XML):
<dependencies>
<dependency>
<groupId>me.koyere
</groupId>
<artifactId>ecoxpert
</artifactId>
<version>1.0.0
</version>
<scope>provided
</scope>
</dependency>
</dependencies>
plugin.yml:
Code (YAML):
depend
:
[EcoXpert
]
or for optional integration:
softdepend
:
[EcoXpert
]
Advanced Features
[] Intelligent Market Algorithms
[] Anti-Exploitation Systems
[] Economic Modeling
[] Order Book (optional fixed-price listings)
Troubleshooting
Common Issues
[] Q: Commands don't work with EssentialsX
A: Use /ecoxpert instead of /eco to avoid conflicts.
[] Q: Balances not syncing
A: Run /ecoxpert migrate balances.
- Q: Market prices seem wrong
A: Market uses real supply/demand. Prices adjust based on actual trading activity.
Debug Information
Enable debug logging in
config.yml:
Code (YAML):
debug:
enabled
: true
level
:
"INFO"
# DEBUG, INFO, WARN, ERROR
Support & Community
Getting Support
[] Discord: https://discord.gg/xKUjn3EJzR
[] Run diagnostics with in-game commands
[] Check server logs for detailed error information
[] Review configuration files for proper setup
License
All rights reserved.
Made with ❤️ for the Minecraft community
EcoXpert Pro - Because your economy deserves intelligence