GlobalEconomy v1.1.1

GlobalEconomy: Professional Cross-Server Economy and Auction House

GlobalEconomy is a high-performance solution designed for Minecraft networks that require a unified economy and item marketplace across multiple servers. Built with scalability and data integrity as core principles, it provides a seamless experience for players while offering powerful management tools for administrators.

---

Key Features

Advanced Global Economy

• Unified Balance: Credits and balances are synchronized instantly across the entire network.
• Vault Integration: Fully compatible with any plugin that supports the Vault API.
• Atomic Transactions: Prevents money duplication and ensures data consistency even during server crashes or performance issues.
• Customizable Currency: Full control over singular/plural currency names and symbols.
• Transfer Taxation: Configure optional taxes for player-to-player transfers via the /pay command.

Cross-Server Auction House

• Network-Wide Marketplace: List items on one server and allow players to purchase them from any other connected server.
• Modern GUI Interface: A clean, chest-based user interface for browsing, buying, and managing listings.
• Advanced Filtering and Categories: Organize items by category (Combat, Blocks, Tools, etc.) as defined in the categories configuration.
• Real-Time Search and Sorting: Instantly find items by name and sort results by price or listing date.
• Safe Item Delivery: Items are stored securely in the database until claimed, preventing loss during cross-server transfers or inventory issues.

Scalable Synchronization

• Redis Pub/Sub: High-speed, real-time synchronization for large networks.
• SQL Fallback: A robust polling system for smaller setups or environments where Redis is not available.
• Sharing Groups: Advanced partitioning system to group specific servers and worlds together, allowing for isolated or shared economies.

Professional Notifications

• Customizable Sound Effects: Optional audio feedback for purchases, listings, and menu navigation.
• Real-Time Alerts: Sellers receive instant chat notifications describing the buyer and price received, including explicit tax deduction details.
• Discord Integration: Broadcast new listings or significant sales directly to Discord channels using webhooks.

Administrative and Developer Tools

• Detailed Auditing: Every transaction and sale is recorded with comprehensive metadata in the database.
• Data Export: Generate JSON exports of transaction logs for external analysis.
• Marketplace Management: Tools to monitor total listings, purge old data, and manage player balances.
• Extensive Compatibility: Includes a PlaceholderAPI expansion and a developer API/Service Registry.

---

Command Reference

Player Commands

• /balance [player] - Check the current credit balance.
• /pay <player> <amount> - Transfer money to another player.
• /ah - Open the main Auction House menu.
• /ah sell <price> - List the item currently in hand for sale.
• /ah search <query> - Open the marketplace with a specific search filter.
• /ah expired - Reclaim items from cancelled or expired listings.
• /ah cancel <id> - Manually cancel a specific listing.

Admin Commands

• /economy <give|take|set|reset> <player> <amount> - Modify player balances.
• /geadmin reload - Reload all configuration and language files.
• /geadmin stats - View network-wide economy and auction statistics.
• /geadmin export [limit] - Export transaction logs to a JSON file.
• /geadmin purge [days] - Remove old expired or cancelled listings from the database.

---

Technical Specifications

• Supported Databases: MySQL, PostgreSQL, SQLite.
• Messaging Protocols: Redis or SQL Polling.
• Supported Versions: Minecraft 1.16 through the latest version.
• Java Requirement: Java 17 or higher.