EnesAuction — Advanced Auction System (Paper / Folia / Purpur)
What is EnesAuction?
EnesAuction is a Paper-compatible (API
Who should download EnesAuction?
• Server owners who want a fully-featured auction house for their players.
• Staff who need a database-backed transaction system with complete history.
• Anyone searching for: Minecraft auction plugin, auction house, player marketplace, Paper 1.21 auction, Folia auction plugin
Complete feature list
Commands & Aliases
•
•
•
•
•
•
•
Auction System
• List Items: Put items up for auction with custom pricing via an interactive sign editor (no chat prompts).
• Buy Items: Browse the global auction list and purchase items instantly or with a confirmation GUI.
• Fast Buy/Sell: Toggle modes to skip confirmation dialogs for quicker transactions.
• Shulker Box Preview: Right-click any shulker box in the auction list to preview its contents!
• Your Items: View and manage all your active and expired listings in a dedicated paginated GUI.
• Cancel Auctions: Remove your active listings at any time — items are returned to your inventory.
• Collect Expired Items: Expired auctions are stored safely; collect them from the Your Items GUI.
• Sign Input: Enter prices and search queries via an interactive sign GUI (no chat prompts needed).
• Abbreviation Support: Type
• Transactions History: Full purchase and sales history with stats (total spent / total made).
• Item Search: Search all active auctions by item name, with sort (price, date) and filter (by category) options.
GUI Menus (
• Fully configurable GUI titles, button names, materials, slots, and lore!
•
•
•
•
•
•
•
• All GUI slot numbers are read from their respective YAML files — fully customisable!
Economy & Data
• Vault Optional: Vault is loaded if present but not required.
• 3 Provider Modes: Choose
• SQLite (
• Folia-compatible periodic expire checks — expired auctions are automatically detected.
• Transaction return values are always checked — no lost items or money.
• Economy abbreviations with configurable suffixes for compact display.
• Price Limits: Configurable min/max price for listings.
• Auction Duration: Configurable listing duration in hours.
• Fee System: Optional percentage-based listing fee.
Example config.yml setup for a custom economy plugin:
Write a class with a no-arg constructor containing these methods:
Permissions
•
•
•
•
Customisation
•
•
•
•
• Configurable Sounds: 8 independent sounds — click, navigate, inventory-full, reload, item-sold, item-bought, blacklisted, and gui-open.
• Auction Announcements: Optionally broadcast new listings to the server with a fully customisable message.
• Item Blacklist: Block specific items from being sold on the auction house.
Compatibility
• Declared
• Code base optimized to support Paper, Folia, and Purpur servers seamlessly!
What is EnesAuction?
EnesAuction is a Paper-compatible (API
1.21+), Folia-supported, and Purpur-friendly Minecraft plugin that provides a complete player-to-player auction system. Players can list items for sale, set custom prices, buy items from others, and manage their listings — all through an intuitive GUI with sign-based price input!Who should download EnesAuction?
• Server owners who want a fully-featured auction house for their players.
• Staff who need a database-backed transaction system with complete history.
• Anyone searching for: Minecraft auction plugin, auction house, player marketplace, Paper 1.21 auction, Folia auction plugin
Complete feature list
Commands & Aliases
•
/ah (or /auction) — Opens the main auction GUI.•
/ah sell <price> — Quickly list the item in your hand.•
/ah view <player> — Browse a specific player's auctions.•
/ah search <query> — Search auctions by item name.•
/ah reload — Reload configs, languages, sounds, and GUIs (requires auction.admin).•
/ahfastbuytoggle — Toggle instant buy without confirmation.•
/ahfastselltoggle — Toggle instant selling without confirmation.Auction System
• List Items: Put items up for auction with custom pricing via an interactive sign editor (no chat prompts).
• Buy Items: Browse the global auction list and purchase items instantly or with a confirmation GUI.
• Fast Buy/Sell: Toggle modes to skip confirmation dialogs for quicker transactions.
• Shulker Box Preview: Right-click any shulker box in the auction list to preview its contents!
• Your Items: View and manage all your active and expired listings in a dedicated paginated GUI.
• Cancel Auctions: Remove your active listings at any time — items are returned to your inventory.
• Collect Expired Items: Expired auctions are stored safely; collect them from the Your Items GUI.
• Sign Input: Enter prices and search queries via an interactive sign GUI (no chat prompts needed).
• Abbreviation Support: Type
1k (=1,000), 1m (=1,000,000), 1b (=1,000,000,000), or 1t (=1,000,000,000,000) for quick price entry.• Transactions History: Full purchase and sales history with stats (total spent / total made).
• Item Search: Search all active auctions by item name, with sort (price, date) and filter (by category) options.
GUI Menus (
gui/*.yml)• Fully configurable GUI titles, button names, materials, slots, and lore!
•
main.gui.yml — The global auction market with sort, filter, search, and pagination.•
my.items.gui.yml — Manage your own active and expired listings.•
insert.item.gui.yml — Place items into the auction system.•
confirm.listing.gui.yml — Review price and confirm before listing.•
confirm.purchase.gui.yml — Confirm before buying an item.•
transactions.gui.yml — View your purchase and sales history with stats.•
shulker.view.gui.yml — Preview shulker box contents before buying.• All GUI slot numbers are read from their respective YAML files — fully customisable!
Economy & Data
• Vault Optional: Vault is loaded if present but not required.
• 3 Provider Modes: Choose
VAULT, AUTO, or CUSTOM (define your own economy class).• SQLite (
data.db) with proper journaling for safe concurrent access.• Folia-compatible periodic expire checks — expired auctions are automatically detected.
• Transaction return values are always checked — no lost items or money.
• Economy abbreviations with configurable suffixes for compact display.
• Price Limits: Configurable min/max price for listings.
• Auction Duration: Configurable listing duration in hours.
• Fee System: Optional percentage-based listing fee.
Example config.yml setup for a custom economy plugin:
Code:
economy:
provider: CUSTOM
custom-class: 'com.example.MyEconomy'getBalance(OfflinePlayer) → double, has(OfflinePlayer, double) → boolean, withdraw(OfflinePlayer, double) → boolean, deposit(OfflinePlayer, double) → boolean. Drop your jar in plugins/, set the full class name, and run /ah reload.Permissions
•
auction.admin — Bypass all limits, use /ah reload.•
auction.<number> — Maximum auction slots (e.g. auction.5 = 5 slots, up to 44).•
auction.fastbuy — Allows using fast-buy toggle.•
auction.fastsell — Allows using fast-sell toggle.Customisation
•
lang.yml: 100% customisable messages, supporting hex color codes (&#RRGGBB).•
config.yml: Configure economy, auction duration, fees, price limits, blacklist, sign GUI prompts, sounds, and more.•
sound.yml: Configure all click, buy, sell, and error sounds with namespaced keys.•
gui/*.yml: Configure every GUI layout, slot positions, button names, and lore — all slot numbers and materials are read from YAML files.• Configurable Sounds: 8 independent sounds — click, navigate, inventory-full, reload, item-sold, item-bought, blacklisted, and gui-open.
• Auction Announcements: Optionally broadcast new listings to the server with a fully customisable message.
• Item Blacklist: Block specific items from being sold on the auction house.
Compatibility
• Declared
api-version: '1.21' and folia-supported: true in plugin.yml.• Code base optimized to support Paper, Folia, and Purpur servers seamlessly!
