27 KiB
CustomNPC+ 1.11 Market Update - Implementation Plan
Overview
The 1.11 Market Update introduces a comprehensive economy system for CustomNPC+:
- Currency System - Built-in CNPC+ currency with optional Vault integration
- Trader Enhancements - Stock system, currency-based trades, reset timers
- Auction House - Global auction system with bidding, buyout, and claims
1. Currency System
Status: IMPLEMENTED
The currency system provides a unified economy for CNPC+ features.
Features
- Built-in CNPC+ Currency - Stored in PlayerData, persists across profile slots
- Vault Integration - Optional, when enabled all operations use Vault instead
- Scripting API - Full access via
IPlayermethods
Key Files
| File | Purpose |
|---|---|
PlayerCurrencyData.java |
Per-player currency storage, Vault delegation |
IPlayerCurrencyData.java |
API interface for currency operations |
ConfigMarket.java |
Currency configuration (UseVault, CurrencyName, StartingBalance, MaxBalance) |
VaultUtil.java |
Vault API integration via reflection |
Configuration (ConfigMarket.java)
Market.Currency:
- Use Vault: false
- Currency Name: "Coins"
- Starting Balance: 0
- Max Balance: 2147483647
Scripting API (IPlayer)
player.getCurrencyBalance() // Get balance
player.setCurrencyBalance(amount) // Set balance
player.depositCurrency(amount) // Add currency (returns success)
player.withdrawCurrency(amount) // Remove currency (returns success)
player.canAffordCurrency(amount) // Check if can afford
player.isUsingVaultCurrency() // Check if Vault is active
player.getFormattedCurrencyBalance() // Get formatted string
2. Trader Enhancements
Status: COMPLETE
2.1 Stock System - IMPLEMENTED
Traders can have limited stock that resets on configurable schedules.
Stock Modes
| Mode | Description | Status |
|---|---|---|
| Global | All players share the same stock pool | ✅ Working |
| Per-Player | Each player has their own stock counts | ✅ Working |
Stock Reset Types (EnumStockReset)
| Type | Description | Status |
|---|---|---|
NONE |
Stock never resets | ✅ Working |
MCDAILY |
Resets every MC day (24000 ticks) | ✅ Working |
MCWEEKLY |
Resets every 7 MC days (168000 ticks) | ✅ Working |
MCCUSTOM |
Custom MC tick interval | ✅ Working |
RLDAILY |
Resets every 24 real-life hours | ✅ Working |
RLWEEKLY |
Resets every 7 real-life days | ✅ Working |
RLCUSTOM |
Custom real-time interval | ✅ Working |
Stock UI Features - IMPLEMENTED
| Feature | Status | Notes |
|---|---|---|
| Stock count per item | ✅ | Shows to right of output slot |
| Out of stock indicator | ✅ | Dark overlay + red count |
| Reset timer countdown | ✅ | Real-time client-side countdown in top-right |
| "Reopen Trader" message | ✅ | Shows when countdown reaches 0 |
| Admin stock configuration | ✅ | SubGuiNpcTraderStock |
| Per-slot stock limits | ✅ | SubGuiNpcTraderStockSlots |
| Reset stock button | ✅ | With confirmation dialog |
| Reset cooldown button | ✅ | With confirmation dialog |
Key Files
| File | Purpose |
|---|---|
TraderStock.java |
Core stock data class with per-player/global modes |
TraderStock.PlayerTraderStock |
Inner class for per-player tracking |
EnumStockReset.java |
Reset type enum with intervals |
SubGuiNpcTraderStock.java |
Main stock configuration GUI |
SubGuiNpcTraderStockSlots.java |
Per-slot stock limit editor |
SubGuiNpcTraderStockReset.java |
Stock reset confirmation |
SubGuiNpcTraderCooldownReset.java |
Cooldown reset confirmation |
2.2 Trader Currency Support - IMPLEMENTED
Trades can require BOTH items AND currency (additive costs).
Trade Entry Structure
Each trade slot can have:
- Sold Item - What the player receives ✅
- Currency 1 - First item cost (existing) ✅
- Currency 2 - Second item cost (existing) ✅
- Currency Cost - CNPC+ Currency / Vault cost ✅ NEW
Example Trades
| Sold Item | Item Cost | Currency Cost |
|---|---|---|
| Diamond | 2 Emeralds | $0 |
| Diamond Sword | 5 Diamonds | $100 |
| Special Armor | None | $500 |
| Enchanted Book | 1 Book + 10 Lapis | $50 |
Implementation Details
- Currency cost stored as
long[] currencyCost[18]in RoleTrader - Default to 0 (no currency cost) for legacy compatibility ✅
- Check both item AND currency requirements before purchase ✅
- Withdraw currency on successful purchase ✅
- NBT serialization for persistence ✅
2.3 Player Trader GUI - IMPLEMENTED
Layout (256px wide)
- 3 columns × 6 rows = 18 trade slots
- Column width: 80px
- Per slot: [Currency1][Currency2] = [Output]
- Player inventory positioned below
Display Features
| Element | Position | Status |
|---|---|---|
| "Trader" label | Top-left | ✅ |
| Reset countdown | Top-right | ✅ Real-time ticking |
| Stock count | Right of each trade | ✅ Green/Red |
| Player balance | Bottom-right | ✅ |
| Status message | Bottom-left | ✅ On hover |
Status Messages (on hover)
| Condition | Message | Color |
|---|---|---|
| Out of stock | "Out of Stock ($COST)" | Red |
| Can't afford balance | "Insufficient Balance ($COST)" | Red |
| Missing item currency | "Unavailable ($COST)" | Red |
| Slot disabled | "Slot Disabled ($COST)" | Orange |
| Can purchase | "Available ($COST)" | Green |
Cost suffix only appears if trade has currency cost > 0.
2.4 Multi-Player Sync - IMPLEMENTED
MarketRegistry System
Central registry for linked market synchronization across all NPCs sharing the same market.
| Component | Purpose |
|---|---|
MarketRegistry.java |
Central registry tracking traders and viewers per market |
marketTraders |
Map<String, Set<RoleTrader>> - All traders using each market |
marketViewers |
Map<String, Set<EntityPlayerMP>> - All players viewing each market |
Viewer Tracking System
| Feature | Status | Notes |
|---|---|---|
| Register viewer on GUI open | ✅ | For shared stock mode (linked or local) |
| Unregister on GUI close | ✅ | Via onContainerClosed |
| Sync after purchase | ✅ | All viewers updated market-wide |
| Per-player mode optimization | ✅ | Only sync to purchasing player |
| Disconnected player cleanup | ✅ | Removed before sync |
| NPC unload cleanup | ✅ | Via delete() → onUnload() |
Sync Behavior by Mode
| Mode | Linked Market | Behavior |
|---|---|---|
| Shared Stock | Yes | All viewers across ALL NPCs with same market see update immediately |
| Shared Stock | No | All viewers of THIS NPC see update immediately |
| Per-Player Stock | Yes/No | Only purchasing player receives update |
Data Flow
Purchase on NPC1 (market="shop1")
↓
consumeStock() → Market.save() → MarketRegistry.syncMarket("shop1")
↓
┌──────────────────────────────────────────────┐
│ 1. Update ALL traders' stock data │
│ (NPC1, NPC2, NPC3... all with "shop1") │
│ 2. Sync ALL viewers across ALL those NPCs │
└──────────────────────────────────────────────┘
2.5 Key Files Modified/Created
| File | Changes |
|---|---|
MarketRegistry.java |
NEW - Central registry for linked market sync |
RoleTrader.java |
currencyCost[], viewer tracking (local + registry), syncAllViewers(), resetCooldown(), delete() cleanup |
ContainerNPCTrader.java |
Layout constants, currency/stock validation, viewer registration |
GuiNPCTrader.java |
Client-side countdown, stock display, status messages |
GetTraderData.java |
Network packet for requesting trader data (IGuiData pattern) |
TraderStock.java |
Stock management with per-player/global modes, thread-safe methods |
EnumStockReset.java |
Reset type definitions with lang key support |
SubGuiNpcTraderStock.java |
Stock configuration dialog, custom time validation |
SubGuiNpcTraderStockSlots.java |
Per-slot stock limits |
SubGuiNpcTraderStockReset.java |
Stock reset confirmation |
SubGuiNpcTraderCooldownReset.java |
Cooldown reset confirmation |
GuiNPCInterface.java |
Fixed SubGui background tiling for smaller widths |
Market.java |
Fixed save logic for linked markets |
IRoleTrader.java |
Extended API with stock manipulation methods |
ScriptRoleTrader.java |
Implemented new API methods |
2.6 Resolved Issues
All previously identified issues have been fixed:
Critical Issues - FIXED
| Issue | Fix |
|---|---|
| Market load overwrites reset | Reordered interact() to load market BEFORE stock reset check |
| recordHistory flag inverted | Removed inverted early return in Market.save() |
| API returns wrong item | Fixed getSellOption() to return inventorySold instead of inventoryCurrency |
Medium Priority - FIXED
| Issue | Fix |
|---|---|
| Thread safety | Added synchronized to getAvailableStock(), consumeStock(), resetStock() |
| Per-player cleanup | playerStock.clear() called on stock reset |
| Linked market sync | Implemented MarketRegistry for market-wide sync |
| Custom time validation | Added min validation (1 tick MC, 1000ms RL) in SubGuiNpcTraderStock |
Low Priority - FIXED
| Issue | Fix |
|---|---|
| lastPurchaseTime unused | Removed from PlayerTraderStock |
| Currency format | Verified working correctly for all ranges |
| Hardcoded reset types | Now uses EnumStockReset.getDisplayNames() with lang keys |
2.7 Scripting API - IMPLEMENTED
Full API available via IRoleTrader interface:
// Stock Configuration
trader.isStockEnabled()
trader.setStockEnabled(boolean)
trader.isPerPlayerStock()
trader.setPerPlayerStock(boolean)
trader.getStockResetType() // Returns int (0-6 for EnumStockReset)
trader.setStockResetType(int)
trader.getCustomResetTime()
trader.setCustomResetTime(long)
// Stock Limits
trader.getMaxStock(slot) // Max stock for slot (-1 = unlimited)
trader.setMaxStock(slot, amount)
// Stock Queries
trader.getAvailableStock(slot) // Global mode
trader.getAvailableStock(slot, player) // Per-player mode
trader.getCurrentStock(slot) // Current stock (global)
trader.getPlayerPurchased(slot, player) // Amount purchased by player
// Stock Manipulation
trader.setCurrentStock(slot, amount) // Set current stock (global)
trader.setPlayerPurchased(slot, player, amount) // Set player's purchased amount
trader.resetStock() // Reset all stock to max
trader.resetCooldown() // Reset cooldown timer
// Time Queries
trader.getLastResetTime() // Timestamp of last reset
trader.getTimeUntilReset() // Time remaining until next reset
// Currency Cost System
trader.getCurrencyCost(slot)
trader.setCurrencyCost(slot, amount)
trader.hasCurrencyCost(slot)
3. Auction House System
Status: NOT STARTED (Fresh implementation)
3.1 Architecture Overview
┌─────────────────────────────────────────────────────────────┐
│ AuctionController │
│ - Manages all auction data │
│ - Handles listing/bidding/buyout logic │
│ - Processes claims │
│ - Saves/loads auction data │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ AuctionNotification │
│ - Tracks pending notifications per player │
│ - Sends notifications on login │
│ - Types: Won, Outbid, Sold, Expired, Claimed │
└─────────────────────────────────────────────────────────────┘
3.2 GUI Structure
GuiAuctionHouse (Base GUI - opened via Auctioneer NPC)
│
├── GuiAuction (Browse/Search auctions)
│ - Paginated item display (ContainerAuction)
│ - Next/Back page buttons
│ - Filter button → opens GuiAuctionFilter
│ - My Auctions button → opens GuiAuctionClaims
│ - Sell button → opens GuiAuctionSell
│ - Click item → SubGuiAuctionDetails
│
├── GuiAuctionSell (Create new listing)
│ - Item slot for item to sell
│ - Starting price input
│ - Buyout price input (0 = no buyout)
│ - Listing fee display
│ - Create button
│
├── GuiAuctionClaims (My Auctions / Claims)
│ - Active listings tab
│ - Pending claims tab (items + currency to collect)
│ - Cancel listing button
│ - Claim all button
│
└── GuiAuctionFilter (Filter settings)
- Search text
- Sort options (EnumAuctionSort)
- Price range (min/max)
- Show my listings only toggle
3.3 Admin GUI
GuiManageAuction (Admin tool - like ManageMagic, ManageQuests)
│
├── Active Auctions Tab
│ - View all auctions
│ - Cancel any auction (with reason)
│ - View auction details
│
├── Blacklist Tab (Stub for future)
│ - Add/remove blacklisted items
│ - Add/remove blacklisted mods
│
└── Settings Tab
- View current config values
- Quick reference for config file
3.4 Data Structures
AuctionListing
public class AuctionListing {
int id; // Unique listing ID
UUID sellerUUID; // Seller's UUID
String sellerName; // Seller's display name
ItemStack item; // Item being sold
long startingPrice; // Minimum starting bid
long buyoutPrice; // Instant buy price (0 = no buyout)
long currentBid; // Current highest bid
UUID highBidderUUID; // Current high bidder (null if no bids)
String highBidderName; // High bidder display name
int bidCount; // Number of bids placed
long createdTime; // When listing was created
long endTime; // When auction ends
EnumAuctionStatus status; // ACTIVE, ENDED, CANCELLED, CLAIMED
}
AuctionClaim
public class AuctionClaim {
int id; // Unique claim ID
UUID playerUUID; // Player who can claim
int listingId; // Related auction listing
EnumClaimType type; // ITEM, CURRENCY, REFUND
ItemStack item; // Item to claim (if type = ITEM)
long currency; // Currency to claim (if type = CURRENCY/REFUND)
long createdTime; // When claim was created
boolean claimed; // Whether claimed
}
AuctionFilter
public class AuctionFilter {
String searchText; // Item name search
EnumAuctionSort sortBy; // Sort order
long minPrice; // Minimum price filter
long maxPrice; // Maximum price filter (0 = no max)
boolean myListingsOnly; // Show only my listings
}
Enums
public enum EnumAuctionStatus {
ACTIVE, // Auction is live
ENDED, // Auction ended (winner determined)
CANCELLED, // Cancelled by seller or admin
CLAIMED // All claims processed
}
public enum EnumAuctionSort {
NEWEST, // Most recently listed
ENDING_SOON, // Ending soonest
PRICE_LOW, // Lowest current price
PRICE_HIGH, // Highest current price
MOST_BIDS // Most bid activity
}
public enum EnumClaimType {
ITEM, // Winner claims item
CURRENCY, // Seller claims sale currency
REFUND // Outbid player claims refund
}
3.5 AuctionController
Main controller handling all auction logic.
Core Methods
// Listing Management
int createListing(EntityPlayer seller, ItemStack item, long startingPrice, long buyoutPrice)
void cancelListing(int listingId, EntityPlayer player, boolean isAdmin)
List<AuctionListing> getActiveListings(AuctionFilter filter, int page, int pageSize)
AuctionListing getListing(int listingId)
int getPlayerListingCount(UUID playerUUID)
// Bidding
boolean placeBid(int listingId, EntityPlayer bidder, long bidAmount)
boolean buyout(int listingId, EntityPlayer buyer)
// Claims
List<AuctionClaim> getPlayerClaims(UUID playerUUID)
boolean claimItem(int claimId, EntityPlayer player)
boolean claimCurrency(int claimId, EntityPlayer player)
void claimAll(EntityPlayer player)
// Lifecycle
void processEndedAuctions() // Called on tick, creates claims for ended auctions
void onPlayerLogin(EntityPlayer player) // Send pending notifications
// Persistence
void save()
void load()
Auction Flow
Creating a Listing:
- Validate item not blacklisted
- Check player has listing slots available
- Deduct listing fee from player
- Remove item from player inventory
- Create AuctionListing with ACTIVE status
- Save
Placing a Bid:
- Validate auction is ACTIVE
- Validate bid > current bid + minimum increment
- Validate bidder has enough currency
- Deduct bid amount from bidder
- If previous bidder exists, create REFUND claim for them
- Update listing with new bid/bidder
- Apply snipe protection if needed
- Save
Buyout:
- Validate auction is ACTIVE and has buyout price
- Validate buyer has enough currency
- Deduct buyout amount from buyer
- If previous bidder exists, create REFUND claim
- Create ITEM claim for buyer
- Create CURRENCY claim for seller (minus sales tax)
- Set status to ENDED
- Save
Auction Ends (no buyout):
- If bids exist:
- Create ITEM claim for high bidder
- Create CURRENCY claim for seller (minus sales tax)
- If no bids:
- Create ITEM claim for seller (item returned)
- Set status to ENDED
- Save
3.6 Snipe Protection
When a bid is placed with less than SnipeProtectionMinutes remaining:
- Extend the auction end time TO
SnipeProtectionMinutesfrom now - Never extend beyond
SnipeProtectionMinutes - Default: 2 minutes
Example: Auction ends in 30 seconds, someone bids → Timer resets to 2:00
3.7 Notifications
AuctionNotification Class
public class AuctionNotification {
UUID playerUUID;
EnumNotificationType type;
int listingId;
String message;
long timestamp;
}
public enum EnumNotificationType {
AUCTION_WON, // You won an auction
AUCTION_OUTBID, // You were outbid
AUCTION_SOLD, // Your item sold
AUCTION_EXPIRED, // Your auction expired (no bids)
CLAIM_READY // You have items/currency to claim
}
Notifications are queued and sent when player logs in.
3.8 Permissions
| Permission | Default | Description |
|---|---|---|
customnpcs.auction.use |
true | Can use auction house |
customnpcs.auction.sell |
true | Can create listings |
customnpcs.auction.slots.X |
5 | Max listing slots (X = number) |
customnpcs.auction.admin |
op | Admin auction management |
4. Configuration
ConfigMarket.java Structure
// =========================================
// Market General
// =========================================
public static boolean MarketEnabled = true;
// =========================================
// Currency (Market.Currency)
// =========================================
public static boolean UseVault = false;
public static String CurrencyName = "Coins";
public static long StartingBalance = 0;
public static long MaxBalance = Long.MAX_VALUE;
// =========================================
// Trader (Market.Trader)
// =========================================
public static boolean EnableStockByDefault = false;
public static String DefaultResetType = "NONE";
// =========================================
// Auction (Market.Auction)
// =========================================
public static boolean AuctionEnabled = true;
public static int AuctionDuration = 24; // Hours
public static long ListingFee = 10; // Flat fee to create listing
public static double SalesTaxPercent = 0.05; // 5% tax on sales
public static int DefaultMaxListings = 5; // Per player
public static int SnipeProtectionMinutes = 2; // Snipe protection timer
public static int ClaimExpirationDays = 30; // Days before unclaimed items deleted
public static double MinBidIncrementPercent = 0.05; // 5% minimum bid increase
5. File Structure
New Files to Create
constants/
EnumAuctionStatus.java
EnumAuctionSort.java
EnumClaimType.java
EnumNotificationType.java
controllers/
AuctionController.java
AuctionNotification.java
controllers/data/
AuctionListing.java
AuctionClaim.java
AuctionFilter.java
roles/
RoleAuctioneer.java
containers/
ContainerAuction.java
client/gui/player/
GuiAuctionHouse.java (Base GUI)
GuiAuction.java (Browse auctions)
GuiAuctionSell.java (Create listing)
GuiAuctionClaims.java (My auctions/claims)
GuiAuctionFilter.java (Filter settings)
SubGuiAuctionDetails.java (View listing details)
client/gui/global/
GuiManageAuction.java (Admin management)
network/packets/
AuctionDataPacket.java (Server → Client data sync)
AuctionActionPacket.java (Client → Server actions)
Files to Modify
CustomNpcs.java - Initialize AuctionController
ServerTickHandler.java - Process ended auctions, login notifications
EnumRoleType.java - Add Auctioneer
EnumGuiType.java - Add auction GUI types
DataAdvanced.java - Handle Auctioneer role
PacketHandler.java - Register auction packets
CustomNpcsPermissions.java - Auction permissions
ConfigMarket.java - Add Auction section
RoleTrader.java - Add currency cost per trade
ContainerNPCTrader.java - Currency + stock integration
en_US.lang - All auction lang keys
6. Data Storage
Auction Data File
Location: customnpcs/auction.dat
Structure:
NBTTagCompound root
├── NextListingId: int
├── NextClaimId: int
├── Listings: NBTTagList
│ └── [AuctionListing NBT...]
├── Claims: NBTTagList
│ └── [AuctionClaim NBT...]
└── PendingNotifications: NBTTagList
└── [AuctionNotification NBT...]
7. Lang Keys
# Auction House
auction.title=Auction House
auction.browse=Browse
auction.sell=Sell
auction.claims=My Auctions
auction.filter=Filter
# Browse
auction.nextPage=Next >
auction.prevPage=< Prev
auction.page=Page %d of %d
auction.noResults=No auctions found
auction.refresh=Refresh
# Listing Display
auction.seller=Seller: %s
auction.currentBid=Current Bid: %s
auction.buyout=Buyout: %s
auction.timeLeft=Time Left: %s
auction.bids=%d bids
auction.noBids=No bids
# Create Listing
auction.sell.title=Create Listing
auction.sell.startingPrice=Starting Price
auction.sell.buyoutPrice=Buyout Price
auction.sell.noBuyout=(0 = no buyout)
auction.sell.fee=Listing Fee: %s
auction.sell.create=Create Listing
auction.sell.noItem=Place an item to sell
# Claims
auction.claims.title=My Auctions
auction.claims.active=Active Listings
auction.claims.pending=Pending Claims
auction.claims.claimAll=Claim All
auction.claims.cancel=Cancel Listing
auction.claims.empty=No pending claims
# Filter
auction.filter.title=Filter Auctions
auction.filter.search=Search
auction.filter.minPrice=Min Price
auction.filter.maxPrice=Max Price
auction.filter.myOnly=My Listings Only
auction.filter.apply=Apply
# Sort Options
auction.sort.newest=Newest
auction.sort.endingSoon=Ending Soon
auction.sort.priceLow=Price: Low to High
auction.sort.priceHigh=Price: High to Low
auction.sort.mostBids=Most Bids
# Notifications
auction.notify.won=You won the auction for %s!
auction.notify.outbid=You were outbid on %s!
auction.notify.sold=Your %s sold for %s!
auction.notify.expired=Your auction for %s expired with no bids.
auction.notify.claim=You have items to claim at the Auction House.
# Errors
auction.error.notEnoughCurrency=Not enough currency!
auction.error.auctionEnded=This auction has ended.
auction.error.bidTooLow=Bid must be at least %s.
auction.error.maxListings=You have reached your maximum listings.
auction.error.blacklisted=This item cannot be auctioned.
auction.error.noAuctioneer=You must visit an Auctioneer NPC.
# Trader Currency
trader.currencyCost=Currency Cost
trader.outOfStock=Out of Stock
trader.stock=Stock: %d
8. Implementation Order
Phase 1: Trader Currency Integration - COMPLETE ✅
AddcurrencyCostfield to RoleTrader tradesUpdate ContainerNPCTrader to check/deduct currencyUpdate trader setup GUI with currency inputTest with existing item trades (backward compatibility)
Phase 2: Trader Stock UI - COMPLETE ✅
Add stock display to player trader GUIShow "Out of Stock" indicatorVerify reset timers workingReal-time client-side countdownStatus messages with costsReset cooldown button with confirmation
Phase 2.5: Trader Sync System - COMPLETE ✅
Implement MarketRegistry for linked market syncViewer tracking (market-wide and local)NPC unload cleanupThread safety for stock operations
Phase 3: Auction Core
- Create enums (EnumAuctionStatus, EnumAuctionSort, etc.)
- Create data classes (AuctionListing, AuctionClaim, AuctionFilter)
- Create AuctionController with core logic
- Create RoleAuctioneer
- Add to CustomNpcs initialization
Phase 4: Auction GUI
- Create GuiAuctionHouse base
- Create GuiAuction (browse)
- Create GuiAuctionSell
- Create GuiAuctionClaims
- Create GuiAuctionFilter
- Create SubGuiAuctionDetails
- Create ContainerAuction
Phase 5: Auction Network
- Create AuctionDataPacket
- Create AuctionActionPacket
- Register packets
Phase 6: Admin & Polish
- Create GuiManageAuction
- Add permissions
- Add notifications system
- Add lang keys
- Testing
9. Design Decisions
| Decision | Choice | Rationale |
|---|---|---|
| Claims System | Everything to claims | Prevents offline handling issues |
| Auction Duration | Single config value | Simplicity over flexibility |
| Snipe Protection | Reset to X minutes | Fair bidding, prevents last-second sniping |
| Listing Fees | Flat fee only | Simple, predictable |
| Sales Tax | Percentage of sale | Scales with item value |
| Data Storage | Single .dat file | Consistent with quests/dialogs |
| Blacklist | Stub for now | Complex feature for later |
| Currency per Trade | Additive with items | Backward compatible, flexible |
10. Future Considerations (Not in 1.11)
- Category-based filtering
- Advanced blacklist system (items, mods, NBT patterns)
- Auction history/statistics
- Command-based auction access
- Auction house tax sink
- Reserve prices
- Private auctions