PlayerMarket 🛒
PlayerMarket is an enterprise-grade, GUI-based marketplace and interactive auction plugin built for modern Paper/Spigot servers (1.20.1+).
It gives your players a secure, seamless, and visual trading experience—complete with live bidding, search filters, custom model support, and transaction safety features to combat inflation and item dupe bugs.
🔥 Key Features
🔨 Interactive Bidding & Auction System
-
Dedicated Auctions Tab: Completely separates standard "Buy Now" offers from live bidding listings.
-
Sign-GUI Bidding: Players can place bids directly through an on-screen Sign GUI—no need to memorize numerical item IDs.
-
Escrow & Instant Outbid Refunds: Bid money is held safely in escrow and automatically refunded to the previous bidder the moment they are outbid.
-
Live Auction Management: Track active auctions, current top bidders, highest bids, and remaining times directly inside your personal listings tab.
-
Automated Cycle Finalization: Expiration checks safely deliver items to winning bidders and process tax-adjusted payouts to sellers.
🛡️ Transaction Safety & Anti-Dupe Security
-
Atomic Transactions: Items are securely removed from player inventories before a listing is saved to disk.
-
Automated Rollback Protection: Full refund guarantees on money and items if a save fails or a server crashes mid-transaction.
-
Purchase Confirmation Screen: Built-in confirmation GUI prevents accidental clicks and misbuys.
⚖️ Economic Controls & Market Balancing
-
Configurable Market Tax: Built-in sales fee system to naturally drain excess currency and control inflation.
-
Listing Limits & Expirations: Restricts active listings per player to prevent market spam. Unsold items safely route to a claimable storage warehouse.
-
Offline Sales Payouts: Earnings and notifications are stored on disk—players safely receive their funds upon logging back in.
🎨 Visual Feedback & Resource Pack Support
-
Clean & Modern GUI: Sleek gray glass fillers with hidden vanilla attributes for a clutter-free look.
-
Juicy Audio & Particle Effects: Satisfying visual and audio feedback for purchases, sales, and GUI interactions.
-
Full Custom Item Support: Native compatibility with CustomModelData, NBT tags, ItemsAdder, and Oraxen.
📌 Commands & Aliases
| Command |
Description |
/market |
Opens the main marketplace GUI. |
/market mine (or /market my) |
View and manage your active listings and auctions. |
/market sell <price> [amount] |
Lists the item in your main hand for a fixed "Buy Now" price. |
/market bid <starting_price> <duration_hours> |
Places the item in your main hand up for live auction. |
/market raise <id> <amount> |
Alternative command-based bidding option for active auctions. |
/market search <query> |
Search listings by name (also accessible via the Sign GUI in-game). |
/marketadmin remove <id> |
(Admin) Force-removes an active market listing. |
/market reload |
(Admin) Reloads plugin settings on a live server without restarting. |
Legacy Alias: /rynek is also supported out of the box!
⚙️ Requirements
-
Server Engine: Paper / Spigot 1.20.1 or newer
-
Java: 17+
-
Dependencies: Vault + an economy provider (e.g., EssentialsX Economy, CMI)