Conquest Auction House is a comprehensive server-side mod for Hytale that introduces a fully functional player-driven economy system. Players can buy and sell items through an intuitive custom UI, creating a dynamic marketplace for your server.
Description
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`:
```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)