What is Akarian Auction House?
Akarian Auction House is a plugin for your Spigot/Paper servers that allows players to create auctions for items and manage them. Akarian Auction House was created with the vision of an open source Auction House plugin that is fully customizable to an administrators liking while containing many features. This plugin allows you to customize the layout of your auction house, edit the in-game messages, edit default settings, and much more.
Wiki https://akarians-docs.gitbook.io/wiki/
Support & Discord Server If you are having issues with the plugin or just have some questions, join our discord server (https://discord.gg/KmakDJgCd8). Here will you not only be able to get fast support, you will also be able to get early releases of upcoming features, participate in polls to give your input on features, and much more.
Plugin Requirements This plugin Requires an Economy plugin and Vault to be able to function properly. If not installed the plugin will shutdown.
This plugin also utilizes Citizens and PlaceholderAPI as optional addons, but they are not required.
Features
Customizable Auction House layouts that you can switch in-between!
Sync your listings across servers with a MySQL Database
Individual player and server wide settings.
The ability to search listings for the name of the item or by the seller with a customizable tag (seller:).
Sort listings by the Overall Price, Price per Item, Amount of Items, and Time Left. Alternate between sorting by clicking the left mouse button for Highest and the Right Mouse Button for Lowest.
Edit the price or the amount of items on your active listings.
Preview Shulker Boxes before buying.
Automatically transfer data between a file database and your MySQL Databse in-game.
An AdminMode on the AuctionHouse with permission (auctionhouse.manage).
Limit the amount of listings a player can post to the Auction House with "auctionhouse.listings.#"
PlaceholderAPI support and Citizens' Traits integration.
** Commands **
AuctionHouse Command
Usage: /ah Description: Open the Auction House Permission: None
List Command
Usage: /ah list Aliases: "create", "c", "l", "sell" Description: Create an Auction House listing Permission: auctionhouse.list
Search Command
Usage: /ah search Description: Open the AuctionHouse Menu with a pre defined search. Permission: auctionhouse.search
Expired Command
Usage: /ah expired Description: Open and reclaim expired listings. Permission: auctionhouse.expired
Settings Command
Usage: /ah settings Description: View and edit your AuctionHouse settings. Permission: auctionhouse.settings
Admin Commands
Admin Menu Command
Usage: /aha Description: Open the AuctionHouse Admin Menu Permission: auctionhouse.admin.manage
Admin Help Command
Usage: /aha help Description: Displays Admin Commands Permission: auctionhouse.admin.help
Reload Command
Usage: /aha reload [messages/config] Aliases: "rl" Description: Reload plugin files with optional messages or config only. Permission: auctionhouse.admin,reload
Update Command
Usage: /aha update [enable/disable/toggle] Description: Check for plugin updates or toggle. Permission: auctionhouse.admin.update
Database Command
Usage: /aha database Description: Manage database. Permission: auctionhouse.admin.database
Admin Settings Command
Usage: /aha settings Description: Manage the default player and server settings. Permission: auctionhouse.admin.settings
All Permissions
permissions
auctionhouse.help:
description: Auction House help command.
default: true
auctionhouse.list:
default: false
description: Auction House List command.
auctionhouse.use:
default: true
description: Allow the opening of the Auction House.
auctionhouse.delay.bypass:
default: op
description: Bypass the delay in-between listings.
auctionhouse.search:
default: true
description: Search the Auction House.
auctionhouse.expired:
default: false
description: View your expired Listings.
auctionhouse.listings.#:
default: false
description: Limit the amount of listings a player can have.
auctionhouse.settings:
default: false
description: View your expired Listings.
auctionhouse.admin:
default: op
description: Auction House Admin command.
auctionhouse.admin.help:
default: op
description: Auction House Admin help menu.
auctionhouse.admin.update:
default: false
description: Auction House Admin update command.
auctionhouse.admin.database:
default: false
description: Auction House Admin database command.
auctionhouse.admin.reload:
default: false
description: Auction House Admin reload command.
auctionhouse.admin.settings:
default: false
description: Edit Auction House server and default player settings.
auctionhouse.admin.npc:
default: false
description: Edit the Auction House NPCs.
auctionhouse.admin.edit
default: op
description: Allow for the editing of Auction House layouts.
auctionhouse.salestax.<percent>:
default: 7
description: Apply a custom sales tax different from the default.
Images
images
Auction House Editor
Auction House confirm listing
Auction House Listing
Auction House Own Listing
Auction House Edit Listing (Price and Amount Edit)
Auction House Shulker Item
Auction House Shulker Preview
Auction House Admin Menu
Auction House Admin Listing Edit
Sort Menu (Left & Right click to alternate)
Files
config.yml
Prefix: '&6&lAuctionHouse'
Debug: false
database: MYSQL
updates: true
Minimum Listing: 10.0
Maximum Listing: 1.0E9
Listing Delay: 10
Listing Time: 86400
Listing Fee: 0%
Default Player Settings:
Admin Mode: false
Expire Notify: false
Expire Time: 300
Bought Notify: false
Create Notify: true
Auto Confirm Listing: false
Creative Listing: false
MySQL:
Connection:
Host: localhost
Port: 3306
Username: akarian
Password: akarian
Database: akarian
Tables:
Listings: ah_listings
Completed: ah_completed
Expired: ah_expired
Users: ah_users
UUID Bypass: false
Sales Tax: 7%
Spacer Item: GRAY_STAINED_GLASS_PANE
Auction House Refresh Time: 1
Version: 1
messages.yml
Messages:
Syntax:
List: /ah list <price>
Search: /ah search <query>
Errors:
Player: '&cYou must be a player to execute this command.'
List:
No Item: '&cYou must be holding an item.'
Invalid Price: '&cThe price must be above $0.'
Listing Doesnt Exist: '&cThat listing no longer exists.'
Too Poor: '&cYou do not have enough money to purchase that.'
Prefix Icon: »
Listing:
Bought:
Buyer: '&fYou have bought &e%item%&f for &2%price%&f.'
Creator: '&c%buyer%&f has bought &e%item%&f for &2%price%&f.'
Removed: '&fYour listing for &e%item%&f has been removed.'
Create: '&fYou have created an auction for &e%item%&f with the price of &2%price%&f.'
Expired Join Message: '&fYou have &e%amount%x Expired Listings&f waiting for you
to reclaim. Use &7&o/ah expired&f to reclaim.'
Minimum Listing: '&cYour listing price is too low! It must be above %price%.'
Maximum Listing: '&cYour listing price is too high! It must be below %price%.'
Cooldown Timer: '&eYou have %time% remaining before you can make another listing.'
Max Listings: '&cError! You can only have a maximum of %max% listings.'
Expired Reclaimed: '&fYou have reclaimed your listing of &e%item%&f.'
Safe Remove: '&fYou have successfully removed the listing of &e%item%&f.'
Settings:
Admin Mode:
Name: '&eAdmin Mode'
Lore:
- '&7Open the auction house in admin mode automatically.'
- '%status%'
Expiration Notification:
Name: '&eNotify when near expiration'
Lore:
- '&7Notify you when an auction is about to expire.'
- '%status%'
Message: '&e%seller%&f''s listing of &e%listing% &fis about to expire in &e%time%&f.'
Expiration Time:
Name: '&eWhen to notify'
Lore:
- '&7Select how long an auction should have'
- '&7left before you are notified.'
- '&7Currently: &e%time%'
Message: '&eEnter how many seconds should be left on an auction before you are
notified. '
Listing Bought:
Name: '&eNotify when bought'
Lore:
- '&7Notify you when an auction is bought.'
- '%status%'
Message: '&e%buyer%&f has bought &e%seller%&f''s listing of &e%listing%&f for
&2$%price%&f.'
Listing Created:
Name: '&eNotify when created'
Lore:
- '&7Notify you when an auction is created.'
- '%status%'
Message: '&e%seller%&f has created a listing for &e%listing%&f for &2$%price%&f.'
Auto Confirm:
Name: '&eAutomatically confirm listings'
Lore:
- '&7Automatically confirm the creation of your listing.'
- '%status%'
Listing Fee:
Name: '&eListing Fee'
Message: '&eEnter the new listing fee or left click to cancel.'
Lore:
- '&7Change the listing fee amount or percentage.'
- '&fCurrent Fee: &e%fee%'
Creative Listing:
Name: '&eCreative Listing'
Message: '&cYou cannot create a listing while in creative mode.'
Lore:
- '&7Allow players to list items while in creative.'
- '%status%'
Listing Time:
Name: '&eListing Time'
Message: '&eEnter the new listing time in seconds or left click to cancel.'
Lore:
- '&7Change the amount of time a listing will be posted for.'
- '&fCurrent Time: &e%time%'
GUIs:
Buttons:
Previous Page:
Name: '&6Previous Page'
Description:
- '&7Go to the previous page.'
Next Page:
Name: '&6Next Page'
Description:
- '&7Go to the next page.'
Confirm:
Name: '&a&lConfirm'
Description:
- '&7Click to confirm.'
Deny:
Name: '&c&lCancel'
Description:
- '&7Click to cancel.'
Return:
Name: '&c&lReturn'
Description:
- '&7&oGo back to the previous page.'
AuctionHouse:
Title: '&6&lAuction&f&lHouse'
Search:
Name: '&6Search'
Description:
- '&7Search for specific listings.'
Left Click: '&eLeft click to clear'
Right Click: '&eEnter your search query...'
Close Button:
Name: '&c&lClose'
Description:
- '&7&oClose the menu.'
Info Item:
Name: '&6Information'
Description:
- '&8&m&l-----------------------------------'
- ''
- ' &7Welcome to the Auction House!'
- ' &7There are &e%items% &7for sale.'
- ' &7You can list an item on the auction house with'
- ' &e/ah list <price>'
- ''
- ' &7Your Balance &8&m&l-&e %balance%'
- ''
- '&8&m&l-----------------------------------'
Expired Listings:
Name: '&6Expired Listings'
Description:
- '&7&oReclaim your expired listings.'
Sort:
Name: '&6Sort'
Description:
- '&7&oSort the listings.'
Listing:
Description:
- '&8&m&l---------------------------'
- ''
- ' &fTime Left &8&m&l-&e %time%'
- ' &fCreator &8&m&l-&e %creator%'
- ''
- ' &fPrice &8&m&l-&2 %price%'
- ' &fTax &8&m&l-&2 %tax%'
- ' &fTotal &8&m&l-&2 %total%'
- ''
- '%shulker%'
- '%self_info%'
- ''
- '&8&m&l---------------------------'
Seller Info:
- ' &c&oLeft Click to edit'
- ' &c&oShift + Right Click to remove'
Buyer Info:
- ' &7&oClick to purchase'
Expired:
Description:
- '&8&m&l---------------------------'
- ''
- ' &fStarted &8&m&l-&e %start%'
- ' &fExpired &8&m&l-&e %end%'
- ' &fPrice &8&m&l-&2 %price%'
- ''
- ' &7Click to reclaim item.'
- ''
- '&8&m&l---------------------------'
Admin Description:
- '&8&m&l---------------------------------'
- ''
- ' &fStarted &8&m&l-&e %start%'
- ' &fExpired &8&m&l-&e %end%'
- ' &fPrice &8&m&l-&2 %price%'
- ' &fReclaimed &8&m&l-&e %reclaimed%'
- '%shulker%'
- ''
- ' &7Shift + Right Click to remove listing.'
- ''
- '&8&m&l---------------------------------'
Completed:
Admin Description:
- '&8&m&l---------------------------------'
- ''
- ' &fStarted &8&m&l-&e %start%'
- ' &fBought &8&m&l-&e %end%'
- ' &fPrice &8&m&l-&2 %price%'
- ' &fBuyer &8&m&l-&e %buyer%'
- ''
- '%shulker%'
- ' &7Shift + Right Click to remove and refund listing.'
- ''
- '&8&m&l---------------------------------'
Seller Tag: seller
Confirm Buy:
Title: '&eAre you sure???'
Expire Reclaim:
Title: '&c&lExpired Item &f&lReclaim'
Listing Edit:
Title: '&eEdit your listing'
Price:
Click: '&eEnter the new price of your auction or left click to cancel.'
Name: '&6Price'
Description:
- '&7&oClick to edit the price.'
Amount:
Name: '&6Amount'
Description:
- '&eIf you enter a higher amount than the current listing,'
- '&eyou must have the items in your inventory.'
- '&eIf you enter a lower amount than the current listing,'
- '&eyou will be given the items you removed.'
- ' '
- '&7&oClick to remove or add items to this listing.'
Click: '&eEnter the new amount of your auction or left click to cancel.'
Shulker View:
Title: '&eAre you sure???'
Shulker Item:
- ' &fThere are &e%amount%&f items in this box.'
- ''
Sort:
Title: '&eSort Menu'
Phrases:
Overall Price:
Name: Overall Price
Description:
- Click to enable sorting by the overall price
Time Left:
Name: Time Left
Description:
- Click to enable sorting by the time remaining.
Cost per Item:
Name: Cost per Item
Description:
- Click to enable sorting by the cost of each item.
Amount of Items:
Name: Amount of Items
Description:
- Click to enable sorting by the amount of items in the listing.
Longest: Longest
Shortest: Shortest
Highest: Highest
Lowest: Lowest
Auction House Admin:
Title: '&6&lAuctionHouse Admin Menu'
Listing:
- '&8&m&l---------------------------'
- ''
- ' &fTime Left &8&m&l-&e %time%'
- ' &fCreator &8&m&l-&e %creator%'
- ' &fPrice &8&m&l-&2 %price%'
- ''
- '%shulker%'
- ' &cLeft click to edit listing'
- ' &cShift + Right Click to Safely Remove'
- ''
- '&8&m&l---------------------------'
NPC:
Lore:
- '&fLocation:'
- '&fX: &e%x%'
- '&fY: &e%y%'
- '&fZ: &e%z%'
- ' '
- '&7Left click to teleport'
- '&7Shift + Left Click to remove auctioneer trait'
- '&7Shift + Right Click to delete NPC'
Confirm List:
Display Lore:
- '&8&m&l-------------------------------'
- ' '
- ' &fListing Amount: &e%amount%'
- ' &fListing Fee: &e%fee%'
- ' '
- '&7&oListing fee will be removed when listing is posted'
- ' '
- '&8&m&l-------------------------------'
Title: '&6Confirm Listing'
Version: 1
Message Thank you for viewing my plugin. If you choose to download it and try it out, I would appreciate if you would keep the metrics enabled so I can see how many people use the plugin (It's nice knowing my work is being used). I would also appreciate if you would leave a review (it's free). Thank you!