BidVault

# BidVault ## A Player Auction House That Actually Works Out of the Box Most auction house plugins need Vault. They need an economy plugin. They need a database. They need a half-hour of config before a single player can list an item. And then when something updates, half the dependencies break. BidVault needs a .jar file. Drop it in your plugins folder. Restart the server. Type /ah. You now have a working auction house with its own economy, its own currency, its own GUI, its own search system. No Vault. No EssentialsX Economy. No database setup. No external economy plugin at all. Players list items. Other players buy them. Money moves. Everything is stored in JSON files that you can read, edit, and back up with a text editor. That's it. If you WANT to use Vault later, you can — BidVault's economy is designed to be swappable. But you don't need it to start. --- ## What Your Players Experience ### Listing an Item Player holds the item they want to sell. Types `/ahsell 500`. The item disappears from their hand and appears in the auction house. Done. That's the whole flow. No signs to click. No chest shops to build. No commands to memorize beyond one. Hold item, type price, done. If a player lists something by accident or changes their mind, they can pull it back from their personal listings screen. The item goes to their collection box. ### Buying an Item Player types `/ah`. A chest GUI opens showing 28 listings per page with full pagination at the bottom. They click an item, see all its details — name, enchantments, lore, seller, price, time remaining — and hit the green confirmation glass to buy. The confirmation screen exists for one reason: misclicks. Nobody wants to accidentally spend 50,000 coins on a dirt block because they double-clicked. The extra click takes half a second and saves a support ticket. When someone buys an item: - The buyer gets the item instantly - The seller gets the money minus the configurable sales tax - The seller gets a real-time notification (chat + sound) if they're online - If the seller is offline, the money sits in their balance for when they log back in ### The Collection Box Expired listings, sold items (if a deposit mechanism is added later), and cancelled listings all go to a personal collection box. Open it with `/ahcollect`. Items sit there until the player picks them up. This prevents the "I lost my item because the listing expired" problem that plagues plugins with hard-delete expiration. Nothing gets deleted. It gets collected. ### Searching and Filtering This is where BidVault earns its keep over simpler shop plugins. **9 item categories:** - All - Weapons (swords, axes, tridents, bows, crossbows) - Armor (helmets, chestplates, leggings, boots, shields) - Tools (pickaxes, shovels, hoes, shears, fishing rods) - Blocks (all placeable blocks) - Food (edible items) - Potions (potions, splash potions, lingering potions) - Enchanted (any item with enchantments) - Miscellaneous (everything else) **6 sorting modes:** - Newest first - Oldest first - Price low to high - Price high to low - Name A to Z - Name Z to A **Live search:** Type `/ahsearch diamond sword` and the GUI filters to matching listings in real time. Search works within the current category filter, so a player can select "Weapons," then search "sharpness" to find all Sharpness swords. Search clears automatically when the GUI closes so the next player who opens the auction house starts fresh. Configurable — you can disable this if your server prefers persistent search. The category buttons, sort buttons, and pagination controls are all baked into the GUI. Players figure it out without reading anything. The interface explains itself through icons and item labels. --- ## The Built-in Economy BidVault ships with its own economy system. Here's what it handles: - **Starting balance**: Configurable. New players get money automatically when they first interact with the economy. - **Player-to-player payments**: `/pay <player> <amount>` — direct transfers - **Balance checking**: `/balance` for yourself, `/balance <player>` for others - **Admin economy control**: `/eco set|give|take <player> <amount>` for full balance management - **Sales tax**: Configurable percentage taken from every sale. The tax amount goes nowhere — it's removed from circulation. Built-in money sink. - **Price bounds**: Set minimum and maximum listing prices to prevent abuse (0-cost listings, trillion-dollar scams) All balances persist across server restarts in `economy.json`. The file format is plain JSON — you can read it, script against it, or migrate data manually if needed. If you already have Vault + an economy plugin running, BidVault can integrate through Vault as well. But the point is that you don't NEED Vault. Most small-to-medium servers don't need the complexity. BidVault keeps things self-contained. --- ## Performance & Architecture Everything is server-side. No client mods. No r