AuctionHouse 2.0.8

Native Minecraft Version:

1.13

Tested Minecraft Versions:

• 1.13
• 1.14
• 1.15

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 2.0.8



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 with a cap
• Set min and max prices
  
• Blacklist items by name, type, lore, enchants, damage and unbreakable flag
  
• Wildcard blacklisting of all items/blocks by omitting the item type and specifying lore, or enchants (can ban selling soulbound and cursed items)
• Regex blacklisting on item names with regex:<expr>
• 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
• Discord integration
• Rewriting of String UUIDs in NBT (Seller -> Buyer)
• Multi-world support with simple world grouping
• Set cooldown between listings
  
• Supports Minecraft 1.13+

Video:


Thanks to Viktor over at server.pro for the 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 plugin will take the maximum set value of the setting in the config.yml, permissions and meta.
​

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
#
# this is the locale to use (requires xx_xx.json file)
locale: en_us
# disabling this disables Meta for max listings
chatHook: true
# this is the format for currency display
decimal_format: '#,##0.00'
# enabling this will check for hacked menu items in other inventories
strict: false
# this is how often the menus should update (20 = 1 second)
updateTicks: 20

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
  preventCreative: true
  preventSpectator: true
  maxSellPrice: 100000.00
  salesTax: 0.0
  allowDamagedItems: false
  defaultMaxListings: 45
  sortOrder: 'oldest'
  announce: false
  action_bar: false
  discord: false
  discord_channel: 'auctionhouse'
  multiworld: false
  groupWorlds: false
  replaceUUIDs: false
  replacePlayerNames: false
  dropAtFeet: false
  showSeconds: true

announce:
  chat:
    listings: true
    purchases: true
  action_bar:
    listings: false
    purchases: 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]'
  block_name: 'Auction House'
  entity_name: 'Auction House'

commands:
  exit: msg %player% Exiting AuctionHouse

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

disabled-worlds: []

configVersion: 24
 

DiscordSRV Support:
This plugin currently supports DiscordSRV 1.18+ integration. To configure for DiscordSRV, you need to set discord: true in the config.yml and set the discord_channel: 'auctionhouse', where auctionhouse represents the in-game channel name you will configured in DiscordSRV's config.yml.
Usually this can be achieved by adding an additional entry into the Channels: section of DiscordSRV's config.yml using the same numeric channel as the global one. It might look something like the following with the actual number matching what is given in Discord.

Spoiler

Code (Text):

# Channel links from game to Discord
# syntax is Channels: {"in-game channel name": "numerical channel ID from Discord", "another in-game channel name": "another numerical channel ID from Discord"}
# The first channel pair specified in this config option will be the "main" channel, used for sending player joins/quits/deaths/achievements/etc
#
Channels: {"global": "123456789012345678", "auctionhouse": "123456789012345678"}
 

Known Issues:

• There is no support for drag-and-drop of items.
• There is no external database support - it uses SQLite.
• 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 Spigot version 1.13+. Features may break if used with other versions of Spigot than intended.