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! ))"Last updated