# 🏪 CustomNPC+ 1.11 - Market Update 🏪 --- The **Market Update** brings a complete economy system to CNPC+! Create bustling marketplaces with **Traders** that have limited stock, or let players trade with each other through the brand new **Auction House**! --- ## Currency System 💰 CNPC+ now has a **built-in currency** used across all Market features! - **Fully Configurable** - Name it Coins, Gold, Credits, whatever fits your world. Set a starting balance and max balance cap to shape your economy - **Profile Persistent** - Currency carries across all your character slots - **Vault Support** - Integrates seamlessly with Bukkit-compatible economy plugins if Vault is installed. Falls back to built-in currency otherwise - **Lifetime Tracking** - Tracks total earned and spent per player > Full Scripting API support for currency operations on players. --- ## Auction House 🏛️ A **global player marketplace** where players can list items, bid against each other, and purchase instantly! Search for items by name or seller, and sort by newest, ending soon, price, or most bids. ### Selling List any item with a **Starting Price** for competitive bidding. Set an optional **Buyout Price** for players who want to skip the wait and buy immediately. Auctions last **24 hours** by default. > A configurable **Listing Fee** is charged when creating auctions, and a **Sales Tax** is taken from successful sales. ### Bidding Compete for items by placing bids! Each bid must be at least **5%** higher than the current bid. **Snipe Protection** extends auctions when last-second bids come in, giving everyone a fair shot. If you get outbid, your currency is **automatically refunded**. ### Buyout See something you need right now? Hit **Buy Now** to purchase instantly at the seller's Buyout Price. If you're currently the highest bidder on an item, you only pay the **difference** between your bid and the buyout. ### My Trades One screen to manage all your auction activity: - **Active Listings** - Items you're currently selling - **Active Bids** - Auctions you're competing in - **Ready to Claim** - Won items and currency waiting for pickup Players can **cancel** their own listings -- items are returned as a claim. If there are active bids on the listing, a **10% cancellation penalty** is charged. > Claims expire after **20 days**. Make sure to collect your items and currency before they're gone! ### Notifications Get notified immediately when your item sells, when you're outbid, or when you win an auction. Offline? You'll get a full **claim summary** when you log back in showing exactly what's waiting for you. ### Trade Slots Every player gets a limited number of **Trade Slots** (default 8). Slots are shared across Active Listings, Active Bids, **and** Pending Claims -- so uncollected claims take up space. Pick up your claims to free slots for new listings and bids! > Server owners can grant players more slots via permissions up to a maximum of 45. --- ## Item Blacklist 🚫 Server owners have full control over what items can be listed on the Auction House. **Block by:** - **Item** - Specific registry names like `minecraft:diamond_sword` - **Wildcard** - Patterns like `minecraft:diamond*` to block all diamond items - **Mod** - Block all items from a specific mod - **NBT Tag** - Block items containing certain NBT data > **Soulbound** and **Profile-Slotbound** items are always blocked automatically, regardless of blacklist settings. Bound items cannot be traded! Manage the blacklist in-game with `/kam auction blacklist` commands, or configure it directly in the config file. --- ## Trader Enhancements 🛒 ### Stock System Traders now support **limited stock** with automatic restocking! **Stock Modes:** - **Global** - All players share the same stock pool - **Per-Player** - Each player has their own purchase limits **Restock Timers:** - **MC Daily / Weekly** - Restock based on Minecraft time - **RL Daily / Weekly** - Restock based on real-life time - **Custom** - Set your own interval in MC ticks or real-time Stock counts, out-of-stock status, and restock timers are all visible directly in the trade interface. > Admins can manually reset stock or cooldowns via the Trader GUI. ### Currency Trades Trades can now require **currency on top of items**. Combine material costs with coin costs for balanced economy progression! --- ## Auctioneer Role 🧑‍💼 New NPC role for the Auction House! Set the role on any NPC and players can access the full Auction House by interacting with them -- no extra configuration needed. The role respects the global Auction Enabled setting. ### Auction Commands Players can also access the Auction House via command: - `/kam auction open` - Opens the Auction House GUI **Admin Commands:** - `/kam auction list [page]` - View active auctions in chat - `/kam auction view ` - View a player's auction activity > Server owners can enable **auction logging** to track all auction activity (creates, bids, buyouts, sales, expirations, cancellations, and claims). ---