Information

Abyss Auctions is a highly optimized Auction House plugin with a multitude of one-of-a-kind features. It allows server admins to create categories within your auction house. In addition, you can place auction items that are displayed at random on your server.

Dependencies

• AbyssLib (required)

Commands

• /ah - opens the main GUI

• /ah display - toggles the display creation mode

Note: Admins need the abyssauctions.admin permission to see the admin help menu & use the commands.

Additional Permissions

• abyssauctions.amount.<amount> - Use this permission to limit the amount of auctions players can have at a time (this should be used to players from flooding the auction house).

Showcase

Frequently Asked Questions

How do i add or remove a display on my server?

To create a display block, use the command /ah display, which should activate the display creation mode. After that, right-click any block to add it as a display block. If you want to remove a display block, enter the display editing mode with /ah display and left-click any block.

Note: Running the /ah display mode commands toggles your current selected mode (meaning if it was disabled when running the command it will enable and vice versa).

Default Configuration Files

Main Configuration File

auction-time: 30 #Seconds
expire-time: 30 #How long before the expired item disappears. (Seconds)
expire-check-time: 1 # Seconds (Recommended: 5-10)
display-rotate-time: 5 # Seconds
blacklisted-materials:
    - "AIR"

Messages Configuration File

messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cYou don't have &4permission&c for this."
    "admin-help":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m------------------------------------"
                - " "
                - "&b&lAbyss&3&lAuctions &8&l┃ &bAdmin Help"
                - "&7&oMade by &f&oRelocation#0001&7&o."
                - " "
                - "&3&lCOMMANDS:"
                - "&3&l» &b/ah"
                - "&3&l» &b/ah display"
                - " "
                - "&3&m------------------------------------"
    "limit-reached":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cYou can't list anymore auction items!"
    "invalid-arguments":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cInvalid arguments!"
    "already-expired":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cThis item has already expired!"
    "already-perm-expired":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cThis item has already expired &4permanently&c."
    "item-expired":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cYour &4%item%&c has expired!"
                - "&7&o(( Retrieve it in the &f&oexpired items&7&o category! ))"
    "item-perm-expired":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cYour &4%item%&c has &4permanently&c expired!"
                - "&7&o(( You can no longer &f&oretrieve&7&o this item! ))"
    "not-enough":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cYou don't have enough to purchase this item!"
    "already-sold":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lAbyss &8- &cThis item was already sold, and your auction gui has been instantly refreshed."
    "listed":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have successfully listed your item for &3%price%&b with economy &3%economy%&b."
    "purchased":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have purchased &3%item%&b off of &3%auctioneer%&b for &3%price%&b with the &3%economy%&b economy."
    "sold":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &3%buyer%&b has purchased &3%item%&b off of &3you&b for &3%price%&b with the &3%economy%&b economy."
    "removed-item":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have removed this item off of the &3auction house&b."
    "removed-expired-item":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have saved this item from &3permanently&b expiring."
    "display-enabled":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have turned &3on&b the display editor."
    "display-disabled":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have turned &3off&b the display editor."
    "removed-display":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have removed this &3auction display&b."
    "added-display":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lAbyss &8- &bYou have added an &3auction display&b."

Categories Configuration File

enabled: true

title: "&8&lAUCTION HOUSE"
rows: 3
borders:
    "gray":
        material: "GRAY_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
            - "0-26"
categories:
    "all":
        slot: 12
        material: "OAK_SIGN"
        name: "&6All Items"
        lore: []
    "pickaxes":
        slot: 14
        material: "DIAMOND_PICKAXE"
        name: "&6Pickaxes"
        lore: []
        materials:
            - "DIAMOND_PICKAXE"
            - "WOODEN_PICKAXE"
            - "STONE_PICKAXE"
            - "GOLDEN_PICKAXE"
            - "IRON_PICKAXE"

Economy Configuration File

economies:
    "vault":
        formatted-name: "Money"
        name-aliases:
            - "money"
            - "cash"
            - "vault"
            - "dollar"
    "experience":
        formatted-name: "Experience"
        name-aliases:
            - "exp"
            - "experience"
            - "xp"

Auction GUI Configuration File

title: "&8&lAUCTION HOUSE"
rows: 6
auction-slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43]
borders:
    "gray":
        material: "GRAY_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
            - "0-9"
            - "17-18"
            - "26-27"
            - "35-36"
            - "44-45"
            - "45-53"

refresh-item:
    slot: 49
    temp-item:
        material: "YELLOW_DYE"
        name: "&e&lREFRESHED!"
        lore:
            - "&7&o(( You have refreshed the &f&oauction house&7&o! ))"
    normal-item:
        material: "LIME_DYE"
        name: "&a&lRefresh Page &7(Click)"
        lore:
            - " "
            - "&aInformation"
            - "&a&l▎ &7Page: &f%page%"
            - " "
            - "&7&O(( Click me to refresh this &f&opage&7&o! ))"
next-page:
    slot: 50
    material: "ARROW"
    name: "&aNext Page"
    lore: []

previous-page:
    slot: 48
    material: "ARROW"
    name: "&cPrevious Page"
    lore: []

expired-item:
    slot: 45
    material: "RED_DYE"
    name: "&4&l[&c&l!&4&l] &cExpired Items"
    lore:
        - "&7&o(( Click to view your expired items! ))"

info-item:
    slot: 53
    material: "BOOK"
    name: "&6Auction House Info"
    lore:
        - "&7Put some info here!"
        - "&7Set slot to -1 to remove!"

display-lore:
    - " "
    - "&eAuction Information"
    - "&e&l▎ &7Auctioneer: &f%auctioneer%"
    - "&e&l▎ &7Price: &f%price%"
    - "&e&l▎ &7Economy: &f%economy%"
    - "&e&l▎ &7Time left: &f%time%"
    - " "
    - "&7&o(( Click to purchase! ))"

Expire GUI Configuration File

title: "&8&lEXPIRED ITEMS"
rows: 6
expire-slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43]
borders:
    "gray":
        material: "GRAY_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
            - "0-9"
            - "17-18"
            - "26-27"
            - "35-36"
            - "44-45"
            - "45-53"

refresh-item:
    slot: 49
    temp-item:
        material: "YELLOW_DYE"
        name: "&e&lREFRESHED!"
        lore:
            - "&7&o(( You have refreshed your &f&oexpired items&7&o! ))"
    normal-item:
        material: "LIME_DYE"
        name: "&a&lRefresh Page &7(Click)"
        lore:
            - " "
            - "&aInformation"
            - "&a&l▎ &7Page: &f%page%"
            - " "
            - "&7&O(( Click me to refresh this &f&opage&7&o! ))"
next-page:
    slot: 50
    material: "ARROW"
    name: "&aNext Page"
    lore: []

previous-page:
    slot: 48
    material: "ARROW"
    name: "&cPrevious Page"
    lore: []

auction-item:
    slot: 45
    material: "PAPER"
    name: "&6&l[&e&l!&6&l] &eAuction House"
    lore:
        - "&7&o(( Click to go back to the &f&oauction house&7&o! ))"

info-item:
    slot: 53
    material: "BOOK"
    name: "&6Expire Info"
    lore:
        - "&7Put some info here!"
        - "&7Set slot to -1 to remove!"

display-lore:
    - " "
    - "&cExpire Information"
    - "&c&l▎ &7Time left: &f%time%"
    - " "
    - "&7&o(( Click to retrieve item! ))"