[HR][/HR]

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.

[HR][/HR]

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 with Floodgate reflection hook and platform-aware UX
• Bedrock UX - When a Bedrock player taps an item in the Market GUI, a touch-friendly action panel appears (buy/sell/list buttons) so no right-click/shift-click is required
• Multi-Server - Spigot, Paper, Purpur, Folia support
• Version Range - MC 1.19.4 through 1.21.9+

[HR][/HR]

Installation

Requirements

• Java 17+ (required)
• Spigot/Paper/Purpur/Folia 1.19.4-1.21.9+
• Vault (dependency)

Quick Setup

1. Download EcoXpert-1.0.jar
2. Place in your plugins/ folder
3. Install Vault if not already present
4. Restart server
5. 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!

[HR][/HR]

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"
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

[HR][/HR]

⚙️ 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

[HR][/HR]

Commands

⚠️ Command Compatibility Notice
IMPORTANT: EcoXpert does NOT use /eco as its main command to avoid conflicts with EssentialsX/CMI.

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
Market Commands
Banking Commands
Bank daily limits per tier are configurable in modules/bank.yml (reset on server day).

Loans Commands
GUI Commands
Professions Commands
Admin Commands
Economic Intelligence Commands
Dynamic Economic Events Commands
[HR][/HR]

Configuration

Economy Takeover System
The plugin automatically detects your server setup. For manual control:

Configuration Mode (Simple vs Advanced)

• plugin.config_mode: advanced (default) or simple.
• Simple mode applies curated defaults and exposes only a few top-level knobs in config.yml.

Market Settings
Banking Configuration
[HR][/HR]

Monitoring & Analytics

Built-in Diagnostics
/ecoxpert economy status - Shows current operation mode, provider, sync stats.
/ecoxpert economy diagnostics - Runs conflict detection, mode manager status, and Vault safety checks.

Performance Metrics

• bStats Integration (ID: 26446)
• JMX Monitoring support
• Database performance tracking
• Transaction throughput metrics

Placeholders (PlaceholderAPI)
Identifier: ecox

• %ecox_economy_health% (0–100)
• %ecox_inflation_rate%
• %ecox_cycle%
• %ecox_market_activity%
• %ecox_balance%
• %ecox_bank_balance%
• %ecox_loan_status%
• %ecox_role%
• ...and many more (see documentation)

[HR][/HR]

Integrations

EcoXpert applies light, contextual adjustments when the following plugins are detected:

• WorldGuard: Region rules for buy/sell factors.
• Lands: Area specific factors.
• Towny: Town rules and population-based scaling.
• Jobs Reborn: Reduces payouts when inflation is high.
• Slimefun: Per-material factors for inflationary items.
• mcMMO: Gentle global adjustments.

Public API - Professional Integration

Getting Started with the API
Maven Dependency
[HR][/HR]

Advanced Features

Intelligent Market Algorithms

• Supply/Demand Analysis - 24-hour historical data
• Volatility Calculations - Standard deviation of prices
• Momentum Analysis - Transaction velocity tracking
• Safety Constraints - Min 10%, Max 1000% of base price

Anti-Exploitation Systems

• Rate Limiting - Prevents transaction spam
• Audit Trails - Complete transaction history
• Integrity Verification - Transaction hash validation
• Auto-Freeze - Suspicious account detection

Order Book (Optional)

• Fixed-price listings coexist with the dynamic market engine.
• Sellers lock items upfront with /market list.
• Configurable duration and price bounds in modules/market.yml.

[HR][/HR]

Troubleshooting

Common Issues
Q: Commands don't work with EssentialsX
A: Use /ecoxpert instead of /eco to avoid conflicts. EcoXpert detects conflicts automatically.

Q: Balances not syncing
A: If using EssentialsX/CMI, balances are imported automatically a few seconds after startup (if enabled). You can also run /ecoxpert migrate balances.

Q: Banking features not available
A: Banking system requires full database setup. Check logs for initialization errors.

Bedrock Edition (GeyserMC) Issues
Q: Error [SQLITE_BUSY]
A: Occurs when multiple transactions happen simultaneously. Consider migrating to MySQL if errors persist.

Q: Bedrock players report "blocks staying in inventory"
A: Bedrock Edition doesn't support interactive chest GUIs.
Solution: Install GeyserMC + Floodgate. EcoXpert detects Geyser and switches to Native Bedrock Forms automatically.

MySQL Database Connection Issues
Q: Error Unsupported character encoding 'utf8mb4'
A: Delete the `ecoxpert` database and restart. The plugin will recreate it with a compatible charset.

[HR][/HR]

Support & Community

Getting Support

1. Discord: https://discord.gg/xKUjn3EJzR
2. Run diagnostics with in-game commands
3. Check server logs for detailed error information
4. Review configuration files for proper setup

License
All rights reserved.

[HR][/HR]