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)

Conquest Auction House