5.0 KiB
🏪 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 <player>- 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).