AkarianAuctionHouse

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.:
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
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