WolfAH
WolfAH is a highly optimized, player-driven auction house. The plugin is built on a modular storage abstraction layer with both local storage and database. Vault is required for the economy, the plugin will find a core economy like EssentialsX before using built-in system.Features
- Database Support: Configure to store saved items into a database. MySQL and MariaDB is only supported
- Configurable UpFront Taxation: Charge an upfront listing fee that can be mapped exclusively to high-value items.
- Dynamic Market Blacklist: Prevent players from listing illegal blocks and automatically ban any tool or armour piece flagged as unbreakable.
- Search by query and sort by date, price and name
Commands & Permissions
- <command> - Opens the main multi-page player auction house interface. No permission required
- <command> search <query> - Opens the main interface and search by query No permission required
- /sell <price> [amount] - Lists a specific quantity of your held item onto the market. No permission required
- /collect - Opens the page to reclaim your unsold or expired items. No permission required
- <command> reload - Instantly flushes and reloads all configuration files. wolfah.admin
- wolfah.limit.x - Permission to change the max per player for listing items on the market.
Spoiler: config.yml
Code (YAML):
settings
:
# Check update on player join (wolfah.admin)
check-update : true
# The upfront listing tax rate (%)
tax-rate : 10
# Prices at or above this number will trigger the tax rate
# Anything below this is completely free to list
tax-threshold : 100.0
# How long an item stays on the market before expiring (in hours)
# Default: 48 hours (2 days)
item-expiry-hours : 48
# If true, players can click their own listings inside /shop to take them down and return them to their inventory for free
allow-buyback : true
# The maximum number of active items a normal player can list at once
max-per-player : 5
# Automatically resize /shop inventory
dynamic-size : true
blacklist :
# Blocks any tool, weapon or armor pieve flagged as unbreakable
block-unbreakable : true
# Add the exact Material names of items you want to block from being listed
materials :
- BEDROCK
- BARRIER
- COMMAND_BLOCK
- END_PORTAL_FRAME
# All player messages
messages:
invalid-price : "&cPlease provide a valid positive price number!"
cannot-sell-air : "&cYou cannot list air on the market!"
cannot-sell-unbreakable : "&cYou cannot list unbreakable items on the market!"
material-blacklisted : "&cThe item type '%item%' has been blacklisted!"
invalid-amount : "&cInvalid amount! Choose a number between 1 and %max%"
invalid-whole-number : "&cPlease provide a valid whole number for the item amount!"
limit-reached : "&cYou have reached your maximum market limit of %limit% active listings!"
limit-reached-sub : "&7Please wait for your current items to sell or expire."
cannot-afford-tax : "&cYou cannot afford the listing fee! ($%tax%)"
tax-transaction-failed : "&cTransaction failed: Could not process listing"
sell-success : "&aSuccessfully listed x%amount% %item% for $%price%"
tax-paid-notice : "&7Paid an upfront high-value listing fee of $%tax%"
tax-free-notice : "&7This item was listed for free"
reclaimed-item : "&aSuccessfully reclaimed your expired item"
buyback-success : "&aListing cancelled! Your item has been returned to your inventory."
cannot-buy-own : "&cYou cannot purchase your own item"
cannot-afford-purchase : "&cYou cannot afford this item!"
purchase-success : "&aItem purchased successfully!"
no-expired-items : "&cYou have no expired items to collect"
type-search-query : "&aType your search query!"
# Item lore for /shop
buy-lore :
- "&4--------------------"
- "Seller : %seller%"
- "Price : $ %price%"
- ""
- "Click to purchase item"
# Stats for /shop (book)
market-stats:
enabled : true
name : "Market Statistics"
lore:
- "Current Page : %current-page%/%max-page%"
- "Total Listings : %total-listings%"
# Search button if not currently searching
search-market-button-query:
name : "&aSearch Market"
lore :
- "&7Click to type an item name"
# Search button if being searched
search-market-button-clear:
name : "&cClear Search"
lore :
- "&7Click to view all items"
# Sort button [OLDEST, NEWEST, PRICE_LOW, PRICE_HIGH, NAME]
sort-by-button:
name : "&aSort By"
lore :
- "&7%sort%"
# Show user own listing button
own-listings:
name : "&aYour listings"
lore :
- "&7Show your own listings"
sql :
# Set to true to use a database
# Leave as false to use local file storage (auction_house.yml)
enabled : false
host : "127.0.0.1"
port : 3306
database : "shop_db"
user : "root"
password : ""
# Check update on player join (wolfah.admin)
check-update : true
# The upfront listing tax rate (%)
tax-rate : 10
# Prices at or above this number will trigger the tax rate
# Anything below this is completely free to list
tax-threshold : 100.0
# How long an item stays on the market before expiring (in hours)
# Default: 48 hours (2 days)
item-expiry-hours : 48
# If true, players can click their own listings inside /shop to take them down and return them to their inventory for free
allow-buyback : true
# The maximum number of active items a normal player can list at once
max-per-player : 5
# Automatically resize /shop inventory
dynamic-size : true
blacklist :
# Blocks any tool, weapon or armor pieve flagged as unbreakable
block-unbreakable : true
# Add the exact Material names of items you want to block from being listed
materials :
- BEDROCK
- BARRIER
- COMMAND_BLOCK
- END_PORTAL_FRAME
# All player messages
messages:
invalid-price : "&cPlease provide a valid positive price number!"
cannot-sell-air : "&cYou cannot list air on the market!"
cannot-sell-unbreakable : "&cYou cannot list unbreakable items on the market!"
material-blacklisted : "&cThe item type '%item%' has been blacklisted!"
invalid-amount : "&cInvalid amount! Choose a number between 1 and %max%"
invalid-whole-number : "&cPlease provide a valid whole number for the item amount!"
limit-reached : "&cYou have reached your maximum market limit of %limit% active listings!"
limit-reached-sub : "&7Please wait for your current items to sell or expire."
cannot-afford-tax : "&cYou cannot afford the listing fee! ($%tax%)"
tax-transaction-failed : "&cTransaction failed: Could not process listing"
sell-success : "&aSuccessfully listed x%amount% %item% for $%price%"
tax-paid-notice : "&7Paid an upfront high-value listing fee of $%tax%"
tax-free-notice : "&7This item was listed for free"
reclaimed-item : "&aSuccessfully reclaimed your expired item"
buyback-success : "&aListing cancelled! Your item has been returned to your inventory."
cannot-buy-own : "&cYou cannot purchase your own item"
cannot-afford-purchase : "&cYou cannot afford this item!"
purchase-success : "&aItem purchased successfully!"
no-expired-items : "&cYou have no expired items to collect"
type-search-query : "&aType your search query!"
# Item lore for /shop
buy-lore :
- "&4--------------------"
- "Seller : %seller%"
- "Price : $ %price%"
- ""
- "Click to purchase item"
# Stats for /shop (book)
market-stats:
enabled : true
name : "Market Statistics"
lore:
- "Current Page : %current-page%/%max-page%"
- "Total Listings : %total-listings%"
# Search button if not currently searching
search-market-button-query:
name : "&aSearch Market"
lore :
- "&7Click to type an item name"
# Search button if being searched
search-market-button-clear:
name : "&cClear Search"
lore :
- "&7Click to view all items"
# Sort button [OLDEST, NEWEST, PRICE_LOW, PRICE_HIGH, NAME]
sort-by-button:
name : "&aSort By"
lore :
- "&7%sort%"
# Show user own listing button
own-listings:
name : "&aYour listings"
lore :
- "&7Show your own listings"
sql :
# Set to true to use a database
# Leave as false to use local file storage (auction_house.yml)
enabled : false
host : "127.0.0.1"
port : 3306
database : "shop_db"
user : "root"
password : ""
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
WolfAH is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1. Downloaded 20 times (via Spigot). Download it and open it directly in the game.