Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for KaYoz

Feature-filled 1.14-1.20 Auction House Plugin

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

Images

images

Auction House Editor https://i.imgur.com/AK9y4NI.jpeg

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

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

https://bstats.org/signatures/bukkit/Akarian%20Auction%20House.svg

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

Information

CategoryEconomy
Published onJune 9, 2023
LicenseUnspecified
Downloads325
Stars0
Watchers0

Pinned Versions

Members

Avatar for KaYoz

KaYoz

Owner