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, 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://<server-ip>: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://<server-ip>: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