Conquest Auction House

Core Features

1. Auction House System

• **Persistent Listings** - All auction listings are saved to JSON and persist across server restarts

• **Item Previews** - Visual item icons with quantity indicators

• **Seller Information** - Each listing displays the seller's username with reputation badges

• **Pricing System** - Flexible pricing with configurable maximum limits

• **Metadata Support** - Preserves item durability, enchantments, and custom data

• **Smart Filtering** - Search by item name, seller, or filter by favorites

• **Dual View Modes** - Switch between List View (6 items/page) or Grid View (12 items/page)

• **Price Intelligence** - Real-time price comparison tooltips showing percentage vs market average

2. Wallet & Economy System

• **Per-Player Wallets** - Each player has a persistent coin balance

• **Automatic Transactions** - Instant coin transfers on purchases

• **Balance Persistence** - Wallet data saved in JSON format

• **Player-to-Player Transfers** - Send coins directly to other players

• **Admin Controls** - Add/remove coins from any player's wallet

• **Overflow Protection** - Integer overflow prevention on deposits

3. Market Intelligence Dashboard

• **Live Market Stats** - Real-time display of:

• Active Listings count

• Total Sales processed

• Total Volume traded (in coins)

• **Price History Tracking** - Automatic average price calculation for each item type

• **Market Trends** - Visual indicators for items priced above/below market average

4. Notification System

• **Real-Time Alerts** - 5 notification types:

• **Sale** - When your item sells

• **Purchase** - When you buy an item

• **Alert** - Price alerts on favorite items

• **Expired** - When your listing expires

• **Payment** - When you receive coins

• **Notification Center** - Badge counter showing unread notifications

• **Smart Storage** - Auto-cleanup (max 50 notifications per player)

• **Persistent Data** - Saved in notifications.json

5. Seller Reputation System

• **Automatic Badge System** - 6 reputation tiers based on total sales:

• 🔲 **[NEW]** - 1-9 sales (gray)

• 🟨 **[ACTIVE]** - 10-49 sales (yellow)

• 🟩 **[EXPERIENCED]** - 50-99 sales (green)

• 🔷 **[TRUSTED]** - 100-499 sales (cyan)

• 🟪 **[MASTER]** - 500-999 sales (purple)

• 🟨 **[LEGENDARY]** - 1000+ sales (gold)

• **Seller Stats Tracking** - Total sales count and total revenue earned

• **Persistent Data** - Saved in seller_stats.json

6. Collection Box System

• **Safe Item Storage** - Items from purchases/cancellations stored securely

• **Persistent Collection** - Survives server restarts

• **Badge Counter** - Visual indicator of items waiting for collection

• **Quick Access** - One-click collection from main UI

• **Inventory Protection** - Items safely stored if inventory is full

7. Transaction History

• **Complete Logs** - Track all purchases and sales

• **Detailed Records** - Item, price, buyer, seller, timestamp

• **Player-Specific View** - See only your own transactions

• **Persistent Storage** - Saved in transactions.json

8. Favorites System

• **Bookmark Items** - Mark items for quick filtering

• **Quick Filter** - One-click to view only favorite items

• **Price Alerts** - Get notified when favorite items are listed

• **Persistent Data** - Saved in favorites.json

Custom User Interface

Five Dedicated UI Pages

**1. Auction Browser**

• Market Stats Bar (Active/Sales/Volume)

• Quick Actions Bar (Refresh, Favorites, Collection, Notifications, View Toggle)

• Paginated item display (6 or 12 items per page based on view mode)

• Real-time balance display

• Search functionality for items and sellers

• Sort options (Newest, Price: Low to High, Price: High to Low)

• Buy/Cancel buttons contextual to ownership

• Price comparison tooltips

• Seller reputation badges

Commands

layer Commands

| Command | Description | Permission |

|---------|-------------|------------|

| /hdv | Opens the auction house browser | Default |

| /hdv collect | Collect all items from your collection box | Default |

| /auction | Alias for /hdv | Default |

| /auctionhouse | Alias for /hdv | Default |

| /balance | Check your coin balance | Default |

| /pay <player> <amount> | Send coins to another player | Default |

### Admin Commands

| Command | Description | Permission |

|---------|-------------|------------|

| /coins add <player> <amount> | Add coins to a player's wallet | OP |

| /coins remove <player> <amount> | Remove coins from a player's wallet | OP |

| /coins set <player> <amount> | Set a player's coin balance | OP |

Data Persistence

All data is stored in JSON format at:

C:\Users\[Username]\AppData\Roaming\Hytale\UserData\Mods\

**Data Files:**

• auctions.json - Active auction listings

• wallets.json - Player coin balances

• transactions.json - Transaction history

• collection_box.json - Unclaimed items

• favorites.json - Player favorite items

• seller_stats.json - Seller reputation data

• price_history.json - Market price averages

• notifications.json - Player notifications

• config.json - Plugin configuration

Configuration

Default settings in config.json:

{

"maxListingPrice": 1000000,

"maxActiveListings": 10,

"listingDuration": 604800,

"listingFee": 10

}

**Configuration Options:**

• maxListingPrice - Maximum price per listing (default: 1,000,000 coins)

• maxActiveListings - Maximum listings per player (default: 10)

• listingDuration - Listing duration in seconds (default: 604,800 = 7 days)

• listingFee - Fee to create a listing (default: 10 coins)