AuctionHouse 1.5.4

Native Minecraft Version:

1.13

Tested Minecraft Versions:

• 1.13

AuctionHouse 1.5.4



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:

• List items in the auction house
• View items matching a search filter based on name, type, lore, enchants, or seller
  
• Sort by newest first or chronologically
  
• 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)
  
• Internationalization Support
• Customize messages, button materials and sounds
• Support for HeadDatabase heads as buttons.
• Support for custom skull textures as buttons.
• Supports player head for the player listings button.
  
• Supports Minecraft 1.13.2+

Video:



Commands:

/ah reload - reloads the auctionhouse configuration
/ah - open the auction house
/ah menu - open the auction house (menu mode)
/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 the /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
decimal: 2
chatHook: true

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
  chronological: true

blacklist:
  '0':
    item: minecraft:bedrock
  '1':
    item: minecraft:barrier
  '2':
    item: minecraft:command_block
  '3':
    item: minecraft:structure_block
  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
[/B]
sounds:
  click: 'ui.button.click'
  fail: 'entity.villager.no'
  drop: 'entity.player.burp'

buttons:
  exit: minecraft:iron_door
  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

[/B]
configVersion: 4
 

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
An appropriate Economy Plugin
An appropriate Permissions Plugin​

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

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



It takes a lot of tasty coffee to keep cranking out quality code.
Please donate if you like my plugins...