MineAuctions -----
A minecraft auction house plugin to sell your items.
MineAuctions
A fast, feature-rich Auction House for Paper 1.8 → 1.21.x with true Multi-Currency and built-in Multi-Server sync (SQL; no Redis).
Clear Product Description
A fast, feature-rich Auction House for Paper 1.8 → 1.21.x with true Multi-Currency and built-in Multi-Server sync (SQL; no Redis).
MineAuctions is an Auction House plugin designed for both single servers and networks. It focuses on performance, dupe safety, and a smooth player experience. The plugin supports multiple currencies simultaneously (Vault, PlayerPoints, GemsEconomy, CMI, or an internal fallback), and it synchronizes listings and purchases across multiple servers using lightweight SQL messaging—no Redis or message broker required. Everything is configurable, translatable, and designed to work from Minecraft 1.8 up to 1.21.x (features that don’t exist on older versions gracefully disable).
What MineAuctions Offers (Detailed)
1) High Performance & Stability
- Async database operations, cached listing pages, and minimal main-thread work.
- “Fast navigation” design: page changes, sorting, and refreshing without forced cooldowns.
- Optimized search and purchase flow to avoid lag spikes.
- Built-in SQL message bus: new listings/purchases/cancellations sync quickly across servers.
- Open GUIs refresh with live data network-wide.
- Supports MySQL (recommended) or H2 (file mode) for small setups.
- Players must select a currency when listing an item.
- Adapters for Vault, PlayerPoints, GemsEconomy, CMI; plus an internal “Credits” fallback so it works out-of-the-box.
- Per-currency display (symbol/format/precision) and PlaceholderAPI balance placeholders.
- Currency is stored with the listing to keep prices unambiguous across servers.
- /ah main: browse, paginate, filter/sort, and refresh instantly.
- Right-Click Preview (where supported): view Shulker/Barrel contents before buying (auto-disabled on versions without these blocks).
- History GUI: global or per-player history (configurable) with container previews when available.
- Mail GUI: items are safely stored if buyer inventory is full or they’re offline; claim later.
- Search Flow: search by item name, lore, material, or seller name via GUI (anvil input or chat prompt).
- Case-insensitive search over name, lore, material, and seller name.
- Sort by Date (newest/oldest), Price (asc/desc), and Currency.
- Index-friendly storage to keep searches snappy at scale.
- Atomic purchase flow: only the first valid buyer succeeds; others get “already sold”.
- Inventory checks before/after purchase; rollback + mail fallback to prevent loss/duplication.
- Heavily tested against common macro/lag dupes.
- Tiered per-player caps via permissions like mineauctions.limit.5, .10, .20 (highest wins).
- Admin override is available and persists.
- Players can check remaining slots with /ah limit.
- Sellers get paid even if offline (via supported economy).
- Buyers receive items later via /ah mail if inventory is full or they disconnect.
- Login notifications keep players informed.
- Optional notifications for new listings and purchases.
- Customizable embed titles/fields/colors; includes server name, item info, price, currency, seller/buyer.
- Block by Material, by Name/Lore (regex), or simple NBT-style predicates (e.g., CustomModelData>0 where supported).
- Clear feedback explains why an item can’t be listed.
- Use CustomModelData for GUI icons and special items on modern versions.
- Automatic fallbacks on older versions.
- %mineauctions_active% – active listings count
- %mineauctions_sales_today% – sales today
- %mineauctions_player_active% – player’s active listings
- %mineauctions_balance_<currencyId>% – player balance in a currency
- %mineauctions_recent_sale% – player’s most recent sale
- %mineauctions_server% – configured server name
- Clean YAML with comments and sensible defaults.
- Translate or rewrite all messages in messages.yml (full localization).
- Toggle features (History GUI, Anvil vs Chat search, Blacklist).
- Control page size, SQL sync polling interval, currency display formats, and more.
- Paper/Spigot forks from 1.8 to 1.21.x.
- Features requiring newer content (Shulkers 1.11+, Barrels 1.14+, CustomModelData 1.14+) auto-disable on older versions.
- No direct NMS; uses safe API calls for smoother updates.
Listing an Item
- Hold the item and run /ah sell <price> <currency>.
- Blacklist checks run; if valid, a listing is created and visible to everyone.
- The item is safely stored server-side until sold or cancelled.
- Open /ah, sort/filter/search, and select an item.
- Optional preview (shulker/barrel) via right-click on supported versions.
- On purchase, MineAuctions checks availability, reserves the item, charges the buyer in the correct currency, pays the seller, and delivers the item (inventory or /ah mail).
- Other servers are informed via SQL messaging; GUIs update quickly.
- /ah history shows global or personal sales history with timestamps, prices, and currencies.
- /ah mail stores items until the player claims them.
| Command | What it does | Permission |
| /ah | Opens the main Auction House GUI | mineauctions.use |
| /ah sell <price> <currency> | Lists the item in hand | mineauctions.sell |
| /ah search <query> | Searches by name/lore/material/seller | mineauctions.search |
| /ah history [player] | Shows own or others’ history | mineauctions.history / mineauctions.history.others |
| /ah cancel <listingId> | Cancels your listing | mineauctions.cancel |
| /ah mail | Opens Mail to claim stored items | mineauctions.mail |
| /ah limit | Shows remaining listing slots | mineauctions.limit.view |
| /ah reload | Reloads configuration files | mineauctions.admin.reload |
| /ah admin setlimit <player> <N> | Sets per-player cap | mineauctions.admin.setlimit |
| /ah admin purge [days] | Purges old sold/expired listings | mineauctions.admin.purge |
Installation & Setup
Single Server
- Place the MineAuctions jar in /plugins.
- Start the server to generate configs.
- Configure storage (H2 for quick tests; MySQL for production), currencies, and optional Discord webhooks.
- Restart or use /ah reload.
- Use the same MySQL database on each backend.
- Enable SQL messaging and set a unique serverName in each server’s config.
- Start/reload all servers; listings and purchases will sync across the network.
- storage: choose mysql or h2; configure pool sizes for performance.
- messaging: enable sync and set the polling interval.
- currencies: enable/disable adapters; set default currency and display format.
- gui: page size, anvil input for search, customizable icons (CustomModelData on 1.14+).
- blacklist: materials and regex rules to prevent problematic items.
- purge: define how many days to keep old sold/expired records.
- messages.yml: translate every message to your language/style.
- Survival/Prison/Skyblock: safe trades and flexible currencies grow player economies.
- Network Owners: cross-server sync without extra infra; scale from one to many servers.
- Events/Seasons: quick purges, sorted browsing, and Discord pings keep markets fresh.
- Community Servers: blacklist, limits, and history reduce abuse and support workload.
No. Multi-server sync uses a lightweight SQL message bus (MySQL/H2).
Yes. The internal credits fallback ensures the plugin works out-of-the-box.
Previews for Shulkers/Barrels require newer versions; MineAuctions auto-disables those previews on old versions while the AH still functions.
Transactions are atomic with strict checks and a safe mail fallback to avoid loss or duplication.
Yes. All user-facing text is in
messages.yml.
- Grant tiered caps with mineauctions.limit.5/.10/.20.
- Schedule /ah admin purge to keep the database lean.
- Keep serverName unique per backend for clear Discord notifications and easier debugging.
- Use PlaceholderAPI to surface live stats on scoreboards, menus, or holograms.
- Paper/Spigot-compatible servers: 1.8 – 1.21.x
- Database: MySQL (recommended) or H2 (file mode)
- Optional hooks: Vault, PlaceholderAPI, PlayerPoints, GemsEconomy, CMI
- No external services needed for sync
Code (YAML):
serverName : "Server-1"
language : "en_US"
storage:
type : "mysql" # mysql | h2
mysql:
host : "localhost"
port : 3306
database : "mineauctions"
user : "root"
password : ""
pool:
maximumPoolSize : 10
minimumIdle : 2
messaging:
enabled : true
pollingMillis : 750
currencies:
adapters:
vault : true
playerpoints : true
gemseconomy : true
cmi : true
internalCredits : true
defaultCurrency : "vault"
display:
format : "{symbol}{amount}" # per-currency overrides supported
limits:
default : 5
discord:
enabled : false
webhookUrl : ""
embeds:
listing:
title : "New Listing"
purchase:
title : "Item Purchased"
gui:
pageSize : 45
useAnvilForSearch : true
blacklist:
enabled : true
materials : [ "BEDROCK" ]
nameRegex : [ ]
loreRegex : [ ]
search:
caseInsensitive : true
purge:
days : 30
Code (YAML):
prefix : "&a&lMineAuctions &7» "
errors:
not_enough_space : "&cYou don't have enough inventory space."
already_sold : "&cThat listing was already purchased."
blacklisted : "&cThis item cannot be listed."
success:
listed : "&aYour item was listed for {price} {currency}."
purchased : "&aYou purchased {item} for {price} {currency}."
cancelled : "&eListing #{id} cancelled."
- BuiltByBit/SpigotMC – upload your JAR and changelogs as usual.
- Back up your database before major upgrades.
- Bug reports & feature requests: Support Portal / Discord
- Please include server version, DB type, logs, and steps to reproduce.
- One purchase = one server/network (your own). Do not redistribute or resell.
- No refunds after download (digital product).
- By purchasing/downloading, you agree to these terms and the platform’s rules.
Ready to level up your server’s economy?
Install MineAuctions today — fast, scalable, and player-friendly.
Resource Information
Author:
----------
Total Downloads:
4
First Release:
Sep 13, 2025
Last Update:
Sep 13, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings