Auction House++
#Features
### Core Auction House
- Full GUI-based auction browser with pagination
- List items for sale with easy price formatting (`1k`, `2.5m`, `500b`, `1t`)
- Sort by newest, ending soon, lowest/highest price (persists across sessions)
- Search items via sign GUI
- Right-click any listing to add to wishlist
- Middle-click for item details + market price comparison
### Your Listings & Takeback
- View all your active listings in one place
- Take items back directly to your inventory
- Listing limits per player (configurable)
### Wishlist & Notifications
- Add items to your wishlist from the auction browser
- Get notified when someone lists a wishlisted item
- Favorite sellers and get alerts when they list new items
### Player Profiles & Ratings
- View any player's sales history and statistics
- Rate sellers (positive/negative) after purchases
- Star/favorite sellers you trust
### Price History & Market Analytics
- Track price history for any item
- View 24h market trends (rising/falling items)
- Daily market report with most sold, highest demand, top sellers
- Smart price suggestions based on market averages
### Mailbox
- Offline earnings delivered to your mailbox
- Claim money from sold items when you log back in
### Buy Requests
- Create buy requests for items you need
- Other players can fulfill them for instant trade
- Cancel your own requests anytime
### Admin Tools
- Full admin dashboard GUI
- Remove listings, blacklist items, force expire
- View transaction logs and analytics
- Reload config in-game
### Economy & Tax
- Vault-based economy (EssentialsX, CMI, etc.)
- Configurable tax system with automatic deduction
- Transaction fees displayed to sellers
---
## Commands
| Command | Description |
|---------|-------------|
| `/ah` | Open auction house browser |
| `/ah sell <price>` | List held item for sale |
| `/ah search <item>` | Search listings |
| `/ah history <item>` | View price history |
| `/ah trends` | View market trends |
| `/ah profile [player]` | View seller profile |
| `/ah wishlist` | Open your wishlist |
| `/ah mailbox` | Open your mailbox |
| `/ah stats` | View your statistics |
| `/ah buyrequest <item> <amount> <price>` | Create buy request |
| `/ah buyrequests` | Browse buy requests |
| `/ah listings` | View your listings |
| `/ahadmin` | Admin dashboard |
## Permissions
| Permission | Default | Description |
|------------|---------|-------------|
| `auctionhouse.use` | Everyone | Use the auction house |
| `auctionhouse.sell` | Everyone | List items for sale |
| `auctionhouse.buy` | Everyone | Purchase items |
| `auctionhouse.wishlist` | Everyone | Use wishlist features |
| `auctionhouse.history` | Everyone | View price history |
| `auctionhouse.stats` | Everyone | View personal stats |
| `auctionhouse.profile` | Everyone | View seller profiles |
| `auctionhouse.mailbox` | Everyone | Use mailbox |
| `auctionhouse.admin` | OP | Admin commands |
## Configuration
All settings in `config.yml`:
```yaml
# Auction duration in minutes
auction-duration: 43200
# Price limits
min-price: 1.0
max-price: 1000000000.0
# Per-player listing limit
max-listings-per-player: 14
# Wishlist limit
max-wishlist-items: 36
# Tax settings
tax-enabled: true
tax-percent: 2.0
# Ratings
ratings-enabled: true
# Blacklisted items (material names)
blacklisted-items: []
```
## Dependencies
- **Paper** 1.21.3+ (or fork) (will come for later versions)
- **Vault** with an economy plugin (EssentialsX, CMI, etc.)
## Installation
1. Stop your server
2. Place `AuctionHousePlusPlus.jar` in your `plugins/` folder
3. Start your server
4. Configure `plugins/AuctionHousePlusPlus/config.yml` to your liking
5. Use `/ah` to open the auction house!
## Data
All data is stored in YAML files inside `plugins/AuctionHousePlusPlus/`:
- `listings.yml` — Active and expired auctions
- `sales.yml` — Completed sale records
- `data.yml` — Wishlists, mail, profiles, buy requests, price history
