AuctionHouse 1.8.0

Native Minecraft Version:

1.13

Tested Minecraft Versions:

• 1.13
• 1.14

for the 1.12.2 version click here: https://www.spigotmc.org/resources/auctionhouse-legacy.66670/
for the 1.8.8 version click here: https://www.spigotmc.org/resources/auctionhouse-retro.69278/

AuctionHouse 1.8.0



Overview:
AuctionHouse allows players to list items for sale on an auction house accessible with the /ah command. The plugin is new code and only shares a similar look and feel as the inactive plugin resource AuctionHouse.



Features:

• FREE!
  
• List items in the auction house
• View items matching a search filter based on name, type, lore, enchants, or seller
  
• Sort chronologically or by price
  
• Show items you are selling
• Cancel items
  
• Collect cancelled/expired items
• Drop unclaimed items at player's feet
• Automatically clean up abandoned items
  
• Show and clear recently sold items
  
• Hover over item to show time remaining and enchants
• Charge a flat and/or percentage based fee for listing an item (with confirmation menu)
• Tax sellers a percentage of revenue for each sale
• Blacklist items by name, type, lore and enchants
• Wildcard blacklisting of all items/blocks by omitting the item type and specifying lore, or enchants (can ban selling soulbound and cursed items)
• Optional Back/Exit button calls a command to return to another menu
  
• Click on a special sign to open the auction house
• Click on certain named block entities to open the auction house (chests, shulker boxes, dispensers, droppers, hoppers, furnaces, enchanting tables, brewing stands)
• Click on custom named entities to open the auction house
• Console command support for custom menu and NPC plugins
  
• Internationalization Support
• Customize messages, button materials and sounds
• Support for HeadDatabase heads as buttons with hdb:<id>
  
• Support for custom skull textures as buttons with texture:<base64 data>
  
• Supports player head for the player listings button with auctionhouse player_head
  
• Logging all transactions to separate log file
• Announce listings to all players
• Multi-world support with simple world grouping
• Supports Minecraft 1.13.2 and 1.14.3

Video:



Commands:

/ah reload - reloads the auctionhouse configuration
/ah - open the auction house
/ah <player> - open the auction house for a player (console only)
/ah menu - open the auction house in menu mode
/ah menu <player> - open the auction house in menu mode for a player (console only)
/ah search <filter> - view items matching search filter
/ah help - show help for all the commands
/ah sell <price> - sell the item you are holding in hand
/ah selling - view the items you are selling
/ah sold - view the items you have sold recently
/ah expired - view your expired items to return
/ah cancel - cancel all your auctions
/ah return - return all your cancelled/expired items
​

Permissions:

auctionhouse.reload - enables reloading the plugin
auctionhouse.use - enables /ah command
auctionhouse.menu - enables /ah menu command
auctionhouse.search - enables /ah search command
auctionhouse.help - enables /ah help command
auctionhouse.sell - enables /ah sell command
auctionhouse.selling - enables /ah selling command
auctionhouse.sold - enables /ah sold command
auctionhouse.expired - enables /ah expired command
auctionhouse.cancel - enables /ah cancel command
auctionhouse.return - enables /ah return command
auctionhouse.cancel.others - enables cancelling other's auctions
auctionhouse.auctions.# - sets maximum listings*

*Note: the preferred method for setting maximum listings is to use player meta if your permissions plugin supports it.
Meta will superceded permission settings if set for a user or a user's group. Also, permissions will supercede the defaultMaxListings value set in the config.
​

Meta:

auctions - sets the number of auctions a player can list​

To use meta, you need to have a compatible permissions plugin that supports setting and removal of meta such as PermissionsEx or LuckPerms.

For PermissionsEx use:

/pex user <user> set auctions <value>
/pex group <group> set auctions <value>
​

For LuckPerms use:

/lp user <user> meta set auctions <value>
/lp group <group> meta set auctions <value>​

For GroupManager use:

/manuaddv <user> auctions <value>
/mangaddv <group> auctions <value>​

