NightMarket

# NightMarket - Per-Player Random Market Plugin **A configurable, per-player "night market" plugin for Minecraft servers running Paper 1.21.1** — every player gets their own rotating shop of random offers with random discounts, revealed by flipping cards in a clean GUI. --- ## ✨ Key Features ### 🎯 **Core Systems** - **Per-Player Random Markets** - Each player rolls their own unique set of offers; no two markets are the same - **Seasonal Auto-Reset** - Markets stay locked in until the configurable season ends, then regenerate automatically - **Random Discounts** - Every offer gets a random discount between your min/max; original price, discount %, and final price are shown and never change until reset - **Reveal-Card GUI** - Offers start face-down and flip open with a short animation, then become buyable, then "Sold Out" - **Interactive GUIs** - Clean, intuitive menus for both players and admins ### 🔧 **Admin Tools** - **In-Game Item Pool Editor** - Add, edit, and remove offers without touching config files - **Add Items from Hand** - Supports vanilla, **Oraxen**, **ItemsAdder**, and **MMOItems** with full NBT preservation - **One-Click Command Rewards** - Create command-based offers straight from the pool menu - **Player Management** - Reset a single player's market, refresh it, or reset everyone at once - **Live Reload** - Update config and language files without restarting ### ⚡ **Performance & Safety** - **Async Database** - All saves run off the main thread, so the server never stalls on disk I/O - **Ordered Write Queue** - A single FIFO queue guarantees a market is saved before any sold-out update, so purchases can never be lost across restarts - **In-Memory Caching** - Markets and the item pool are cached for instant access - **Anti-Dupe Protection** - Per-player busy guard + sold-out flag prevent double-clicks, race conditions, and item duplication - **Graceful Shutdown** - Pending writes are flushed safely on disable - **Graceful Disable** - If Vault or an economy provider is missing, the plugin disables itself with a clear console message instead of erroring ### 🎁 **Flexible Rewards** - **Two Reward Types per Offer:** - **Item** - Give a vanilla or custom item - **Command** - Run one or more console commands on purchase (ranks, kits, money, crate keys, anything) - **Custom Item Support** - Oraxen, ItemsAdder, and MMOItems (auto-detected; rebuilt fresh on purchase with a safe fallback) - **NBT Preservation** - Custom enchants, lore, and attributes are kept - **Placeholders** - `{player}` / `%player%`, `{uuid}`, `{item_name}`, `{price}`; chain commands with `;;` ### 🎨 **Fully Translatable** ``` ✓ All GUI titles ✓ All item names ✓ All lore ✓ All chat messages ✓ MiniMessage support ✓ Hex & legacy colors ✓ en_US included ✓ id_ID included ✓ Live language switching ``` --- ## 📦 Installation 1. Install **Vault** and a Vault-compatible economy plugin (e.g. EssentialsX) 2. Download the latest `.jar` and place it in your server's `plugins` folder 3. Restart your server — `config.yml` and language files generate automatically 4. Run `/nightmarket admin` to start adding offers 5. Reload anytime with `/nightmarket reload` --- ## 🎮 Commands ### **Player Commands** - `/nightmarket` or `/nm` - Open your Night Market ### **Admin Commands** - `/nightmarket admin` - Open the admin dashboard - `/nightmarket reset <player>` - Reset a player's market - `/nightmarket resetall` - Reset every player's market - `/nightmarket reload` - Reload config and language files --- ## 🔐 Permissions - `nightmarket.use` - Open and buy from the market (default: true) - `nightmarket.admin` - Admin GUI and management (default: op) - `nightmarket.reset` - Reset player markets (default: op) - `nightmarket.reload` - Reload the plugin (default: op) --- ## ⚙️ Configuration **Customizable via `config.yml` — most settings are also editable in-game:** ```yaml language: en_US market: size: 6 # offers per player discount-min: 10 # min random discount (%) discount-max: 70 # max random discount (%) duration-hours: 24 # season length before auto-reset purchase: drop-if-inventory-full: true hooks: custom-items: true # Oraxen / ItemsAdder / MMOItems ``` --- ## 🤝 Compatibility - **Minecraft Version**: 1.21.1 (Paper) - **Java Version**: 21+ - **Required**: Vault + an economy provider - **Optional Dependencies**: - Oraxen (custom items) - ItemsAdder (custom items) - MMOItems (custom items) --- ## 🐛 Support & Feedback Found a bug or have a suggestion? Please report issues with: - Server version (e.g., Paper 1.21.1) - Plugin version - Steps to reproduce - Console errors (if any) on our discord --- **Made with ❤️ by ResistanceCore** *If you enjoy this plugin, please leave a ❤️ and share it with other server owners!*