⚖️ Marketplace Plugin v1.3

The Definitive Player-Driven Economy for Hytale

Marketplace Plugin is a high-performance, full-featured player commerce solution built for Hytale. Designed by WEJ, it offers a living, breathing economy where prices react dynamically to supply and demand, backed by a "paranoid" safety architecture to ensure items and currency are never lost.

🎮 See it in Action!

Experience the marketplace firsthand on Absolute! This plugin is a core part of the server's economy. 🚀 IP: play.absolute-server.com

🌟 Core Features

🛒 The Player Experience

• One Command, Infinite Trade: Access everything via /market. An immersive custom UI handles buying, selling, history, and leaderboards.
• Smart Selling: Automatically scans hotbar, main inventory, backpacks, and armor slots. Each source is independently toggleable.
• Pristine-Only Enforcement: Detects item durability to prevent players from accidentally selling worn-out tools for full market value.
• Safety First: High-value purchase confirmations (default >$1,000) and a trade undo system protect players from "fat-finger" mistakes.

📉 Dynamic Supply & Demand Engine

The marketplace isn't just a shop—it's an ecosystem.

• Price Fluctuations: Prices rise with net buy pressure and drift down during surplus, governed by a daily "Economy Tick."
• Recipe-Aware Pricing: Link item values. If the price of "Stone" rises, the price of "Stone Bricks" can automatically follow based on recipe quantities.
• Anti-Exploit Damping: Hard caps on daily price swings and "Quiet Day" dampeners prevent market manipulation during low-activity periods.

🏆 Global Leaderboards

Track the titans of industry with multi-period statistics:

• Metrics: Track "Earned" (Sales) and "Spent" (Purchases).
• Periods: Daily, Weekly, Monthly, Yearly, and All-Time views.
• Accuracy: Leaderboard data is automatically corrected during trade undos or rollbacks, keeping the rankings truthful.

🛡️ Stability & Reliability (Admin Specs)

Built with a "Zero-Lag, Zero-Loss" philosophy to protect your server's integrity:

• Debt Ledger: If a player has a full inventory during a trade rollback, items are saved to a persistent ledger and delivered automatically the moment they have space.
• Atomic Data Integrity: All database writes use atomic file moves and maintain 5 rotating backups to prevent corruption.
• Thread Safety: Heavy pricing math is offloaded from the world thread, while all ECS interactions are perfectly synchronized to prevent "Assert not in thread" crashes.
• Ecotale Integration: Native, reflective binding to the Ecotale economy API for robust transaction auditing.

🛠️ Admin Toolset & Permissions

Admin Features:

• Live Catalog Editor: Change prices, stock floors, and visibility on the fly.
• Recipe Auto-Populator: Automatically set parent pricing by reading Hytale's CraftingRecipe data.
• Concurrent Editing: Safe-save logic allows multiple admins to edit the catalog simultaneously without overwriting each other's changes.

📂 Technical Details

• Dependency: Requires Ecotale:Ecotale (LoadOrder: POSTWORLD).
• Storage: Human-readable JSON with automated auto-migration from older builds.
• UI Assets: Fully bundled within the JAR (IncludesAssetPack: true)—no manual client installation required.

Developed by WEJ. Prioritizing performance, stability, and a fair trade environment.