Configuration:

Spoiler

Code (Text):

#
# AuctionHouse config.yml
#
locale: en_us
chatHook: true
decimal_format: '#,##0.00'
strict: false

auction:
  listingPrice: 0.0
  listingRate: 0.0
  # listingDuration is how long an item can be listed
  listingDuration: 7d0h0m
  # expiredDuratin is how long an item shows as expired
  expiredDuration: 14d0h0m
  # unclaimedDuration is how long an item will be kept
  # it will try to return unclaimed items automatically
  unclaimedDuration: 90d0h0m
  # cleanupDuration is how often items will be destroyed
  # once they are past the unclaimedDuration
  cleanupDuration: 0d24h0m
  # soldDuration is how long sold items will be kept
  soldDuration: 365d0h0m[/B]
  preventCreative: true
  preventSpectator: true
  maxSellPrice: 100000.00
  salesTax: 0.0
  allowDamagedItems: false
  defaultMaxListings: 45
  announce: false
  sortOrder: oldest
  multiworld: true
  groupWorlds: false

blacklist:
  '0':
    item: minecraft:bedrock
  '1':
    item: minecraft:barrier
  '2':
    item: minecraft:command_block
  '3':
    item: minecraft:structure_block
  '4':
    item: egg
    unbreakable: true
  '5':
    item: iron_sword
    damage: 1
  example:
    # color codes need to be specified with \u00a7
    # instead of the & character
    name: \u00a7cVorpal Sword
    item: minecraft:diamond_sword
    lore:
    - Special Item
    - Does not list in AuctionHouse
    enchantments:
    - ench: minecraft:sharpness
      level: 10
    - ench: minecraft:unbreaking
      level: 3
    - ench: minecraft:looting
      level: 3
    - ench: minecraft:fire_aspect
      level: 2
  '5':
    lore:
    - \u00a78 Item is soul bound

sounds:
  click: 'ui.button.click'
  fail: 'entity.villager.no'
  drop: 'entity.player.burp'

buttons:
  exit: 'texture:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNTI5NDg4MWYzMzQwOGU4OTY0ZDI1NWZkOGViMjFhZTY5ODhiMmNjYTg5OTRkMTU3OTk5NmE2ZjEzMmJjNDI5YyJ9fX0=\'
  back: 'minecraft:iron_door'
  previous: 'minecraft:paper'
  sort_listings: 'minecraft:sunflower'
  next: 'minecraft:paper'
  info: 'minecraft:book'
  howto: 'minecraft:emerald'
  return_all: 'minecraft:flower_pot'
  player_listings: 'auctionhouse:player_head'
  expired_listings: 'minecraft:poisonous_potato'
  sold_items: 'minecraft:gold_ingot'
  clear: 'minecraft:barrier'
  confirm: 'minecraft:lime_stained_glass_pane'
  cancel: 'minecraft:red_stained_glass_pane'

triggers:
  sign: '[AuctionHouse]'
  name: '[AuctionHouse]'

commands:
  exit: msg %player% Exiting AuctionHouse

log:
  listed: true
  sold: true
  cancelled: true
  returned: true
  dropped: true
  purged: true

configVersion: 13
 

Known Issues:

• There is no support for drag-and-drop of items.
• There is no database support
• Users should supply localized translation files
• Per user maximum listings are not supported by all permissions plugins, and may require additional configuration

Dependencies:

• Vault (version 1.5+)
• An appropriate Economy Plugin
• An appropriate Permissions Plugin

Terms of Service:
The plugin is provided AS-IS.

Please report all issues by starting a conversation. If you post in the discussion forum, it may get overlooked as we are getting more discussion now.

Disclaimer:
This plugin currently supports version 1.13.2 and 1.14. Features may break if used with other versions of Minecraft than intended.


I have to admit, I'm quite the coffee addict. I can not survive without a decent French Roast these days, so if you have the means, please donate to my ongoing caffeine habit. It makes the coding that much more bearable...