AGAuctions

A polished auction house and buy-order marketplace plugin for Paper and Folia servers.

AGAuctions gives your economy a true two-way market: sellers list and compete for buyers, while buyers post demand through buy orders that other players can fill.

Highlights

• AH-first flow centered around /ah
• Buy-now listings and timed auctions with bidding
• Buy orders for materials and in-hand custom items
• Offline-safe claims and collection flows
• PDC-aware custom item identity matching
• Optional strict identity and meta validation
• Item blacklisting for safer listings and buy-order creation
• Vault economy support when available
• Folia-compatible runtime support
• Modular YAML configuration system

Quick Start

Requirements

• Java 21
• Paper 1.21+ (Folia supported)

Build

# Windows
mvnw.cmd clean package

# Linux/macOS
./mvnw clean package

Install

1. Build the jar using Maven Wrapper.
2. Place the built jar in your server plugins directory.
3. Start the server once to generate plugin data and config files.
4. Edit configuration files to match your economy and GUI preferences.
5. Restart the server.

Commands

Auction House

Command	Description
/ah	Open the auction house
/ah sell [amount]	Create a buy-now listing
/ah auction [duration] [amount]	Create a timed auction listing
/ah buy	Buy a direct listing
/ah bid	Place a bid on an auction listing
/ah claim	Claim auction outcomes and settlements

Buy Orders

Command	Description
/ah orders [material	collect
/ah order [material	collect
/ah buyorder	Create a material buy order from AH flow
/ah buyorder hand	Create a buy order for the held item from AH flow
/ah buyorders	Alias of /ah buyorder
/ah buyorders hand	Alias of /ah buyorder hand
/buyorder	Legacy create command
/buyorder hand	Legacy held-item create command
/orders [material	collect

Permissions

Permission	Description	Default
buyorders.use	View and fill buy orders	true
buyorders.ah.use	Use auction house features	true
buyorders.ah.sell	Create auction listings	true
buyorders.create	Create buy orders	true
buyorders.admin	Admin controls (cancel/reload)	op

Screenshots

Auction House

Preview	Preview	Preview

Orders

Preview	Preview	Preview

Collection

Preview	Preview	Preview

Configuration

AGAuctions is configured through modular YAML files:

• config.yml: Core behavior, economy provider, item matching, AH limits
• guis.yml: GUI slots, icons, lore, labels, and layout behavior
• locale.yml: Player-facing messages and language text
• gui-feature-matrix.yml: Per-profile GUI feature toggles
• blacklisted-items.yml: Material and name restrictions
• item-groups.yml: Category-style grouping support
• webhook-dispatch.yml: Webhook templates and dispatch settings

Data Storage

• Persistence uses H2 database storage
• Data files are stored under the plugin data folder
• Legacy migration paths for older flat-file data are preserved

Release

• Version: 1.0
• Artifact: AGAuctions-1.0.jar

Support

Issues and pull requests are welcome.

When reporting a bug, include:

• Server software and version
• Java version
• Plugin version
• Reproduction steps
• Relevant logs

License

See LICENSE.