### **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/](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](https://discord.com/invite/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

```yaml 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.: default: 7 description: Apply a custom sales tax different from the default. ```

**Images**

images

**Auction House Editor** **![https://i.imgur.com/AK9y4NI.jpeg](https://i.imgur.com/AK9y4NI.jpeg)** **Auction House confirm listing** ![https://i.imgur.com/HyK85sV.png](https://i.imgur.com/HyK85sV.png) **Auction House Listing** ![https://i.imgur.com/QUYb2gx.png](https://i.imgur.com/QUYb2gx.png) **Auction House Own Listing ![https://i.imgur.com/niYAlJf.png](https://i.imgur.com/niYAlJf.png) Auction House Edit Listing** *(Price and Amount Edit)* ![https://i.imgur.com/vwBh3NP.png](https://i.imgur.com/vwBh3NP.png) **Auction House Shulker Item ![https://i.imgur.com/qIlrItD.png](https://i.imgur.com/qIlrItD.png) Auction House Shulker Preview** ![https://i.imgur.com/rP4jMES.png](https://i.imgur.com/rP4jMES.png) **Auction House Admin Menu** ![https://i.imgur.com/zA3pYvB.png](https://i.imgur.com/zA3pYvB.png) **Auction House Admin Listing Edit** ![https://i.imgur.com/HlXIon6.png](https://i.imgur.com/HlXIon6.png) **Sort Menu** *(Left & Right click to alternate)* ![https://i.imgur.com/2wMIY16.png](https://i.imgur.com/2wMIY16.png)

**Files**

config.yml

```yaml 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

```yaml Messages: Syntax: List: /ah list Search: /ah search 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 ' - '' - ' &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 ```

[![https://bstats.org/signatures/bukkit/Akarian%20Auction%20House.svg](https://bstats.org/signatures/bukkit/Akarian%20Auction%20House.svg)](https://bstats.org/plugin/bukkit/akarian%20auction%20house/15488) **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! **Repo** [https://github.com/xKaYoz/AkarianAuctionHouse](https://github.com/xKaYoz/AkarianAuctionHouse)

AkarianAuctionHouse

1.3.0_Pre-3