AuctionX

# AuctionX ## Features - **GUI-driven auction house** — browse, search, sort (newest/oldest/price) and page through listings without typing commands - **Fixed-price selling** — list an item for a price, other players buy it directly; optional confirm dialog before every buy/sell (togglable per player) - **Per-rank limits** — configurable max listings, listing duration and max price per permission-based rank; higher ranks can get better limits and (optionally) lower sales tax - **Sales & purchase history** — `/ah sold` and `/ah bought` show your last 10 transactions, with quick buttons to switch between the two - **Offline earnings** — sold while offline? Get paid automatically the next time you join - **Expired items tab** — unsold listings move to an "Expired" tab instead of disappearing, so nothing gets lost - **Admin toolkit** — reload config, browse/edit any player's listings, inspect or remove a specific listing by ID, wipe the whole auction house, maintenance mode, global sell-lock - **MySQL or SQLite** — pick your storage backend, no external database required if you use SQLite - **Fully English & fully editable** — every player-facing message lives in `messages.yml`, not buried in code - **PlaceholderAPI support** — expose live listing counts, market value and per-player stats to your scoreboard/tab plugin - **Discord webhook** — broadcast big sales to a Discord channel (configurable price threshold) - **Protection-plugin aware** — the item-search sign respects WorldGuard, GriefPrevention, Towny and other protection plugins automatically, no extra setup needed - **Optional item blacklist** — block spawners, command blocks and other classic auction-house exploit items (off by default) - **Optional sales tax** — withhold a configurable % per rank on every sale as a money sink (off by default) - **Built-in update checker** — get notified in-game and in console when a new version is available on Modrinth - **bStats metrics** — anonymous usage statistics, standard for the Modrinth ecosystem ## Commands | Command | Description | |---|---| | `/ah` | Open the auction house | | `/ah sell <price>` | List the item in your hand | | `/ah search <item>` | Search active listings | | `/ah show <player>` | View a player's listings | | `/ah selling` | View your own listings | | `/ah sold` / `/ah bought` | Your sales / purchase history | | `/ah expired` | Collect your expired (unsold) items | | `/ah settings` | Toggle sounds and (for admins) global switches | | `/ah help` | Command overview | | `/adminah reload` | Reload config.yml and messages.yml | | `/adminah edit \| menu <player>` | Browse/manage a player's listings | | `/adminah info <id>` | Inspect a listing by its ID | | `/adminah remove <id>` | Remove a listing by ID and return the item to the seller | | `/adminah clear` | Wipe the entire auction house (with confirmation) | | `/adminah update` | Manually check for a new version | ## Permissions | Permission | Default | Description | |---|---|---| | `actionhouse.use` | `true` | Use the auction house | | `ah.admin` | `op` | Access to `/adminah`, bypasses price cap, tax and blacklist | | `ah.special.vip` / `ah.special.ultra` | — | Example rank permissions, fully configurable in `config.yml` | ## Requirements - (https://www.spigotmc.org/resources/vault.34315/) - Any Vault-compatible economy plugin (e.g. EssentialsX, CMI) — Vault itself doesn't hold balances, it just bridges to one - Java 21, Spigot/Paper 1.21+ ## Configuration - `config.yml` — storage backend, rank limits, tax, blacklist, Discord webhook, update checker toggle - `messages.yml` — every message the plugin sends, in English by default, fully editable with color codes (`&`)