![[IMG]](http://proxy.spigotmc.org/b56473f52b81e38bdc3a658cc9d33f22602e47e1?url=http%3A%2F%2Fi.imgur.com%2FZBuSjJn.png)
Now compatible with MC 1.8 / 1.9 / 1.10 / 1.11 / 1.12
Now Free
You can see update history and update documentation on the old plugin page here
Now Free
You can see update history and update documentation on the old plugin page here
Features :
- Instant Purchases
- Listing Auction House System
- 8 Totally Customizable Categories
- Automatically Filtering Categories, Entirely Customizable Using Filters
- Search, Sort Items
- Listing Expiration Times
- Listing Fees
- Purchase Confirmation for all listings
- Items keep their Names, Enchantments, Lore, Tags....
- Admin Mode (click here to learn more about Admin Mode)
- Blacklist (click here to lean more about the blacklist)
- Support for the CrackShot plugin
- And much more !
If you have any question, feature request, error/bug report, contact me using the Discussions or via private messages
Dependencies :
- MenuBuilder API, by inventivetalent.
- Vault , by Sleaker on Bukkit.
Filters :
Filters allow you to manage automatically what goes in which category.
To create a filter on categories the auctioneer has variables to apply to a new series of items.
To add items to this list use the add tag, and remove with remove.
We will need a type of match with the tags match and dontmatch.
So far we have the filter - add:match which is looking for listings that match nothing right now.
To add onto this query lets make it search for a specific item. We can do so with the query :item and then the SPIGOT-API Material. We now have the query filter:
Code (Text):
- add:match:item:DIAMOND_SWORD
We can further this filter by adding more specific queries such as adding prices, we will use:
Code (Text):
- remove:dontmatch:price
Code (Text):
filters:
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10
If you wanted to filter diamond swords and show all wood swords you can use this to filter for that.
Code (Text):
filters:
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10
- add:match:item:WOOD_SWORD
- add:match:item:DIAMOND_SWORD
- remove:dontmatch:price:lessthan:50
- remove:dontmatch:price:morethan:10
- add:match:item:WOOD_SWORD
To show everything you can use the default add all filter here.
Code (Text):
filters:
- add:match:item:ALL
- add:match:item:ALL
Code (Text):
filters:
- add:match:customNameContains:Legendary
- add:match:customNameContains:Legendary
All types of ways of adding and removing listings to the filters.
Code (Text):
- add:match:{type}
- add:dontmatch:{type}
- remove:match:{type}
- remove:dontmatch:{type}
- add:dontmatch:{type}
- remove:match:{type}
- remove:dontmatch:{type}
Types :
- item:{material} (e.g. INK_SACK)
- item:ALL to target all items
- bukkitNameContains:{material} (e.g. STAIRS)
- enchantment:{enchantments} (e.g. ARROW_DAMAGE)
- metadata:{number} (e.g. 3)
- customNameContains:{string} (e.g. Legendary), case is not sensitive but if you want to lookup ‘Royal Bow’ white space the line must be between apostrophes such as: - 'add:match:customNameContains:Royal Bow'
- player:uuid:{Player FULL UUID} (e.g. 7ed37355-9b49-4963-ba8c-b68d3e0f138a)
- player:name:{Player Username} (e.g. Klemms)
- price:lessthan:{integer} (e.g. 10)
- price:morethan:{integer} (e.g. 25)
- price:equal:{integer} (e.g. 50)
- loreContains:{string} (e.g. Soulbound) case is not sensitive but if you want to lookup ‘Royal Bow’ (white space), the line must be between apostrophes such as: - 'remove:match:loreContains:Royal Bow'
- crackShotWeapon:{Weapon Name} (e.g. Bazooka) (Case Sensitive)
- crackShotWeapon:ALL to target all weapons
Please be very careful and test backups before implementing custom filters syntax errors will cause a reset to the configuration. If your filter adds duplicates to the category, the duplicates will be automatically removed.
Installation :
- Before your purchase be sure your server is compatible with Java 8
- Use any VAULT supported economy plugin
- Add the resources to server/plugins/
- Stop your server entirely and relaunch it
- Enjoy, if problems occur please post to the discussion before reviewing
Commands & Permissions :
/auctionhouse and /ah can be used interchangeably if another resource uses this command.
- /ah | mcauctionhouse.house | Open the auction houses default menu.
- /ah sell | mcauctionhouse.sell | Asks the player how much to list the item for in a chat prompt.
- /ah sell {price} | mcauctionhouse.sell | Lists the item the player is holding.
- /ah search {query} | mcauctionhouse.search | Opens the auction house with the search results.
- /ah [player name] | mcauctionhouse.house.others | Opens the auction house default menu for the specified player
- mcauctionhouse.admin | Allows the player to see the Admin Features in the auction house (Like the Player Listings and Admin Mode buttons)
Tips :
- Setting 'defaultToAllItemsInsteadOfCategories' to 'true' and all categories 'enableCategory' to 'false' will default the /ah view to All Offers and will replace the "Go back to categories" button with the "Your Listings button
- Setting 'seeOwnOffers' will allow players to see their own offers in the categories (Defaults to false, false means players can only see their own offers in the 'My Offers' screen)
Advanced Commands :
- /ah page {page} | mcauctionhouse.house | Shows all items for sale.
- /ah page {page} {query} | mcauctionhouse.house | Shows all items sorted by the search query.
Important Note : In the config.yml file, you should never set a Material to AIR !
Default Configuration :
Spoiler: Default Configuration
Code (Text):
# Auctioneer by Klemms, 2017
# Config Version: 1.0
# IMPORTANT
# To add apostrophes ' please add TWO apostrophes, like this '' otherwise the config file will be wiped.
# When you need to add formatting code like &e or &0 don't forget to put everything between apostrophes, like that '&eHello !'
# Most values can be set to -1 for unlimited.
# Please backup your configurations before editing filters.
# Do not set any values to AIR.
# Not fully implemented yet, do not use
language: ENGLISH
# How many hours before the listing expires.
hoursUntilRefund: 24
# How long should purchase history be kept.
keepSoldOrExpiredOfferInLogsHours: 24
# The minimum price an item can be listed for.
minimumPrice: -1.0
# The maximum price an item can be listed for.
maximumPrice: -1.0
# The price it cost a player to list an item.
moneyListingFee: 0.0
# Percentage of how much fee is taken upon the sale. (1.2 is 1.2% fee.)
percentListingFee: 0.0
# Open the menu to display all items instead of the category page.
defaultToAllItemsInsteadOfCategories: false
# Material for the background item.
backgroundMaterial: STAINED_GLASS_PANE
# Change the color of the background, Stained Glass: (8 Light Gray is invisible, 7 is a light border, 15 black borders.)
backgroundMaterialMetadata: 7
# Setting this to true will allow players to see their own items in the categories
seeOwnOffers: false
# Prevent sales during a specific game mode.
preventSurvivalModeSales: false
preventAdventureModeSales: false
preventCreativeAndSpectatorSales: true
# Set the amount of auctions players can create at once.
maximumConcurrentPlayerAuctions: -1
# Customizable categories, please view the filters page to learn how to use them.
categories:
category1:
enableCategory: true
name: '&7Category 1'
lore:
- '&7All Items'
material: BRICK
amount: 1
data: 0
filters:
- add:match:item:ALL
# Only Category 1 is displayed here, the plugin contains the 8 categories
# Config Version: 1.0
# IMPORTANT
# To add apostrophes ' please add TWO apostrophes, like this '' otherwise the config file will be wiped.
# When you need to add formatting code like &e or &0 don't forget to put everything between apostrophes, like that '&eHello !'
# Most values can be set to -1 for unlimited.
# Please backup your configurations before editing filters.
# Do not set any values to AIR.
# Not fully implemented yet, do not use
language: ENGLISH
# How many hours before the listing expires.
hoursUntilRefund: 24
# How long should purchase history be kept.
keepSoldOrExpiredOfferInLogsHours: 24
# The minimum price an item can be listed for.
minimumPrice: -1.0
# The maximum price an item can be listed for.
maximumPrice: -1.0
# The price it cost a player to list an item.
moneyListingFee: 0.0
# Percentage of how much fee is taken upon the sale. (1.2 is 1.2% fee.)
percentListingFee: 0.0
# Open the menu to display all items instead of the category page.
defaultToAllItemsInsteadOfCategories: false
# Material for the background item.
backgroundMaterial: STAINED_GLASS_PANE
# Change the color of the background, Stained Glass: (8 Light Gray is invisible, 7 is a light border, 15 black borders.)
backgroundMaterialMetadata: 7
# Setting this to true will allow players to see their own items in the categories
seeOwnOffers: false
# Prevent sales during a specific game mode.
preventSurvivalModeSales: false
preventAdventureModeSales: false
preventCreativeAndSpectatorSales: true
# Set the amount of auctions players can create at once.
maximumConcurrentPlayerAuctions: -1
# Customizable categories, please view the filters page to learn how to use them.
categories:
category1:
enableCategory: true
name: '&7Category 1'
lore:
- '&7All Items'
material: BRICK
amount: 1
data: 0
filters:
- add:match:item:ALL
# Only Category 1 is displayed here, the plugin contains the 8 categories
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- 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 — see the MC Java Mods guides for the full walkthrough.
Auctioneer : Auction House Plugin is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 8,074 times (via Spigot). Download it and open it directly in the game.