# AuctionBridge

> Web gateway for Minecraft AuctionHouse, with a dashboard, REST API, WebSocket, and SSE. ## Features - Embedded dashboard for auction listings, statistics, and live activity - Read-only REST API for auctions, player listings, balances, and service health - WebSocket and SSE event streams - SQLite, MySQL, and MariaDB support; optional Vault economy integration - Database polling and command-audit fallbacks **Requirements:** Java 17+, Paper/Purpur/Spigot 1.16+, [HahaWebPlugin](https://modrinth.com/plugin/hahawebplugin), and an AuctionHouse-compatible SQLite/MySQL/MariaDB database. Vault and an economy provider are optional. ## Install Install HahaWebPlugin (restart once if newly installed), place `AuctionBridge-x.x.x.jar` in `plugins/`, then start the server. Configure the database in `plugins/AuctionBridge/config.yml`, restart, and open `http://:8085/`. An API key is generated on first startup; the dashboard does not require it. ## Database schema AuctionBridge does not create or migrate tables. Required columns: `id`, `world`, `seller_uuid`, `buyer_uuid`, `bidder_uuid`, `price`, `reserve`, `bid`, `listing_type`, `item`. Empty `buyer_uuid` means active; non-empty means sold. Search uses `item`, seller filtering uses `seller_uuid`. Cancelled and expired listings cannot be distinguished. Use a read-only database account where supported; relative SQLite paths resolve from `plugins/`. ## API and events Base URL: `http://:8085/api/v1` | Endpoint | Description | |---|---| | `GET /health`, `GET /info` | Public service status and server information | | `GET /auctions` | Search and page through listings | | `GET /auctions/{id}` | Get a listing | | `GET /stats` | Listing and sales totals | | `GET /players/{uuid}/balance` | Vault balance | | `GET /players/{uuid}/listings` | Player's active listings | `/auctions` parameters: `status` (`ACTIVE`, `SOLD`, `CANCELLED`, `EXPIRED`, `ALL`), `search`, `minPrice`, `maxPrice`, `sellerUuid`, `sort` (`price_asc`, `price_desc`, `id_desc`), `page`, `pageSize` (max 100). Cancelled/expired filters return no results with the schema above. Regular `/api/v1/*` routes require `X-API-Key`, except `/health` and `/info`. Public dashboard routes (`/api/dashboard/v1/*`, `/ws/dashboard/auctions`) do not require a key. WebSocket: `/ws/auctions` (authenticated); SSE: `/api/v1/stream` (authenticated). ## Commands and build `/ab status` · `/ab reload` (restart after database/host/port changes) · Permission: `auctionbridge.admin` (operators by default) · Build: `mvn clean package` → `target/AuctionBridge-x.x.x.jar`

AuctionBridge

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

AuctionBridge Market Monitor