A clean, fast auction house plugin built to make buying and selling simple for players and easy to manage for admins.

Features

• Clean auction house GUI with paging, sorting, filtering, and search
• Sell items directly from your hand with optional confirmation GUI
• Claims system for bought items, sold payouts, expired listings, and overflow delivery
• Seller view to browse one player’s active listings
• Sold-history view for tracking completed sales
• Admin tools for viewing history and removing/taking listings
• SQLite data storage for persistent auction data
• PlaceholderAPI support for player and global auction stats
• Discord webhook support for listing, selling, claims, cancellations, and admin actions
• Configurable prices, listing fee, slot limits, refresh cooldown, blacklist, and history access
• Automatic Modrinth update notice for admins on join
• Sound feedback across GUI actions, purchases, claims, and admin flows

Commands

• /ah|auction|foauction [<claims|search|sell|view>] [<text|price|Player>]
• /auctionadmin|foauctionadmin <history|reload|version|editor> [<Player>]

Permissions

• foauction.use Main command /ah usage.
• foauction.slots.<number|*> Amount of listings a player can have.
• foauction.admin Access to /auctionadmin and cancelling player's their listings.

Placeholders

• %foauctions_sell_limit% - Maximum listings the player can have.
• %foauctions_sell_count% - Current amount of listings the player has.
• %foauctions_expired_count% - Expired item claims waiting for the player.
• %foauctions_active_count% - Active listings the player currently has.
• %foauctions_sort_name% - Player’s current auction sort mode.
• %foauctions_filter_name% - Player’s current auction filter mode.
• %foauctions_total_sold% - Total sold-history entries for the player.
• %foauctions_total_earned% - Total money earned by the player from sold items.
• %foauctions_min_price% - Global minimum allowed listing price.
• %foauctions_max_price% - Global maximum allowed listing price.
• %foauctions_listing_fee% - Global listing fee percent.
• %foauctions_total_listings% - Total active listings in the auction house.

Dependencies

• Vault (required)
• PlaceholderAPI (Optional, only if u want to use placeholders).

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoAuction</artifactId>
  <version>3.5</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foAuction.api.AuctionApi;
import me.foesio.foAuction.api.event.ListingCreatedEvent;

AuctionApi api = Bukkit.getServicesManager().load(AuctionApi.class);
if (api != null) api.getActiveListings(0, 20);

@EventHandler
public void onListingCreatedEvent(ListingCreatedEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}