Marketplace that allows players to buy and sell any item with dynamic pricing and support for admins to change things, leaderboards, designed to be simple to use so players can jump right in without needing help
Description
⚖️ 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
| Command | Permission | Description |
|---|---|---|
/market |
marketplace.use |
Opens the Player Marketplace UI. |
/market admin |
marketplace.admin |
Opens the Catalog Editor & Settings. |
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
CraftingRecipedata. - 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.