Due to personal reasons I am trying to quit public plugin coding. Am sorry everyone but that means this plugin is no longer maintained by me. BUT another developer offered to take over the plugin! (Many thanks to SedatTR <3)
Redirect link to the continued version:
SpigotMc Link
Link to the new developer's discord: https://discord.gg/9wjkj9fk9k
Redirect link to the continued version:
SpigotMc Link
Link to the new developer's discord: https://discord.gg/9wjkj9fk9k
Spoiler: Old Description
Sign Dependency: ProtocolLib
You will need ProtocolLib for the signs to work, if not anvil gui will open up.
You will also need a currency plugin like Vault
and you will need a plugin to handle coins, for example Essentials.
Almost every item in the menu is costumizable, even the
admin menu, so there are multiple configs with multiple options. Almost every setting is explained with a comment above it. The comments also contain placeholders for the setting (every setting has a specific set of palceholders, they are not global).
The auction menu is made out of 4 main elements: Auction Browser, View Bids, Manage Auctions, Delivery.
In Manage Auctions Menu are displayed your own auctions, if there are any,
otherwise it will open an auction creator menu. For creating a new auction you will have to pay a fee for the starting bid and the duration of the auction (both configurable). You can have maximum 28 auctions at the same time.
The View Bids Menu displays all items you have a bid on and also tells you on how many of them you hold the top bid.
You can have maximum 28 bids at the same time.
An auction will have the following display, mostly configurable:
The Auction Browser Menu is made of more categories in which auctions will be filtered (the way the items are asigned can be modified in the specific category config).
Also, the Auction Browser Menu has a Search feature as well as a Sorting system!
The duration of an auction is dynamically displayed in auction browser menu.
Bids of an auction are displayed on a bid history item while inspecting the auction. If you have a previous bid on the auction and want to bid again, it will take from your balance only the difference between the previous bid and the new bid but at each new bid you must bid atleast 15% more coins than the top bid.
Auctions Data is stored in a SQLite file and updated based on auction interaction, the auction data is updated all the time but retrieved only on server start.
Deliveries are special, they are stored separately in a SQLite file so they are updated constantly. Deliveries can be given only by admins via the admin menu.
Example for their use: An unclaimed auction stays in the main database for a very long period and you want to get rid of it. You can delete it in two ways, by deleting the items & bids (so they will be lost forever) or by deleting the auction and sending the items & bids to their owners via a delivery.
If there are any errors that result in some players losing their items, you can get them back! In the logs file, when an auction is created, the item from that auction will be stored in base64 and it can be given to a player via a console command /ahadmin give <player> <base64 item>. The base64 item is a very long string with random characters and it will appear in logs like this: "[%time stamp%] (Advanced) Item in base64: %item%". If you have problems with getting the items, please contact me (my discord down below or just give me a message on spigot).
I tried to give the admins alot of control so, as you will notice, it is pretty rich in options.
The main admin command is /ahadmin and it will open the main admin menu but
you can also check the list of admin commands with /ahadmin help.
The permission to use admin commands and menus is auctionmaster.admin but it can be changed into the config.
Images with the Admin Menu:
This plugin is compatible with Citizens! You can create a NPC that will open the menu when clicked!
The created NPC is like a normal NPC, you can edit anything about it except it's name or it won't work anymore.
The currency of this plugin is also flexible! You can use normal Vault or you can use a Skript variabile as currency! For more info about the usage of Skript just check the comments in the currency.yml config.
The plugin also supports TokenManager and PlayerPoints.
This plugin has HeadDatabase Compatibility!
You can set the id of an item to 'skull: hdb- id' and the head with that id will be displayed!
If the id is not valid, the head will become a question mark.
You can asign heads with texture without HeadDatabase by simply using: 'skull: username' or 'skull: texture value'
The plugin also has PlaceholderAPI Compatibility!
You can use placeholders inside the menus (not everywhere but in most places).
The plugin currently offers only 2 placeholders:
%auctionmaster_own_auctions% » Number of auctions you have
%auctionmaster_own_bids% » Number of auctions you placed a bid on
If you want to use some info from the plugin inside your plugin
add the plugin into your external libraries
If you want to display auctions outside the menu use this addon:
AuctionMasterItemDisplay
Preview of the addon:
Check out my premium plugin, maybe it might interest you!
I don't think I covered everything the plugin contains in the upper text but I can't think of what I missed. For me, as the author of the plugin, everything seems natural and I don't know on what I should insist with explications.
If you have a problem with the plugin, any kind of problem, please contact me!
My discord is qKing12#1918
Or just join my discord
I usually respond faster on discord but you can dm me on spigot too!
If you are interested in some translations for the plugin, there are some in my discord server!
I want to say this is the second plugin I ever make, it was quite challenging. When I started this I didn't even know how to make a chest open
.
If you want to support me and my work I would really apreciate if you would buy me a coffee <3
Sign Dependency: ProtocolLib
You will need ProtocolLib for the signs to work, if not anvil gui will open up.
You will also need a currency plugin like Vault
and you will need a plugin to handle coins, for example Essentials.
Almost every item in the menu is costumizable, even the
admin menu, so there are multiple configs with multiple options. Almost every setting is explained with a comment above it. The comments also contain placeholders for the setting (every setting has a specific set of palceholders, they are not global).
Spoiler: config.yml
Code (YAML):
#You can edit specific menu settings in menu_name.yml from the menus folder.
#Background colors:
#Put 0 for white
#Put 1 for orange
#Put 2 for magenta
#Put 3 for light blue
#Put 4 for yellow
#Put 5 for lime
#Put 6 for pink
#Put 7 for gray
#Put 8 for light gray
#Put 9 for cyan
#Put 10 for purple
#Put 11 for blue
#Put 12 for brown
#Put 13 for green
#Put 14 for red
#Put 15 for black
weapons-menu-color : 1
armor-menu-color : 11
tools-menu-color : 10
blocks-menu-color : 12
others-menu-color : 13
consumables-menu-color : 14
background-color : 15
use-background-glass : true
use-decimals : false
#How much time you want to add to an auction
#when a player bids:
#Time in seconds
add-time-to-auction : 15
#This option allows players to end their
#auctions at any time they want
use-end-own-auction : false
#If you want just some players to have this option
use-end-own-auction-permission : ' none'
end-own-auction-fee : 500
end-own-auction-item : '347'
end-own-auction-name : '&aEnd Auction Now'
end-own-auction-lore :
- '&7End this auction'
- '&7right now.'
- ''
- '&7Ending Cost : &6500 coins'
end-own-auction-message : '&aYour auction was ended!'
end-own-auction-no-money-message : '&cYou don''t have enough coins to end this auction.'
#Enabling global category could have an
#impact on the plugin performance
#It is up to you if you will use it or not
#If you enable global category, it will be set
#as the default category when opening the menu
use-global-category : false
global-menu-color : 15
global-category-item : 'skull : eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2Y0MDk0MmYzNjRmNmNiY2VmZmNmMTE1MTc5NjQxMDI4NmE0OGIxYWViYTc3MjQzZTIxODAyNmMwOWNkMSJ9fX0='
global-category-name : '&9Global Items'
global-category-lore :
- '&fAll items from every'
- '&fcategory in the'
- '&fsame place!'
#If you want to use anvil gui instead of the sign gui
#set the option bellow to true
#Sign lines will become the lore of the paper
#inside the anvil gui
use-anvil-instead-sign : false
#If you want to use th chat instead of the sign gui
#set the option bellow to true
#Sign lines will become the message sent in chat
#The player has 10 seconds to give a price, afterwards
#the listener closes
listener-expire-message : '&cYou took too long.. Your chat listener expired.'
use-chat-instead-sign : false
#Set this to false if you want players to not be able to outbid theirselves
outbid-yourself : true
can-not-outbid-message : '&cYou can not outbid yourself!'
broadcast-new-auction : false
#Use %seller-username% for the name of the seller
#Use %seller-display-name% for the display name of the seller
#Use %item-display-name% for the item's display name
#Use %coins% for the starting bid
broadcast-new-auction-message : '&6 [Auctions ] %seller-display-name% &fcreated an auction for %item-display-name%&f! &e&lCLICK &e&lTO &e&lVIEW'
broadcast-new-auction-permission : ' none'
#If you want commands to execute make a list in the setting broadcast-commands
#If you want to use only commands and cancel the auction-message set it to 'none'
broadcast-commands : [ ]
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.bids.number'
#where number is the maximum number of bids a player can have at the same time.
#If the permission is not found, it will be set to the maximum (28)
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.bids.6' can have maximum 6
#bids at once
use-bid-limit : false
bid-limit-reached-message : '&cYou reached your maximum bid limit. You can''t bid on another auction until you collect one.'
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.auctions.number'
#where number is the maximum number of auctions a player can have at the same time.
#If the permission is not found, it will be set to the maximum (28)
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.auctions.6' can have maximum 6
#auctions at once
use-auction-limit : false
auction-limit-reached-message : '&cYou reached your maximum auction limit. You can''t create another auction until you collect one.'
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.duration.number'
#where number is the maximum number of hours a player can have on an auction.
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.duration.6' can have a maximum 6
#hours long auction
#ATTENTION! Don't set your default duration over a limit you are giving because
#the plugin WILL NOT check for it.
#ATTENTION AGAIN! You can limit the number of hours up to 48 hours, the plugin will not check for more
use-duration-limit : false
duration-limit-reached-message : '&cThe selected duration is over your limit. Automatically set it to your maximum.'
#Message added to the category item's lore when you are browsing it
category-browsing : '&aCurrently browsing!'
#Message added to the category item's lore when you are not browsing it
category-no-browsing : '&eClick to view items!'
#ATTENTION: Please don't use the same name for items in the menu
#or the same name for the menus themselves, some checks are made
#based on name so you can bug the system by giving the same name to
#two items in the same inventory
go-back-item : '262'
go-back-item-name : '&aGo Back'
go-back-item-lore :
- '&7Go back to Auction Menu'
previous-page-item : '262'
#Use %page-number% for the current page's number
previous-page-item-name : '&aPage %page-number%'
previous-page-item-lore :
- '&7Click to go to the'
- '&7previous page.'
next-page-item : '262'
#Use %page-number% for the current page's number
next-page-item-name : '&aPage %page-number%'
next-page-item-lore :
- '&7Click to go to the'
- '&7next page.'
starting-menu-name : '&8Auction Menu'
close-menu-item : '166'
close-menu-item-name : '&cClose Menu'
close-menu-item-lore :
- '&7Close the menu'
browsing-menu-name : '&8Auction Browser'
browsing-menu-item : '41'
browsing-menu-item-name : '&6Auction Browser'
browsing-menu-item-lore :
- '&7Find items for sale by'
- '&7players across the server!'
- ''
- '&7Items offered here are for'
- '&6auction&7, meaning you have to'
- '&7place the top bid to get them!'
- ''
- '&eClick to browse!'
view-bids-menu-name : '&8Auction Bids Viewer'
view-bids-menu-item : '396'
#Use %total-bids% for the number of auctions the player has bid on
#Use %total-top-bid% for the number of auctions the player holds the top bid on
view-bids-menu-item-name : '&aView Bids'
view-bids-menu-item-lore:
with-bids :
- '&7You placed &a %total-bids% bids&7 on'
- '&7pending auctions.'
- ''
- '&7You hold the top bid on'
- '&7 (&a %total-top-bid%&7/&a%total-bids%&7) of these'
- '&7auctions.'
- ''
- '&eClick to view!'
without-bids :
- '&7You don''t have any bids placed'
- '&7on pending auctions.'
- ''
- '&7Place bids on items and click'
- '&7here to see them!'
- ''
- '&cYou don''t have any bids!'
no-bids-message : '&cYou don''t have any bids!'
delivery-menu-name : '&8Delivery Menu'
use-delivery-system : true
#This is the item for deliveries in the main menu
delivery-menu-item-name : '&aDeliveries'
delivery-menu-item : '54'
delivery-menu-item-lore :
- '&7Here come the items and'
- '&7coins sent from admins!'
delivery-have-message : '&aYou have deliveries!'
#This is the item for deliveries in the delivery menu
delivery-item:
no-delivery-name : '&cNo Delivery'
no-delivery-lore :
- '&7You don''t have'
- '&7any delivery'
- '&7to claim. : ('
#Use %coins% for the amount of coins the player has in their delivery
#Use %items-count% for the amount of items the player has in their delivery
yes-delivery-name : '&aClaim Delivery'
yes-delivery-lore :
- '&7You have a delivery!'
- ''
- '&7Delivery contains:'
- '&7 - &6 %coins% coins'
- '&7 - &e %items-count% items'
- ''
- '&aClick to claim!'
delivery-claimed-message : '&aYou just claimed your delivery!'
not-enough-space-delivery : '&cYou don''t have enough space to claim the whole delivery!'
no-delivery-to-claim : '&cYou don''t have a delivery to claim!'
delivery-alert-join-message : '&6 [Auction ] &fYou have unclaimed deliveries!'
#This message appears when the delivery is sent and only if
#the player is online
#Use %coins% for coins
#Use %item-count% for amount of items
delivery-got-message : '&6 [Auction ] &fYou have received &6 %coins% coins &fand &e%item-count% items&f!'
#The message shown in chat when a player executes /ah help
#P.S: /ahadmin won't be translated, you are an admin, you know english
#you know how to use commands, therefore no need for translation
player-commands-help-display :
- '&7&m ---------------------------------------'
- '&c/auctionhouse &8- &7Open auctions menu'
- '&c/ah <player name> &8- &7Open a player''s auctions'
- '&c/ah delivery &8- &7Open delivery menu'
- '&4/ahadmin &8- &7Open the admin menu'
- '&4/ahadmin help &8- &7Show help commands for admin'
- '&7&m ---------------------------------------'
#Do you want the auction to be exclusive for players with a
#specific permission? Set it here, if you don't, let the permission
#to be 'none'
#ATTENTION: This option will block the npc too (if you are using any)
auction-use-permission : ' none'
auction-no-permission : '&cYou don''t have the permission to open the menu!'
#Maybe you want just some players to use the '/ah name' command
#And if you wonder what's the difference between this option and the one above:
#this one blocks the command only, the above option also blocks the npc
auction-command-use-permission : ' none'
auction-command-deny : '&cYou don''t have the permission to use this command!'
#The permission for using admin commands/menus
admin-perks-use-permission : 'auctionmaster.admin'
admin-perks-deny : '&cYou can''t use admin commands!'
#This option will make the command '/ah' open the main menu
#If you set it to false, the command will require a player as it's argument
auction-command-menu : true
#The message sent when the option above is false
auction-command-missing : '&cYou should use /ah <player name>!'
#Use %player% for player's username
player-auction-menu-name : '&8 %player%''s Auctions'
#The message sent when the entered player does not have any auctions
no-auctions-message : '&eThis player does not have any active auctions.'
#This is false by default because you will need Citizens & HolographicDisplays if you want to use it
#After setting this to true just use /ahadmin npc
#If the title bugs use /ahadmin debugNames to regenerate them
auction-npc-use : false
#You can only have 2 lines, sorry
auction-npc-title:
line-1 : '&6Auction Master'
line-1-height : 2.05
line-2 : '&e&lCLICK'
#When the option below is set to false, it will use 'auction-npc-skin-name' setting
#When the option below is set to true, it will use 'auction-npc-skin-signature' and 'auction-npc-skin-data'
#You can use https://mineskin.org/ to upload a custom skin
auction-npc-skin-texture : true
#For npc's skin you can put the name of a player
#This setting matters only when 'auction-npc-skin-texture' is false
auction-npc-skin-name : 'qKing12'
auction-npc-skin-signature : 'SbvoR6xYRP30lvCJqIumNCul8IdwHXuBTh4/Gukr4HzFMpouEM1boRvRwPRzRo45UFlxQnsYZzbBnAeCHAYVgql6jvIbXLpQmhdSH1kSKZ6pmjhTzufK/R6S3pWLZlv77oaTfFT+7Ccd7bXFSwimG0wIK4jHhfrKa2kdMMZi7Y21ecVZr3DoJTYpJi9k18ewy1KSPm4aqkxE8rFr0U79IKoUBm1glT/jJYsMVARCJlouHMLEk0x2fHuwPF/Tpf3+yPdCQXCQrqKug0klcyhTNYqv238aqws/x0RsFyegvoxl3fwfIshjqXEVQpnmJ9N9tcD6MzKqm2mC1TjycEpYHvfaxircs7XU9hRbNbiLTKFVGYda9OMh40GmoCriJItYZBLngliNUCbIysE3YKosjXQdOTPVSU/9hZbTN242dL035to2a1r+rq5kkj5YabbvGIFyyaYDg/6plnb7ZWstMJlb6yzEldyfk+7hVb5W1ahsbZ+DCZIeEhewdJDghaiizWHE7m5L+L+49Q9QAyW/I+mM0MS7JlDSUNn/CeaijMB0YfWI12EoM7KVEJC8RnVc09HFs1HSXNA7Gcy073NrNOWxlCXG2NYSosYTiZ/2UWIHBkH0KTwHHwWdQSgtdl6o0gz40OsqzwuU8DyxQk8RfGb7RKdwiIPxukExSNyn+EQ='
auction-npc-skin-data : 'eyJ0aW1lc3RhbXAiOjE1Njc5NjQyNTU5OTUsInByb2ZpbGVJZCI6IjgyYzYwNmM1YzY1MjRiNzk4YjkxYTEyZDNhNjE2OTc3IiwicHJvZmlsZU5hbWUiOiJOb3ROb3RvcmlvdXNOZW1vIiwic2lnbmF0dXJlUmVxdWlyZWQiOnRydWUsInRleHR1cmVzIjp7IlNLSU4iOnsidXJsIjoiaHR0cDovL3RleHR1cmVzLm1pbmVjcmFmdC5uZXQvdGV4dHVyZS82NWRhZjZlN2Y1ZTExOGZjYTQwOGUzZTQzMzM0ZmQxZmIxMzNiMzFkYWE3Yjk4MTRiYjVlMGRhZWQ4YzA0NjhiIiwibWV0YWRhdGEiOnsibW9kZWwiOiJzbGltIn19fX0='
#If you want a certain item id to be blocked from auction
#specify it here, by default the items that can't be put in
#any category, they go to "others menu"
blacklist-item-id :
- '2267'
#This is a setting for custom items, if you want to block a certain name of an item
blacklist-item-name :
- '&6Coins'
- '&5Custom Item Name'
blacklist-item-lore:
1 :
- '&eLine1'
- '&eLine2'
2 :
- '&e1 Line1'
- '&e1 Line2'
blacklist-item-message : '&cThis item is not auctionable!'
#You can make custom item names to go in a specific category
#This option is configurable in menu's file.
#Please do not modify this
version : 3.2
#Background colors:
#Put 0 for white
#Put 1 for orange
#Put 2 for magenta
#Put 3 for light blue
#Put 4 for yellow
#Put 5 for lime
#Put 6 for pink
#Put 7 for gray
#Put 8 for light gray
#Put 9 for cyan
#Put 10 for purple
#Put 11 for blue
#Put 12 for brown
#Put 13 for green
#Put 14 for red
#Put 15 for black
weapons-menu-color : 1
armor-menu-color : 11
tools-menu-color : 10
blocks-menu-color : 12
others-menu-color : 13
consumables-menu-color : 14
background-color : 15
use-background-glass : true
use-decimals : false
#How much time you want to add to an auction
#when a player bids:
#Time in seconds
add-time-to-auction : 15
#This option allows players to end their
#auctions at any time they want
use-end-own-auction : false
#If you want just some players to have this option
use-end-own-auction-permission : ' none'
end-own-auction-fee : 500
end-own-auction-item : '347'
end-own-auction-name : '&aEnd Auction Now'
end-own-auction-lore :
- '&7End this auction'
- '&7right now.'
- ''
- '&7Ending Cost : &6500 coins'
end-own-auction-message : '&aYour auction was ended!'
end-own-auction-no-money-message : '&cYou don''t have enough coins to end this auction.'
#Enabling global category could have an
#impact on the plugin performance
#It is up to you if you will use it or not
#If you enable global category, it will be set
#as the default category when opening the menu
use-global-category : false
global-menu-color : 15
global-category-item : 'skull : eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2Y0MDk0MmYzNjRmNmNiY2VmZmNmMTE1MTc5NjQxMDI4NmE0OGIxYWViYTc3MjQzZTIxODAyNmMwOWNkMSJ9fX0='
global-category-name : '&9Global Items'
global-category-lore :
- '&fAll items from every'
- '&fcategory in the'
- '&fsame place!'
#If you want to use anvil gui instead of the sign gui
#set the option bellow to true
#Sign lines will become the lore of the paper
#inside the anvil gui
use-anvil-instead-sign : false
#If you want to use th chat instead of the sign gui
#set the option bellow to true
#Sign lines will become the message sent in chat
#The player has 10 seconds to give a price, afterwards
#the listener closes
listener-expire-message : '&cYou took too long.. Your chat listener expired.'
use-chat-instead-sign : false
#Set this to false if you want players to not be able to outbid theirselves
outbid-yourself : true
can-not-outbid-message : '&cYou can not outbid yourself!'
broadcast-new-auction : false
#Use %seller-username% for the name of the seller
#Use %seller-display-name% for the display name of the seller
#Use %item-display-name% for the item's display name
#Use %coins% for the starting bid
broadcast-new-auction-message : '&6 [Auctions ] %seller-display-name% &fcreated an auction for %item-display-name%&f! &e&lCLICK &e&lTO &e&lVIEW'
broadcast-new-auction-permission : ' none'
#If you want commands to execute make a list in the setting broadcast-commands
#If you want to use only commands and cancel the auction-message set it to 'none'
broadcast-commands : [ ]
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.bids.number'
#where number is the maximum number of bids a player can have at the same time.
#If the permission is not found, it will be set to the maximum (28)
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.bids.6' can have maximum 6
#bids at once
use-bid-limit : false
bid-limit-reached-message : '&cYou reached your maximum bid limit. You can''t bid on another auction until you collect one.'
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.auctions.number'
#where number is the maximum number of auctions a player can have at the same time.
#If the permission is not found, it will be set to the maximum (28)
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.auctions.6' can have maximum 6
#auctions at once
use-auction-limit : false
auction-limit-reached-message : '&cYou reached your maximum auction limit. You can''t create another auction until you collect one.'
#If you set this to true, the plugin will begin to check
#players for the permission 'auctionmaster.limit.duration.number'
#where number is the maximum number of hours a player can have on an auction.
#If a player has 2 permissions, the bigger number has priority
#Example: a player with permission 'auctionmaster.limit.duration.6' can have a maximum 6
#hours long auction
#ATTENTION! Don't set your default duration over a limit you are giving because
#the plugin WILL NOT check for it.
#ATTENTION AGAIN! You can limit the number of hours up to 48 hours, the plugin will not check for more
use-duration-limit : false
duration-limit-reached-message : '&cThe selected duration is over your limit. Automatically set it to your maximum.'
#Message added to the category item's lore when you are browsing it
category-browsing : '&aCurrently browsing!'
#Message added to the category item's lore when you are not browsing it
category-no-browsing : '&eClick to view items!'
#ATTENTION: Please don't use the same name for items in the menu
#or the same name for the menus themselves, some checks are made
#based on name so you can bug the system by giving the same name to
#two items in the same inventory
go-back-item : '262'
go-back-item-name : '&aGo Back'
go-back-item-lore :
- '&7Go back to Auction Menu'
previous-page-item : '262'
#Use %page-number% for the current page's number
previous-page-item-name : '&aPage %page-number%'
previous-page-item-lore :
- '&7Click to go to the'
- '&7previous page.'
next-page-item : '262'
#Use %page-number% for the current page's number
next-page-item-name : '&aPage %page-number%'
next-page-item-lore :
- '&7Click to go to the'
- '&7next page.'
starting-menu-name : '&8Auction Menu'
close-menu-item : '166'
close-menu-item-name : '&cClose Menu'
close-menu-item-lore :
- '&7Close the menu'
browsing-menu-name : '&8Auction Browser'
browsing-menu-item : '41'
browsing-menu-item-name : '&6Auction Browser'
browsing-menu-item-lore :
- '&7Find items for sale by'
- '&7players across the server!'
- ''
- '&7Items offered here are for'
- '&6auction&7, meaning you have to'
- '&7place the top bid to get them!'
- ''
- '&eClick to browse!'
view-bids-menu-name : '&8Auction Bids Viewer'
view-bids-menu-item : '396'
#Use %total-bids% for the number of auctions the player has bid on
#Use %total-top-bid% for the number of auctions the player holds the top bid on
view-bids-menu-item-name : '&aView Bids'
view-bids-menu-item-lore:
with-bids :
- '&7You placed &a %total-bids% bids&7 on'
- '&7pending auctions.'
- ''
- '&7You hold the top bid on'
- '&7 (&a %total-top-bid%&7/&a%total-bids%&7) of these'
- '&7auctions.'
- ''
- '&eClick to view!'
without-bids :
- '&7You don''t have any bids placed'
- '&7on pending auctions.'
- ''
- '&7Place bids on items and click'
- '&7here to see them!'
- ''
- '&cYou don''t have any bids!'
no-bids-message : '&cYou don''t have any bids!'
delivery-menu-name : '&8Delivery Menu'
use-delivery-system : true
#This is the item for deliveries in the main menu
delivery-menu-item-name : '&aDeliveries'
delivery-menu-item : '54'
delivery-menu-item-lore :
- '&7Here come the items and'
- '&7coins sent from admins!'
delivery-have-message : '&aYou have deliveries!'
#This is the item for deliveries in the delivery menu
delivery-item:
no-delivery-name : '&cNo Delivery'
no-delivery-lore :
- '&7You don''t have'
- '&7any delivery'
- '&7to claim. : ('
#Use %coins% for the amount of coins the player has in their delivery
#Use %items-count% for the amount of items the player has in their delivery
yes-delivery-name : '&aClaim Delivery'
yes-delivery-lore :
- '&7You have a delivery!'
- ''
- '&7Delivery contains:'
- '&7 - &6 %coins% coins'
- '&7 - &e %items-count% items'
- ''
- '&aClick to claim!'
delivery-claimed-message : '&aYou just claimed your delivery!'
not-enough-space-delivery : '&cYou don''t have enough space to claim the whole delivery!'
no-delivery-to-claim : '&cYou don''t have a delivery to claim!'
delivery-alert-join-message : '&6 [Auction ] &fYou have unclaimed deliveries!'
#This message appears when the delivery is sent and only if
#the player is online
#Use %coins% for coins
#Use %item-count% for amount of items
delivery-got-message : '&6 [Auction ] &fYou have received &6 %coins% coins &fand &e%item-count% items&f!'
#The message shown in chat when a player executes /ah help
#P.S: /ahadmin won't be translated, you are an admin, you know english
#you know how to use commands, therefore no need for translation
player-commands-help-display :
- '&7&m ---------------------------------------'
- '&c/auctionhouse &8- &7Open auctions menu'
- '&c/ah <player name> &8- &7Open a player''s auctions'
- '&c/ah delivery &8- &7Open delivery menu'
- '&4/ahadmin &8- &7Open the admin menu'
- '&4/ahadmin help &8- &7Show help commands for admin'
- '&7&m ---------------------------------------'
#Do you want the auction to be exclusive for players with a
#specific permission? Set it here, if you don't, let the permission
#to be 'none'
#ATTENTION: This option will block the npc too (if you are using any)
auction-use-permission : ' none'
auction-no-permission : '&cYou don''t have the permission to open the menu!'
#Maybe you want just some players to use the '/ah name' command
#And if you wonder what's the difference between this option and the one above:
#this one blocks the command only, the above option also blocks the npc
auction-command-use-permission : ' none'
auction-command-deny : '&cYou don''t have the permission to use this command!'
#The permission for using admin commands/menus
admin-perks-use-permission : 'auctionmaster.admin'
admin-perks-deny : '&cYou can''t use admin commands!'
#This option will make the command '/ah' open the main menu
#If you set it to false, the command will require a player as it's argument
auction-command-menu : true
#The message sent when the option above is false
auction-command-missing : '&cYou should use /ah <player name>!'
#Use %player% for player's username
player-auction-menu-name : '&8 %player%''s Auctions'
#The message sent when the entered player does not have any auctions
no-auctions-message : '&eThis player does not have any active auctions.'
#This is false by default because you will need Citizens & HolographicDisplays if you want to use it
#After setting this to true just use /ahadmin npc
#If the title bugs use /ahadmin debugNames to regenerate them
auction-npc-use : false
#You can only have 2 lines, sorry
auction-npc-title:
line-1 : '&6Auction Master'
line-1-height : 2.05
line-2 : '&e&lCLICK'
#When the option below is set to false, it will use 'auction-npc-skin-name' setting
#When the option below is set to true, it will use 'auction-npc-skin-signature' and 'auction-npc-skin-data'
#You can use https://mineskin.org/ to upload a custom skin
auction-npc-skin-texture : true
#For npc's skin you can put the name of a player
#This setting matters only when 'auction-npc-skin-texture' is false
auction-npc-skin-name : 'qKing12'
auction-npc-skin-signature : 'SbvoR6xYRP30lvCJqIumNCul8IdwHXuBTh4/Gukr4HzFMpouEM1boRvRwPRzRo45UFlxQnsYZzbBnAeCHAYVgql6jvIbXLpQmhdSH1kSKZ6pmjhTzufK/R6S3pWLZlv77oaTfFT+7Ccd7bXFSwimG0wIK4jHhfrKa2kdMMZi7Y21ecVZr3DoJTYpJi9k18ewy1KSPm4aqkxE8rFr0U79IKoUBm1glT/jJYsMVARCJlouHMLEk0x2fHuwPF/Tpf3+yPdCQXCQrqKug0klcyhTNYqv238aqws/x0RsFyegvoxl3fwfIshjqXEVQpnmJ9N9tcD6MzKqm2mC1TjycEpYHvfaxircs7XU9hRbNbiLTKFVGYda9OMh40GmoCriJItYZBLngliNUCbIysE3YKosjXQdOTPVSU/9hZbTN242dL035to2a1r+rq5kkj5YabbvGIFyyaYDg/6plnb7ZWstMJlb6yzEldyfk+7hVb5W1ahsbZ+DCZIeEhewdJDghaiizWHE7m5L+L+49Q9QAyW/I+mM0MS7JlDSUNn/CeaijMB0YfWI12EoM7KVEJC8RnVc09HFs1HSXNA7Gcy073NrNOWxlCXG2NYSosYTiZ/2UWIHBkH0KTwHHwWdQSgtdl6o0gz40OsqzwuU8DyxQk8RfGb7RKdwiIPxukExSNyn+EQ='
auction-npc-skin-data : 'eyJ0aW1lc3RhbXAiOjE1Njc5NjQyNTU5OTUsInByb2ZpbGVJZCI6IjgyYzYwNmM1YzY1MjRiNzk4YjkxYTEyZDNhNjE2OTc3IiwicHJvZmlsZU5hbWUiOiJOb3ROb3RvcmlvdXNOZW1vIiwic2lnbmF0dXJlUmVxdWlyZWQiOnRydWUsInRleHR1cmVzIjp7IlNLSU4iOnsidXJsIjoiaHR0cDovL3RleHR1cmVzLm1pbmVjcmFmdC5uZXQvdGV4dHVyZS82NWRhZjZlN2Y1ZTExOGZjYTQwOGUzZTQzMzM0ZmQxZmIxMzNiMzFkYWE3Yjk4MTRiYjVlMGRhZWQ4YzA0NjhiIiwibWV0YWRhdGEiOnsibW9kZWwiOiJzbGltIn19fX0='
#If you want a certain item id to be blocked from auction
#specify it here, by default the items that can't be put in
#any category, they go to "others menu"
blacklist-item-id :
- '2267'
#This is a setting for custom items, if you want to block a certain name of an item
blacklist-item-name :
- '&6Coins'
- '&5Custom Item Name'
blacklist-item-lore:
1 :
- '&eLine1'
- '&eLine2'
2 :
- '&e1 Line1'
- '&e1 Line2'
blacklist-item-message : '&cThis item is not auctionable!'
#You can make custom item names to go in a specific category
#This option is configurable in menu's file.
#Please do not modify this
version : 3.2
Spoiler: currency.yml
Code (YAML):
#Let the plugin know what currency you want to use
#for your player's auctions
#Put 'Vault' for Vault Currency(Default)
#Put 'Skript' for Skript Currency
#If you misspell the currency type, it will automatically select Vault
currency-type : 'Vault'
#If your currency does not work the auction won't either
#There are two possible errors:
#Error 404 = The currency plugin is missing
#Error 505 = The player's currency is unreachable (Frequently caused by undeclared/misspelled skript variables)
#----------- Skript Configuration -----------
#Use %player% for player's name
#The variable should be like in skript but without braces
#Example: {balance.%player%} would be balance.%player%
skript-variable : 'balance:: %player%'
#for your player's auctions
#Put 'Vault' for Vault Currency(Default)
#Put 'Skript' for Skript Currency
#If you misspell the currency type, it will automatically select Vault
currency-type : 'Vault'
#If your currency does not work the auction won't either
#There are two possible errors:
#Error 404 = The currency plugin is missing
#Error 505 = The player's currency is unreachable (Frequently caused by undeclared/misspelled skript variables)
#----------- Skript Configuration -----------
#Use %player% for player's name
#The variable should be like in skript but without braces
#Example: {balance.%player%} would be balance.%player%
skript-variable : 'balance:: %player%'
Spoiler: bids_related.yml
Code (YAML):
bids-menu-name
: '&8Auction View'
bid-history-item : '358:0'
bid-history-item-name : '&fBid History'
bid-history-item-lore:
no-bids :
- '&7No bids have been placed on'
- '&7this item yet.'
- ''
- '&7Be the first to bid on it!'
#The lore of the bid history item is dynamic when
#it has bids on it, the structure below repeats itself
#at every new bid, adding to the lore
#Use %bid-amount% for the amount of the bid
#Use %bidder-display-name% for bidder's display name
#Use %when-bidded% for when the bid was placed (eg. 2 Days) (Ago is not included so you can modify)
bid-structure :
- '&8&m --------------'
- '&7Bid : &6%bid-amount% coins'
- '&7By : %bidder-display-name%'
- '&b %when-bidded% Ago'
#This is the message items with "Ending soon" will give when clicked
too-late-to-open-now : '&cIt is too late to open this now!'
#When the auction is claimed by the seller, the bid history
#no longer updates %when-bidded% and the message below is added
#to the bid history item lore
#Use %date% for the date of the last updated
bid-history-last-updated-message : '&8Last updated on %date%'
submit-bid-cannot-afford-item : '394'
#Use %bid-amount% for the needed amount (that the player does not have)
submit-bid-cannot-afford-item-name : '&6Submit Bid'
submit-bid-cannot-afford-item-lore :
- ''
- '&7New Bid : &6%bid-amount% coins'
- ''
- '&cCannot afford bid!'
submit-bid-item : '371'
submit-bid-item-name : '&6Submit Bid'
submit-bid-item-lore:
no-previous-bids :
- ''
- '&7New Bid : &6%bid-amount% coins'
- ''
- '&eClick to bid!'
#Use %bid-amount% for the amount the bid will have
#Use %previous-bid% for the previous bid's amount
#Use %coins-to-pay% for the difference between previous bid and actual bid
with-previous-bids :
- ''
- '&7New Bid : &6%bid-amount% coins'
- '&7Previous Bid : &e%previous-bid% coins'
- ''
- '&7You pay : &6%coins-to-pay% coins'
- ''
- '&eClick to bid!'
collect-bid-item : '41'
collect-bid-item-name : '&6Collect Auction'
collect-bid-item-lore :
#Use %coins% for the amount of coins the player could collect
collect-coins :
- ''
- '&7You have &6 %coins% coins'
- '&7to collect from this'
- '&7auction.'
- ''
- '&eClick to collect!'
collect-item :
- ''
- '&7You have items to'
- '&7collect from this auction'
- ''
- '&eClick to collect!'
edit-bid-item : '266'
#Use %current-bid% for the amount the player has selected to bid
edit-bid-item-name : '&fBid Amount : &6%current-bid% coins'
#Use %minimum-bid% for the minimum amount you have to bid on the auction
edit-bid-item-lore :
- '&7You need to bid at least'
- '&6 %minimum-bid% coins &7to hold the top'
- '&7bid on this auction.'
- ''
- '&7The &etop bid&7 on auction'
- '&7end wins the item.'
- ''
- '&7If you do not win, you can'
- '&7claim your bid coins back.'
- ''
- '&eClick to edit amount!'
#The sign used for editing has the same text
#as the starting bid on auction creator
#Message for when you try to edit the bid with a value smaller than needed
edit-bid-deny-message : '&cYour bid is too low.'
#Message for when the bid is placed successfully
placed-bid-message : '&aYour bid was successfully placed!'
#Message for when you have 28 bids (reached the limit)
max-bids-reached : '&cYou can have maximum 28 bids on different auctions at the same time.'
#Message sent to players when they get outbidded
#Use %outbid-player-display-name% for the name of the outbidder
#Use %top-bid% for the new top bid
#Use %bid-item% for the name of the item
outbid-message :
- '&6 [Auction ] &fYou got outbidded by %outbid-player-display-name%&f on %bid-item%&f.'
- '&fThe new top bid is &6 %top-bid% coins&f. &e&lCLICK TO VIEW'
#Message sent to the seller when someone bids on their auction
#Use %bidder% for bidder's display name
#Use %bid-amount% for the bidded amount
#Use %bid-item% for the name of the item
bid-message : '&6 [Auction ] %bidder% &fput a bid of &6%bid-amount% coins &fon your %bid-item%&f!'
not-enough-money-bid : '&cYou don''t have enough money to bid this amount.'
#This message is added to the lore of some items
#to let the player know it is their own auction
own-auction-message : '&aThis is your own auction!'
#To prevent a bug where two players bid the same amount
#on the same auction (that happening when 2 players have the same view auction menu opened
#at the same time) this message will be sent to the player if the value they try to submit
#is already in there
bid-error-message :
- '&c [Auction Error ] &fWhile you were thinking about submitting someone already bid.'
- '&cReopening menu ...'
bid-history-item : '358:0'
bid-history-item-name : '&fBid History'
bid-history-item-lore:
no-bids :
- '&7No bids have been placed on'
- '&7this item yet.'
- ''
- '&7Be the first to bid on it!'
#The lore of the bid history item is dynamic when
#it has bids on it, the structure below repeats itself
#at every new bid, adding to the lore
#Use %bid-amount% for the amount of the bid
#Use %bidder-display-name% for bidder's display name
#Use %when-bidded% for when the bid was placed (eg. 2 Days) (Ago is not included so you can modify)
bid-structure :
- '&8&m --------------'
- '&7Bid : &6%bid-amount% coins'
- '&7By : %bidder-display-name%'
- '&b %when-bidded% Ago'
#This is the message items with "Ending soon" will give when clicked
too-late-to-open-now : '&cIt is too late to open this now!'
#When the auction is claimed by the seller, the bid history
#no longer updates %when-bidded% and the message below is added
#to the bid history item lore
#Use %date% for the date of the last updated
bid-history-last-updated-message : '&8Last updated on %date%'
submit-bid-cannot-afford-item : '394'
#Use %bid-amount% for the needed amount (that the player does not have)
submit-bid-cannot-afford-item-name : '&6Submit Bid'
submit-bid-cannot-afford-item-lore :
- ''
- '&7New Bid : &6%bid-amount% coins'
- ''
- '&cCannot afford bid!'
submit-bid-item : '371'
submit-bid-item-name : '&6Submit Bid'
submit-bid-item-lore:
no-previous-bids :
- ''
- '&7New Bid : &6%bid-amount% coins'
- ''
- '&eClick to bid!'
#Use %bid-amount% for the amount the bid will have
#Use %previous-bid% for the previous bid's amount
#Use %coins-to-pay% for the difference between previous bid and actual bid
with-previous-bids :
- ''
- '&7New Bid : &6%bid-amount% coins'
- '&7Previous Bid : &e%previous-bid% coins'
- ''
- '&7You pay : &6%coins-to-pay% coins'
- ''
- '&eClick to bid!'
collect-bid-item : '41'
collect-bid-item-name : '&6Collect Auction'
collect-bid-item-lore :
#Use %coins% for the amount of coins the player could collect
collect-coins :
- ''
- '&7You have &6 %coins% coins'
- '&7to collect from this'
- '&7auction.'
- ''
- '&eClick to collect!'
collect-item :
- ''
- '&7You have items to'
- '&7collect from this auction'
- ''
- '&eClick to collect!'
edit-bid-item : '266'
#Use %current-bid% for the amount the player has selected to bid
edit-bid-item-name : '&fBid Amount : &6%current-bid% coins'
#Use %minimum-bid% for the minimum amount you have to bid on the auction
edit-bid-item-lore :
- '&7You need to bid at least'
- '&6 %minimum-bid% coins &7to hold the top'
- '&7bid on this auction.'
- ''
- '&7The &etop bid&7 on auction'
- '&7end wins the item.'
- ''
- '&7If you do not win, you can'
- '&7claim your bid coins back.'
- ''
- '&eClick to edit amount!'
#The sign used for editing has the same text
#as the starting bid on auction creator
#Message for when you try to edit the bid with a value smaller than needed
edit-bid-deny-message : '&cYour bid is too low.'
#Message for when the bid is placed successfully
placed-bid-message : '&aYour bid was successfully placed!'
#Message for when you have 28 bids (reached the limit)
max-bids-reached : '&cYou can have maximum 28 bids on different auctions at the same time.'
#Message sent to players when they get outbidded
#Use %outbid-player-display-name% for the name of the outbidder
#Use %top-bid% for the new top bid
#Use %bid-item% for the name of the item
outbid-message :
- '&6 [Auction ] &fYou got outbidded by %outbid-player-display-name%&f on %bid-item%&f.'
- '&fThe new top bid is &6 %top-bid% coins&f. &e&lCLICK TO VIEW'
#Message sent to the seller when someone bids on their auction
#Use %bidder% for bidder's display name
#Use %bid-amount% for the bidded amount
#Use %bid-item% for the name of the item
bid-message : '&6 [Auction ] %bidder% &fput a bid of &6%bid-amount% coins &fon your %bid-item%&f!'
not-enough-money-bid : '&cYou don''t have enough money to bid this amount.'
#This message is added to the lore of some items
#to let the player know it is their own auction
own-auction-message : '&aThis is your own auction!'
#To prevent a bug where two players bid the same amount
#on the same auction (that happening when 2 players have the same view auction menu opened
#at the same time) this message will be sent to the player if the value they try to submit
#is already in there
bid-error-message :
- '&c [Auction Error ] &fWhile you were thinking about submitting someone already bid.'
- '&cReopening menu ...'
Spoiler: auctions_manager.yml
Code (YAML):
#This is the lore of every auctioned item in the menu:
#Use %amount% for item's amount
auction-item-lore :
#The lore for items with no bids on them
#Use %display-name-seller% for display name of the seller
#Use %starting-bid% for the starting bid
#Use %duration% for auction duration
auction-item-no-bid :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
#The lore for items with bids on them
#Use %display-name-seller% for display name of the seller
#Use %bids% for the amount of bids
#Use %top-bid% for the top bid
#Use %top-bid-player% for the top bid player
#Use %duration% for auction duration
auction-item-with-bids :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Bids : &a%bids% bids'
- ''
- '&7Top bid : &6%top-bid% coins'
- '&7Bidder : %top-bid-player%'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
#Use %display-name-seller% for display name of the seller
#Use %bids% for the amount of bids
#Use %top-bid% for the top bid
#Use %top-bid-player% for the top bid player
auction-item-ended :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Bids : &a%bids% bids'
- ''
- '&7Top bid : &6%top-bid% coins'
- '&7Bidder : %top-bid-player%'
- ''
- '&7Status : &aEnded!'
- ''
- '&eClick to inspect!'
#Use %display-name-seller% for display name of the seller
#Use %starting-bid% for the starting bid
auction-item-expired :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Status : &cExpired!'
- ''
- '&eClick to inspect!'
sort-auction-item : '154'
sort-auction-item-name : '&aSort'
#The lore is dynamic so you can only edit
#the names of the sortings
sort-auction-item-sorting:
highest-bid : 'Highest Bid'
lowest-bid : 'Lowest Bid'
ending-soon : 'Ending Soon'
most-bids : 'Most Bids'
click-to-switch : '&eClick to switch sort!'
search-auction-item : '323'
search-auction-item-name : '&aSearch'
search-auction-item-lore :
- '&7Find items by name.'
- ''
- '&eClick to search!'
#The message displayed on the sign when searching for an auction
#There are only 3 rows because the first is where the user writes
search-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Type in your'
- 'search'
create-menu-name : '&8Auction Creator'
manage-own-auctions-menu-name : '&8Your Auctions Manager'
manage-menu-item : '418'
manage-menu-item-name : '&aManage Auctions'
manage-menu-item-lore :
#This lore is displayed when the player has no own auction
manage-no-own-auctions :
- '&7Set your own items on'
- '&7auction for other players'
- '&7to purchase.'
- ''
- '&eClick to become rich!'
#This lore is displayed when the player has pending auctions
#Use %auctions% for the number of auctions the player has
#Use %bids% for the total number of bids on their auctions
#Use %coins% for the total number of coins on their auctions
manage-with-own-auctions :
- '&7You own &e %auctions% auctions &7in'
- '&7progress or which recently'
- '&7ended.'
- ''
- '&7Your auctions have &a %bids% bids'
- '&7totaling &6 %coins% coins&7.'
- ''
- '&eClick to manage!'
preview-no-item-selected : '77'
preview-no-item-selected-name : '&eClick an item in your inventory!'
preview-no-item-selected-lore :
- '&7Selects it for auction'
preview-selected-item-name : '&a&n&lAUCTION FOR ITEM'
preview-selected-item-take-back : '&eClick to pickup!'
#This item appears when the player has 2 or more ended auctions
collect-all-item : '380'
#Use %auctions% for the number of auctions that could be collected
#Use %coins% for the total amount of coins that could be collected
#Use %items% for the expired items that could be collected
collect-all-item-name : '&aClaim All'
collect-all-item-lore:
own-auctions :
- '&8Ended Auctions'
- ''
- '&7You have &e %auctions% &7ended auctions'
- '&7totaling a value of &6 %coins% &7coins'
- '&7and &e %items% &7items from expired auctions.'
- ''
- '&eClick to claim!'
own-bids :
- '&8Ended Auctions'
- ''
- '&7There are &e %auctions% &7ended auctions'
- '&7on which you bid.'
- ''
- '&7You have &6 %coins% &7coins to'
- '&7claim back from lost auctions and'
- '&e %items% &7items from won auctions.'
- ''
- '&eClick to claim!'
#The message sent when the player has a full inventory but tries to claim an item
not-enough-inventory-space : '&cYou don''t have enough inventory space!'
collect-all-message : '&aYou just collected all your auctions!'
create-auction-item:
no-item-selected-material : '159:14'
no-item-selected-name : '&cCreate Auction'
no-item-selected-lore :
- '&7No item selected!'
- ''
- '&7Click an item in your'
- '&7inventory to select it for'
- '&7this auction.'
item-selected-material : '159:13'
item-selected-name : '&aCreate Auction'
#Use %item-name% for item's name
#Use %starting-bid% for starting bid amount
#Use %duration% for duration of the auction
#Use %fee% for the total fee
item-selected-lore :
- '&7This item will be added to'
- '&7the auction house for other'
- '&7players to purchase.'
- ''
- '&7Item : &f%item-name%'
- '&7Auction duration : &e%duration%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Creation fee : &6%fee% coins'
- ''
- '&eClick to submit!'
#The default starting bid
default-starting-bid : '500'
starting-bid-item : '266'
#Use %starting-bid% for the starting bid amount
#Use %starting-fee% for the starting bid fee
starting-bid-item-name : '&fStarting Bid : &6%starting-bid% coins'
starting-bid-item-lore :
- '&7The minimum price a player'
- '&7can offer to obtain your'
- '&7item.'
- ''
- '&7Once a player bids for your'
- '&7item, other players will'
- '&7have until the auction ends'
- '&7to make a higher bid.'
- ''
- '&7Extra fee : &6+%starting-fee% coins &e (5 %)'
- ''
- '&eClick to edit!'
#The message displayed on the sign when changing the starting bid
#There are only 3 rows because the first is where the user writes
starting-bid-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Your auction'
- 'starting bid'
#This message is shown when the starting bid
#could not be registered
starting-bid-sign-deny : '&cThat is not a valid number.'
#Don't use the % symbol, just say how much in 100
#you want the procent to be
starting-bid-fee-procent : '5'
#Use m for minute, h for hour, d for day with a space between the number and time unit
#The maxim auction time is 7 days and you can't set the auction to seconds
#If you enter the time incorectly it resets to 2 h
default-starting-duration : '2 h'
#Custom units for time
#Don't use this in the upper option, these are avalable
#just in auction messages, in the config please use the syntax from the upper comment
second : 'Second'
seconds : 'Seconds'
minute : 'Minute'
minutes : 'Minutes'
hour : 'Hour'
hours : 'Hours'
day : 'Day'
days : 'Days'
#Time units but short version:
short_second : 's'
short_minute : 'm'
short_hour : 'h'
short_day : 'd'
#This is the formula that calculates the fee for hours
#x=number of hours
extra-fee-formula : '5* (x+3 )+5*x* (Math.floor (x/9 )+Math.floor (x/20 ) )'
#The fee for minutes is fixed (5 minutes - 59 minutes)
extra-fee-minutes : '500'
extra-fee-message : 'Extra fee : '
duration-menu-name : '&8Auction Duration'
#This is the message used into duration selection menu
#on the items with time on them
duration-selection-lore : '&eClick to pick!'
duration-item : '347'
#Use %auction-fee% for the duration fee of the auction
#Use %auction-time% for the time of the auction
duration-item-name : '&fDuration : &e%auction-time%'
duration-item-lore :
- '&7How long players will be'
- '&7able to place bids for'
- ''
- '&7Note : Bids automatically'
- '&7increase the duration of'
- '&7auctions.'
- ''
- '&7Extra fee : &6+%auction-fee% coins'
- ''
- '&eClick to edit!'
#The clock inside the duration menu
duration-select-item-name : '&aCustom Duration'
duration-select-item-lore :
- '&7Specify how long you want'
- '&7the auction to last.'
- ''
- '&bRight Click for minutes!'
- '&eClick to set hours!'
#The message displayed on the sign when changing the duration of the bid
#There are only 3 rows because the first is where the user writes
#%time-format% is hours/minutes.
duration-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Auction'
- ' %time-format%'
#The message shown when the amount of hours/minutes entered is incorrect
duration-sign-deny : '&cThat is not a valid number.'
not-enough-money-auction : '&cYou don''t have enough money to create this auction.'
auction-confirm-menu-name : '&8Confirm Auction'
auction-confirm-item-material : '159:13'
auction-confirm-item-name : '&aConfirm'
#Use %cost% for the total price the player
#has to pay to create the auction
auction-confirm-item-lore:
- '&7Auction Cost : &6%cost% coins'
- ''
- '&7Are you sure you want'
- '&7to create the auction?'
- ''
- '&eClick to confirm!'
auction-cancel-item-material : '159:14'
auction-cancel-item-name : '&cCancel'
auction-cancel-item-lore :
- '&7Cancel the creation'
- '&7of the auction.'
auction-created-message : '&aYour auction was created!'
#Use %amount% for item's amount
auction-item-lore :
#The lore for items with no bids on them
#Use %display-name-seller% for display name of the seller
#Use %starting-bid% for the starting bid
#Use %duration% for auction duration
auction-item-no-bid :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
#The lore for items with bids on them
#Use %display-name-seller% for display name of the seller
#Use %bids% for the amount of bids
#Use %top-bid% for the top bid
#Use %top-bid-player% for the top bid player
#Use %duration% for auction duration
auction-item-with-bids :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Bids : &a%bids% bids'
- ''
- '&7Top bid : &6%top-bid% coins'
- '&7Bidder : %top-bid-player%'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
#Use %display-name-seller% for display name of the seller
#Use %bids% for the amount of bids
#Use %top-bid% for the top bid
#Use %top-bid-player% for the top bid player
auction-item-ended :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Bids : &a%bids% bids'
- ''
- '&7Top bid : &6%top-bid% coins'
- '&7Bidder : %top-bid-player%'
- ''
- '&7Status : &aEnded!'
- ''
- '&eClick to inspect!'
#Use %display-name-seller% for display name of the seller
#Use %starting-bid% for the starting bid
auction-item-expired :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Status : &cExpired!'
- ''
- '&eClick to inspect!'
sort-auction-item : '154'
sort-auction-item-name : '&aSort'
#The lore is dynamic so you can only edit
#the names of the sortings
sort-auction-item-sorting:
highest-bid : 'Highest Bid'
lowest-bid : 'Lowest Bid'
ending-soon : 'Ending Soon'
most-bids : 'Most Bids'
click-to-switch : '&eClick to switch sort!'
search-auction-item : '323'
search-auction-item-name : '&aSearch'
search-auction-item-lore :
- '&7Find items by name.'
- ''
- '&eClick to search!'
#The message displayed on the sign when searching for an auction
#There are only 3 rows because the first is where the user writes
search-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Type in your'
- 'search'
create-menu-name : '&8Auction Creator'
manage-own-auctions-menu-name : '&8Your Auctions Manager'
manage-menu-item : '418'
manage-menu-item-name : '&aManage Auctions'
manage-menu-item-lore :
#This lore is displayed when the player has no own auction
manage-no-own-auctions :
- '&7Set your own items on'
- '&7auction for other players'
- '&7to purchase.'
- ''
- '&eClick to become rich!'
#This lore is displayed when the player has pending auctions
#Use %auctions% for the number of auctions the player has
#Use %bids% for the total number of bids on their auctions
#Use %coins% for the total number of coins on their auctions
manage-with-own-auctions :
- '&7You own &e %auctions% auctions &7in'
- '&7progress or which recently'
- '&7ended.'
- ''
- '&7Your auctions have &a %bids% bids'
- '&7totaling &6 %coins% coins&7.'
- ''
- '&eClick to manage!'
preview-no-item-selected : '77'
preview-no-item-selected-name : '&eClick an item in your inventory!'
preview-no-item-selected-lore :
- '&7Selects it for auction'
preview-selected-item-name : '&a&n&lAUCTION FOR ITEM'
preview-selected-item-take-back : '&eClick to pickup!'
#This item appears when the player has 2 or more ended auctions
collect-all-item : '380'
#Use %auctions% for the number of auctions that could be collected
#Use %coins% for the total amount of coins that could be collected
#Use %items% for the expired items that could be collected
collect-all-item-name : '&aClaim All'
collect-all-item-lore:
own-auctions :
- '&8Ended Auctions'
- ''
- '&7You have &e %auctions% &7ended auctions'
- '&7totaling a value of &6 %coins% &7coins'
- '&7and &e %items% &7items from expired auctions.'
- ''
- '&eClick to claim!'
own-bids :
- '&8Ended Auctions'
- ''
- '&7There are &e %auctions% &7ended auctions'
- '&7on which you bid.'
- ''
- '&7You have &6 %coins% &7coins to'
- '&7claim back from lost auctions and'
- '&e %items% &7items from won auctions.'
- ''
- '&eClick to claim!'
#The message sent when the player has a full inventory but tries to claim an item
not-enough-inventory-space : '&cYou don''t have enough inventory space!'
collect-all-message : '&aYou just collected all your auctions!'
create-auction-item:
no-item-selected-material : '159:14'
no-item-selected-name : '&cCreate Auction'
no-item-selected-lore :
- '&7No item selected!'
- ''
- '&7Click an item in your'
- '&7inventory to select it for'
- '&7this auction.'
item-selected-material : '159:13'
item-selected-name : '&aCreate Auction'
#Use %item-name% for item's name
#Use %starting-bid% for starting bid amount
#Use %duration% for duration of the auction
#Use %fee% for the total fee
item-selected-lore :
- '&7This item will be added to'
- '&7the auction house for other'
- '&7players to purchase.'
- ''
- '&7Item : &f%item-name%'
- '&7Auction duration : &e%duration%'
- '&7Starting bid : &6%starting-bid% coins'
- ''
- '&7Creation fee : &6%fee% coins'
- ''
- '&eClick to submit!'
#The default starting bid
default-starting-bid : '500'
starting-bid-item : '266'
#Use %starting-bid% for the starting bid amount
#Use %starting-fee% for the starting bid fee
starting-bid-item-name : '&fStarting Bid : &6%starting-bid% coins'
starting-bid-item-lore :
- '&7The minimum price a player'
- '&7can offer to obtain your'
- '&7item.'
- ''
- '&7Once a player bids for your'
- '&7item, other players will'
- '&7have until the auction ends'
- '&7to make a higher bid.'
- ''
- '&7Extra fee : &6+%starting-fee% coins &e (5 %)'
- ''
- '&eClick to edit!'
#The message displayed on the sign when changing the starting bid
#There are only 3 rows because the first is where the user writes
starting-bid-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Your auction'
- 'starting bid'
#This message is shown when the starting bid
#could not be registered
starting-bid-sign-deny : '&cThat is not a valid number.'
#Don't use the % symbol, just say how much in 100
#you want the procent to be
starting-bid-fee-procent : '5'
#Use m for minute, h for hour, d for day with a space between the number and time unit
#The maxim auction time is 7 days and you can't set the auction to seconds
#If you enter the time incorectly it resets to 2 h
default-starting-duration : '2 h'
#Custom units for time
#Don't use this in the upper option, these are avalable
#just in auction messages, in the config please use the syntax from the upper comment
second : 'Second'
seconds : 'Seconds'
minute : 'Minute'
minutes : 'Minutes'
hour : 'Hour'
hours : 'Hours'
day : 'Day'
days : 'Days'
#Time units but short version:
short_second : 's'
short_minute : 'm'
short_hour : 'h'
short_day : 'd'
#This is the formula that calculates the fee for hours
#x=number of hours
extra-fee-formula : '5* (x+3 )+5*x* (Math.floor (x/9 )+Math.floor (x/20 ) )'
#The fee for minutes is fixed (5 minutes - 59 minutes)
extra-fee-minutes : '500'
extra-fee-message : 'Extra fee : '
duration-menu-name : '&8Auction Duration'
#This is the message used into duration selection menu
#on the items with time on them
duration-selection-lore : '&eClick to pick!'
duration-item : '347'
#Use %auction-fee% for the duration fee of the auction
#Use %auction-time% for the time of the auction
duration-item-name : '&fDuration : &e%auction-time%'
duration-item-lore :
- '&7How long players will be'
- '&7able to place bids for'
- ''
- '&7Note : Bids automatically'
- '&7increase the duration of'
- '&7auctions.'
- ''
- '&7Extra fee : &6+%auction-fee% coins'
- ''
- '&eClick to edit!'
#The clock inside the duration menu
duration-select-item-name : '&aCustom Duration'
duration-select-item-lore :
- '&7Specify how long you want'
- '&7the auction to last.'
- ''
- '&bRight Click for minutes!'
- '&eClick to set hours!'
#The message displayed on the sign when changing the duration of the bid
#There are only 3 rows because the first is where the user writes
#%time-format% is hours/minutes.
duration-sign-message :
- '^^^^^^^^^^^^^^^'
- 'Auction'
- ' %time-format%'
#The message shown when the amount of hours/minutes entered is incorrect
duration-sign-deny : '&cThat is not a valid number.'
not-enough-money-auction : '&cYou don''t have enough money to create this auction.'
auction-confirm-menu-name : '&8Confirm Auction'
auction-confirm-item-material : '159:13'
auction-confirm-item-name : '&aConfirm'
#Use %cost% for the total price the player
#has to pay to create the auction
auction-confirm-item-lore:
- '&7Auction Cost : &6%cost% coins'
- ''
- '&7Are you sure you want'
- '&7to create the auction?'
- ''
- '&eClick to confirm!'
auction-cancel-item-material : '159:14'
auction-cancel-item-name : '&cCancel'
auction-cancel-item-lore :
- '&7Cancel the creation'
- '&7of the auction.'
auction-created-message : '&aYour auction was created!'
Spoiler: admin_config.yml
Code (YAML):
#Here you can edit messages from the admin menu
npccreate-item-name : '&aCreate NPC'
npccreate-item-lore :
- '&7Create a &aAuctionMaster NPC'
- '&7at your current location.'
- ''
- '&7After the NPC is created you'
- '&7can use basic Citizens commands'
- '&7on it.'
- ''
- '&7You need &aCitizens'
- '&7for this option to work properly!'
npc-debug-item-name : '&aDebug NPCs'
npc-debug-item-lore :
- '&7If you have multiple NPCs'
- '&7and they don''t have their title'
- '&7aligned with their entity'
- '&7click this item.'
manage-ended-auctions-item-name : '&aManage Ended Auctions'
manage-ended-auctions-item-lore :
- '&7Manage ended or expired auctions'
- '&7by forcefully deleting them.'
- ''
- '&7You can delete the auction in two ways:'
- ''
- '&7By sending the items & money'
- '&7via a &aDelivery&7.'
- ''
- '&7By completly erasing the auction,'
- '&7players will lose their money and items.'
manage-auctions-item-name : '&aManage Auctions'
manage-auctions-item-lore :
- '&7Manage auctions that are not ended.'
- '&7You can add time to an auction, delete it,'
- '&7edit its price, end it, remove bids.'
- ''
- '&7You can also duplicate the auctioned'
- '&7item and place it into your inventory.'
delivery-item-name : '&aSend Deliveries'
delivery-item-lore :
- '&7Send a &aDelivery&7 to'
- '&7a player. You can also delete'
- '&7players'' deliveries using'
- '&7commands. &a/ahadmin delivery'
help-item-name : '&aCommands Help'
help-item-lore :
- '&7Use &a/ahadmin help&7 or'
- '&7click this item to show'
- '&7a list of admin commands'
- '&7you could use.'
delete-auction-item:
with-delivery-name : '&aDelete Auction with Delivery'
with-delivery-lore :
- '&7Click to delete the auction'
- '&7and erase all data about it'
- '&7but sending all the unclaimed'
- '&7bid coins & items via a &aDelivery&7.'
without-delivery-name : '&aDelete Auction'
without-delivery-lore :
- '&7Click to delete the auction'
- '&7and erase all data about it.'
- ''
- '&cATTENTION!'
- '&7All players involved in this'
- '&7auction will lose their bids & coins!'
#This is the manage bids item for auctions that are ended
manage-bids-item-name : '&aDelete Unclaimed Bids'
manage-bids-item-lore :
- '&7From here you can forcefully'
- '&7remove bids that are not claimed.'
- ''
- '&7You can delete them by giving'
- '&7the coins/item to the bidder'
- '&7via a delivery or just delete them.'
#This is the manage bids item for auctions that are not ended
manage-bids-item-name2 : '&aDelete Bids'
manage-bids-item-lore2 :
- '&7From here you can forcefully'
- '&7remove bids from an auction.'
- ''
- '&7You can delete them by giving'
- '&7the coins to the bidder'
- '&7via a delivery or just delete them.'
get-item-copy-name : '&aGet Item Copy'
get-item-copy-lore :
- '&7Copy in your inventory'
- '&7the item held by this auction.'
force-end-auction-name : '&aEnd Auction'
force-end-auction-lore :
- '&7Click to forcefully end'
- '&7an auction by setting it''s'
- '&7ending date to the'
- '&7current time.'
- ''
- '&cATENTION!'
- '&7This is not reversible!'
edit-duration-item-name : '&aEdit Auction''s Duration'
edit-duration-item-lore :
- '&7Click to modify the auction''s'
- '&7duration by setting or'
- '&7adding/substracting time.'
- ''
- '&7All modifications are in minutes'
- '&7for more accuracy, if you want'
- '&7hours/days just do the math ...'
- ''
- '&eLeft Click to set Duration'
- '&bRight Click to add/substract'
selected-player-item-name : '&aSelected Player'
selected-player-item-lore :
- '&7Click to select a player for whom'
- '&7you will apply the options below.'
- ''
- '&7Selected Player : &a%player%'
- ''
- '&7Attention! The delivery will be sent'
- '&7even if the username entered'
- '&7does not exist!'
- ''
- '&7Current Delivery Data:'
- '&7Delivery Items : &e%items-count%'
- '&7Delivery Coins : &e%coins%'
delivery-send-item-name : '&aSend Delivery'
delivery-send-item-lore :
- '&7Click to config a'
- '&7delivery and send it to'
- '&7the selected player.'
delivery-set-item-name : '&aSet Delivery'
delivery-set-item-lore :
- '&7Click to config a'
- '&7delivery that will overwrite'
- '&7any existent delivery of'
- '&7the selected player.'
delivery-remove-item-name : '&aRemove Delivery'
delivery-remove-item-lore :
- '&7Click to remove all'
- '&7items and coins from'
- '&7selected player''s delivery.'
delivery-item-clone-name : '&aGet Delivery Items'
delivery-item-clone-lore :
- '&7Get the items from player''s delivery'
- '&7in your inventory. If you don''t have'
- '&7enough space, the remaining items will'
- '&7be dropped on the ground.'
no-selected-player-message : '&cYou can''t click this until you have a player selected!'
no-delivery-to-send : '&cI have nothing to send, select some coins and/or put some items in the free slots!'
no-delivery-to-set : '&cI have nothing to set, if you want to remove their delivery, use the right setting.'
no-delivery-to-work-with : '&cThe selected player has no delivery so this action won''t work!'
delivery-coins-item-name : '&aDelivery Coins'
delivery-coins-item-lore:
- '&7Current Coins : &6%coins% coins'
- ''
- '&7Click to edit the amount'
- '&7of coins this delivery will'
- '&7contain.'
confirm-action-item-name : '&aDone!'
confirm-action-item-lore :
- '&7If you think you are'
- '&7done and want to complete'
- '&7this action, click here!'
cancel-action-item-name : '&cCancel'
cancel-action-item-lore :
- '&7Cancel this action and'
- '&7go back to the'
- '&7previous menu.'
npccreate-item-name : '&aCreate NPC'
npccreate-item-lore :
- '&7Create a &aAuctionMaster NPC'
- '&7at your current location.'
- ''
- '&7After the NPC is created you'
- '&7can use basic Citizens commands'
- '&7on it.'
- ''
- '&7You need &aCitizens'
- '&7for this option to work properly!'
npc-debug-item-name : '&aDebug NPCs'
npc-debug-item-lore :
- '&7If you have multiple NPCs'
- '&7and they don''t have their title'
- '&7aligned with their entity'
- '&7click this item.'
manage-ended-auctions-item-name : '&aManage Ended Auctions'
manage-ended-auctions-item-lore :
- '&7Manage ended or expired auctions'
- '&7by forcefully deleting them.'
- ''
- '&7You can delete the auction in two ways:'
- ''
- '&7By sending the items & money'
- '&7via a &aDelivery&7.'
- ''
- '&7By completly erasing the auction,'
- '&7players will lose their money and items.'
manage-auctions-item-name : '&aManage Auctions'
manage-auctions-item-lore :
- '&7Manage auctions that are not ended.'
- '&7You can add time to an auction, delete it,'
- '&7edit its price, end it, remove bids.'
- ''
- '&7You can also duplicate the auctioned'
- '&7item and place it into your inventory.'
delivery-item-name : '&aSend Deliveries'
delivery-item-lore :
- '&7Send a &aDelivery&7 to'
- '&7a player. You can also delete'
- '&7players'' deliveries using'
- '&7commands. &a/ahadmin delivery'
help-item-name : '&aCommands Help'
help-item-lore :
- '&7Use &a/ahadmin help&7 or'
- '&7click this item to show'
- '&7a list of admin commands'
- '&7you could use.'
delete-auction-item:
with-delivery-name : '&aDelete Auction with Delivery'
with-delivery-lore :
- '&7Click to delete the auction'
- '&7and erase all data about it'
- '&7but sending all the unclaimed'
- '&7bid coins & items via a &aDelivery&7.'
without-delivery-name : '&aDelete Auction'
without-delivery-lore :
- '&7Click to delete the auction'
- '&7and erase all data about it.'
- ''
- '&cATTENTION!'
- '&7All players involved in this'
- '&7auction will lose their bids & coins!'
#This is the manage bids item for auctions that are ended
manage-bids-item-name : '&aDelete Unclaimed Bids'
manage-bids-item-lore :
- '&7From here you can forcefully'
- '&7remove bids that are not claimed.'
- ''
- '&7You can delete them by giving'
- '&7the coins/item to the bidder'
- '&7via a delivery or just delete them.'
#This is the manage bids item for auctions that are not ended
manage-bids-item-name2 : '&aDelete Bids'
manage-bids-item-lore2 :
- '&7From here you can forcefully'
- '&7remove bids from an auction.'
- ''
- '&7You can delete them by giving'
- '&7the coins to the bidder'
- '&7via a delivery or just delete them.'
get-item-copy-name : '&aGet Item Copy'
get-item-copy-lore :
- '&7Copy in your inventory'
- '&7the item held by this auction.'
force-end-auction-name : '&aEnd Auction'
force-end-auction-lore :
- '&7Click to forcefully end'
- '&7an auction by setting it''s'
- '&7ending date to the'
- '&7current time.'
- ''
- '&cATENTION!'
- '&7This is not reversible!'
edit-duration-item-name : '&aEdit Auction''s Duration'
edit-duration-item-lore :
- '&7Click to modify the auction''s'
- '&7duration by setting or'
- '&7adding/substracting time.'
- ''
- '&7All modifications are in minutes'
- '&7for more accuracy, if you want'
- '&7hours/days just do the math ...'
- ''
- '&eLeft Click to set Duration'
- '&bRight Click to add/substract'
selected-player-item-name : '&aSelected Player'
selected-player-item-lore :
- '&7Click to select a player for whom'
- '&7you will apply the options below.'
- ''
- '&7Selected Player : &a%player%'
- ''
- '&7Attention! The delivery will be sent'
- '&7even if the username entered'
- '&7does not exist!'
- ''
- '&7Current Delivery Data:'
- '&7Delivery Items : &e%items-count%'
- '&7Delivery Coins : &e%coins%'
delivery-send-item-name : '&aSend Delivery'
delivery-send-item-lore :
- '&7Click to config a'
- '&7delivery and send it to'
- '&7the selected player.'
delivery-set-item-name : '&aSet Delivery'
delivery-set-item-lore :
- '&7Click to config a'
- '&7delivery that will overwrite'
- '&7any existent delivery of'
- '&7the selected player.'
delivery-remove-item-name : '&aRemove Delivery'
delivery-remove-item-lore :
- '&7Click to remove all'
- '&7items and coins from'
- '&7selected player''s delivery.'
delivery-item-clone-name : '&aGet Delivery Items'
delivery-item-clone-lore :
- '&7Get the items from player''s delivery'
- '&7in your inventory. If you don''t have'
- '&7enough space, the remaining items will'
- '&7be dropped on the ground.'
no-selected-player-message : '&cYou can''t click this until you have a player selected!'
no-delivery-to-send : '&cI have nothing to send, select some coins and/or put some items in the free slots!'
no-delivery-to-set : '&cI have nothing to set, if you want to remove their delivery, use the right setting.'
no-delivery-to-work-with : '&cThe selected player has no delivery so this action won''t work!'
delivery-coins-item-name : '&aDelivery Coins'
delivery-coins-item-lore:
- '&7Current Coins : &6%coins% coins'
- ''
- '&7Click to edit the amount'
- '&7of coins this delivery will'
- '&7contain.'
confirm-action-item-name : '&aDone!'
confirm-action-item-lore :
- '&7If you think you are'
- '&7done and want to complete'
- '&7this action, click here!'
cancel-action-item-name : '&cCancel'
cancel-action-item-lore :
- '&7Cancel this action and'
- '&7go back to the'
- '&7previous menu.'
Spoiler: sounds.yml
Code (YAML):
#Use 'none' for no sound
#Sounds List - https://helpch.at/docs/version/index.html?org/bukkit/Sound.html
#Replace version with your server version^
#Example of usage (1.8.8): https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html
#ah-command: 'ORB_PICKUP"
#---------Command Sounds---------------
#Sound for /ah
ah-command : ' none'
#Sound for /ah <player>
ah-player : ' none'
#Sound for /ah delivery
ah-delivery-command : ' none'
#---------General Sounds---------------
#Sound for npc click
ah-npc-click : ' none'
#Sound for background click
background-click : ' none'
#Go back item click
go-back-click : ' none'
#Next page item click
next-page-click : ' none'
#Previous page item click
previous-page-click : ' none'
#Close inventory item click
close-menu-click : ' none'
#Sound for claim-all item click
claim-all-click : ' none'
#Sound for claim money
claim-money : ' none'
#Sound for claim item
claim-item : ' none'
#Item in inventory click cancel sound
inventory-click-cancel : ' none'
#---------Delivery Sounds--------------
#Sound for delivery received
ah-delivery-got : ' none'
#Sound for delvery claim
ah-delivery-claimed : ' none'
#Sound for no delivery to claim
ah-no-delivery : ' none'
#---------Main Menu Sounds-------------
#Sound for auction browser click in the main menu
auction-browser-click : ' none'
#Sound for view bids click if player has bids in the main menu
view-bids-has-click : ' none'
#Sound for view bids click if player doesn't have bids in the main menu
view-bids-no-has-click : ' none'
#Sound for own-auctions click in the main menu
own-auctions-click : ' none'
#Sound for delivery-menu click in the main menu
delivery-menu-click : ' none'
#--------Auction Browser Sounds-------
#Sound for category click in the auction browser menu
category-click : ' none'
#Sound for sort item click in the auction browser menu
sort-item-click : ' none'
#Sound for search item click in the auction browser menu
search-item-click : ' none'
#-------Auction Creator Sounds--------
#Sound for inventory item click
inventory-item-click : ' none'
#Sound for duration item click
duration-item-click : ' none'
#Sound for starting-bid item click
starting-bid-item-click : ' none'
#Sound for create auction item » item selected
create-auction-item-click : ' none'
#Sound for confirm auction cancel
auction-cancel : ' none'
#Sound for confirm auction
auction-confirm : ' none'
#-------Duration Menu Sounds----------
#Sound for custom-duration item click
custom-duration-click : ' none'
#Sounds for other duration items click:
1-hour : ' none'
6-hours : ' none'
12-hours : ' none'
24-hours : ' none'
2-days : ' none'
#-------Auction View Sounds-----------
#Sound for auction view menu open
auction-view-menu-open : ' none'
#Sound for submited bit
auction-submit-bid : ' none'
#Sound for bid amount editor click
bid-editor-click : ' none'
#Sound that comes with the outbid message
#This sound will be sent to the seller too
outbid : ' none'
#Sounds List - https://helpch.at/docs/version/index.html?org/bukkit/Sound.html
#Replace version with your server version^
#Example of usage (1.8.8): https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html
#ah-command: 'ORB_PICKUP"
#---------Command Sounds---------------
#Sound for /ah
ah-command : ' none'
#Sound for /ah <player>
ah-player : ' none'
#Sound for /ah delivery
ah-delivery-command : ' none'
#---------General Sounds---------------
#Sound for npc click
ah-npc-click : ' none'
#Sound for background click
background-click : ' none'
#Go back item click
go-back-click : ' none'
#Next page item click
next-page-click : ' none'
#Previous page item click
previous-page-click : ' none'
#Close inventory item click
close-menu-click : ' none'
#Sound for claim-all item click
claim-all-click : ' none'
#Sound for claim money
claim-money : ' none'
#Sound for claim item
claim-item : ' none'
#Item in inventory click cancel sound
inventory-click-cancel : ' none'
#---------Delivery Sounds--------------
#Sound for delivery received
ah-delivery-got : ' none'
#Sound for delvery claim
ah-delivery-claimed : ' none'
#Sound for no delivery to claim
ah-no-delivery : ' none'
#---------Main Menu Sounds-------------
#Sound for auction browser click in the main menu
auction-browser-click : ' none'
#Sound for view bids click if player has bids in the main menu
view-bids-has-click : ' none'
#Sound for view bids click if player doesn't have bids in the main menu
view-bids-no-has-click : ' none'
#Sound for own-auctions click in the main menu
own-auctions-click : ' none'
#Sound for delivery-menu click in the main menu
delivery-menu-click : ' none'
#--------Auction Browser Sounds-------
#Sound for category click in the auction browser menu
category-click : ' none'
#Sound for sort item click in the auction browser menu
sort-item-click : ' none'
#Sound for search item click in the auction browser menu
search-item-click : ' none'
#-------Auction Creator Sounds--------
#Sound for inventory item click
inventory-item-click : ' none'
#Sound for duration item click
duration-item-click : ' none'
#Sound for starting-bid item click
starting-bid-item-click : ' none'
#Sound for create auction item » item selected
create-auction-item-click : ' none'
#Sound for confirm auction cancel
auction-cancel : ' none'
#Sound for confirm auction
auction-confirm : ' none'
#-------Duration Menu Sounds----------
#Sound for custom-duration item click
custom-duration-click : ' none'
#Sounds for other duration items click:
1-hour : ' none'
6-hours : ' none'
12-hours : ' none'
24-hours : ' none'
2-days : ' none'
#-------Auction View Sounds-----------
#Sound for auction view menu open
auction-view-menu-open : ' none'
#Sound for submited bit
auction-submit-bid : ' none'
#Sound for bid amount editor click
bid-editor-click : ' none'
#Sound that comes with the outbid message
#This sound will be sent to the seller too
outbid : ' none'
Spoiler: menus.yml
Code (YAML):
main-menu:
size : 36
close-menu-slot : 31
browsing-menu-slot : 11
view-bids-menu-slot : 13
manage-auctions-menu-slot : 15
delivery-menu-slot : 32
create-auction-menu:
size : 54
preview-item-slot : 13
create-auction-button-slot : 29
starting-bid-slot : 31
duration-slot : 33
go-back-slot : 49
switch-type-slot : 48
duration-select-menu:
size : 36
first-item:
hours : 1
material : '159:14'
slot : 10
second-item:
hours : 6
material : '159:6'
slot : 11
third-item:
hours : 12
material : '159:1'
slot : 12
forth-item:
hours : 24
material : '159:4'
slot : 13
fifth-item:
hours : 48
material : '159:0'
slot : 14
custom-time-item-slot : 16
custom-time-item-material : '347'
go-back-slot : 31
create-auction-confirm-menu:
size : 27
confirm-item-slot : 11
cancel-item-slot : 15
browsing-menu :
#Which category is the default on open
#Options: weapons, armor, tools, consumables, blocks, others, global
default-category : 'weapons'
#Use slots from 1 to 6 for normal categories
#Make sure there are not 2 slots with same value
#Set the value to -1 to disable category
weapons-slot : 1
armor-slot : 2
tools-slot : 3
consumables-slot : 4
blocks-slot : 5
others-slot : 6
#This slot is from 0 to 53
#It can be any slot but make sure to not put
#it where the auctions should be
global-slot : 50
go-back-slot : 49
search-slot : 48
bin-filter-slot : 51
sort-filter-slot : 52
previous-page-slot : 46
next-page-slot : 53
view-auction-menu:
size : 54
auction-display-slot : 13
place-bid-slot : 29
buy-it-now-slot : 31
bid-amount-change-slot : 31
end-own-auction-slot : 40
bid-history-slot : 33
go-back-slot : 49
admin-view-slot : 22
size : 36
close-menu-slot : 31
browsing-menu-slot : 11
view-bids-menu-slot : 13
manage-auctions-menu-slot : 15
delivery-menu-slot : 32
create-auction-menu:
size : 54
preview-item-slot : 13
create-auction-button-slot : 29
starting-bid-slot : 31
duration-slot : 33
go-back-slot : 49
switch-type-slot : 48
duration-select-menu:
size : 36
first-item:
hours : 1
material : '159:14'
slot : 10
second-item:
hours : 6
material : '159:6'
slot : 11
third-item:
hours : 12
material : '159:1'
slot : 12
forth-item:
hours : 24
material : '159:4'
slot : 13
fifth-item:
hours : 48
material : '159:0'
slot : 14
custom-time-item-slot : 16
custom-time-item-material : '347'
go-back-slot : 31
create-auction-confirm-menu:
size : 27
confirm-item-slot : 11
cancel-item-slot : 15
browsing-menu :
#Which category is the default on open
#Options: weapons, armor, tools, consumables, blocks, others, global
default-category : 'weapons'
#Use slots from 1 to 6 for normal categories
#Make sure there are not 2 slots with same value
#Set the value to -1 to disable category
weapons-slot : 1
armor-slot : 2
tools-slot : 3
consumables-slot : 4
blocks-slot : 5
others-slot : 6
#This slot is from 0 to 53
#It can be any slot but make sure to not put
#it where the auctions should be
global-slot : 50
go-back-slot : 49
search-slot : 48
bin-filter-slot : 51
sort-filter-slot : 52
previous-page-slot : 46
next-page-slot : 53
view-auction-menu:
size : 54
auction-display-slot : 13
place-bid-slot : 29
buy-it-now-slot : 31
bid-amount-change-slot : 31
end-own-auction-slot : 40
bid-history-slot : 33
go-back-slot : 49
admin-view-slot : 22
Spoiler: buyItNow.yml
Code (YAML):
use-buy-it-now
: true
buy-it-now-select-price:
item-id : '27'
#Use %price% for the item price
name : '&fItem price : &6%price%'
lore :
- '&7The price at which you want'
- '&7to sell this item.'
- ''
- '&7Extra fee : &6+%fee% coins &e (1 %)'
- ''
- '&eClick to edit!'
#Use percents from 1 to 100
buy-it-now-fee : 1
switch-button:
switch-to-auction:
material : '266'
name : '&aSwitch to Auction'
lore :
- '&7With traditional auctions,'
- '&7multiple buyers compete for the'
- '&7item by bidding turn by turn.'
- ''
- '&eClick to switch!'
switch-to-bin:
material : 27
name : '&aSwitch to BIN'
lore :
- '&7BIN Auctions are simple.'
- ''
- '&7Set a price, then one player may'
- '&7buy the item at that price.'
- ''
- '&8 (BIN means Buy It Now )'
- ''
- '&eClick to switch!'
buy-it-now-lore:
on-going :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Buy It Now : &6%starting-bid% coins'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
expired :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Buy It Now : &6%price% coins'
- ''
- '&7Status : &cExpired!'
- ''
- '&eClick to inspect!'
#Use %buyer-display-name% for buyer's display name
#Use %buyer-name% for buyer's username
bought :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Price : &6%price% coins'
- ''
- '&7Bought by : %buyer-display-name%'
- ''
- '&eClick to inspect!'
#Use %item% for item's display name
#Use %seller-display-name% for seller display's name
#Use %seller-name% for seller's name
#Use %coins% for the amount of coins the item was bought for
bought-item-message : '&eYou purchased &f %item% &efrom %seller-display-name% &efor &6%coins% coins&e!'
#Seller notification for bought item
bought-seller-notification : '&6 [Auction ] %bidder-display-name% &fhas bought your %item%&f for &6%price% coins&f!'
sort-item:
material : '381'
name : '&aBIN Filter'
show-all : 'Show All'
bin-only : 'BIN Only'
auctions-only : 'Auctions Only'
click-to-switch : '&eClick to switch filter!'
view-auction-buy-now-button:
name : '&6Buy Item Right Now'
click-to-buy:
material : '371'
lore :
- ''
- '&7Price : &6%price% coins'
- ''
- '&eClick to purchase!'
cannot-afford:
material : '394'
lore :
- ''
- '&7Price : &6%price% coins'
- ''
- '&cCannot afford bid!'
buy-it-now-select-price:
item-id : '27'
#Use %price% for the item price
name : '&fItem price : &6%price%'
lore :
- '&7The price at which you want'
- '&7to sell this item.'
- ''
- '&7Extra fee : &6+%fee% coins &e (1 %)'
- ''
- '&eClick to edit!'
#Use percents from 1 to 100
buy-it-now-fee : 1
switch-button:
switch-to-auction:
material : '266'
name : '&aSwitch to Auction'
lore :
- '&7With traditional auctions,'
- '&7multiple buyers compete for the'
- '&7item by bidding turn by turn.'
- ''
- '&eClick to switch!'
switch-to-bin:
material : 27
name : '&aSwitch to BIN'
lore :
- '&7BIN Auctions are simple.'
- ''
- '&7Set a price, then one player may'
- '&7buy the item at that price.'
- ''
- '&8 (BIN means Buy It Now )'
- ''
- '&eClick to switch!'
buy-it-now-lore:
on-going :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Buy It Now : &6%starting-bid% coins'
- ''
- '&7Ends in : &e%duration%'
- ''
- '&eClick to inspect!'
expired :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Buy It Now : &6%price% coins'
- ''
- '&7Status : &cExpired!'
- ''
- '&eClick to inspect!'
#Use %buyer-display-name% for buyer's display name
#Use %buyer-name% for buyer's username
bought :
- '&8&m ---------------------'
- '&7Seller : %display-name-seller%'
- '&7Price : &6%price% coins'
- ''
- '&7Bought by : %buyer-display-name%'
- ''
- '&eClick to inspect!'
#Use %item% for item's display name
#Use %seller-display-name% for seller display's name
#Use %seller-name% for seller's name
#Use %coins% for the amount of coins the item was bought for
bought-item-message : '&eYou purchased &f %item% &efrom %seller-display-name% &efor &6%coins% coins&e!'
#Seller notification for bought item
bought-seller-notification : '&6 [Auction ] %bidder-display-name% &fhas bought your %item%&f for &6%price% coins&f!'
sort-item:
material : '381'
name : '&aBIN Filter'
show-all : 'Show All'
bin-only : 'BIN Only'
auctions-only : 'Auctions Only'
click-to-switch : '&eClick to switch filter!'
view-auction-buy-now-button:
name : '&6Buy Item Right Now'
click-to-buy:
material : '371'
lore :
- ''
- '&7Price : &6%price% coins'
- ''
- '&eClick to purchase!'
cannot-afford:
material : '394'
lore :
- ''
- '&7Price : &6%price% coins'
- ''
- '&cCannot afford bid!'
Every category menu also has a specific config
Spoiler: example_menu.yml
Code (YAML):
others-menu-item
: '32'
others-menu-name : '&2Others'
others-menu-lore :
- '&8Category'
- ''
- '&7Anything that is'
- '&7auctionable and not'
- '&7in other categories.'
#If you have custom items that you want to be in this
#category, specify their name here
custom-item-names :
- '&e&lExample &6&lItem'
custom-item-ids :
- '2266'
others-menu-name : '&2Others'
others-menu-lore :
- '&8Category'
- ''
- '&7Anything that is'
- '&7auctionable and not'
- '&7in other categories.'
#If you have custom items that you want to be in this
#category, specify their name here
custom-item-names :
- '&e&lExample &6&lItem'
custom-item-ids :
- '2266'
The auction menu is made out of 4 main elements: Auction Browser, View Bids, Manage Auctions, Delivery.
In Manage Auctions Menu are displayed your own auctions, if there are any,
otherwise it will open an auction creator menu. For creating a new auction you will have to pay a fee for the starting bid and the duration of the auction (both configurable). You can have maximum 28 auctions at the same time.
The View Bids Menu displays all items you have a bid on and also tells you on how many of them you hold the top bid.
You can have maximum 28 bids at the same time.
An auction will have the following display, mostly configurable:
The Auction Browser Menu is made of more categories in which auctions will be filtered (the way the items are asigned can be modified in the specific category config).
Also, the Auction Browser Menu has a Search feature as well as a Sorting system!
The duration of an auction is dynamically displayed in auction browser menu.
Bids of an auction are displayed on a bid history item while inspecting the auction. If you have a previous bid on the auction and want to bid again, it will take from your balance only the difference between the previous bid and the new bid but at each new bid you must bid atleast 15% more coins than the top bid.
Auctions Data is stored in a SQLite file and updated based on auction interaction, the auction data is updated all the time but retrieved only on server start.
Deliveries are special, they are stored separately in a SQLite file so they are updated constantly. Deliveries can be given only by admins via the admin menu.
Example for their use: An unclaimed auction stays in the main database for a very long period and you want to get rid of it. You can delete it in two ways, by deleting the items & bids (so they will be lost forever) or by deleting the auction and sending the items & bids to their owners via a delivery.
If there are any errors that result in some players losing their items, you can get them back! In the logs file, when an auction is created, the item from that auction will be stored in base64 and it can be given to a player via a console command /ahadmin give <player> <base64 item>. The base64 item is a very long string with random characters and it will appear in logs like this: "[%time stamp%] (Advanced) Item in base64: %item%". If you have problems with getting the items, please contact me (my discord down below or just give me a message on spigot).
I tried to give the admins alot of control so, as you will notice, it is pretty rich in options.
The main admin command is /ahadmin and it will open the main admin menu but
you can also check the list of admin commands with /ahadmin help.
The permission to use admin commands and menus is auctionmaster.admin but it can be changed into the config.
Images with the Admin Menu:
This plugin is compatible with Citizens! You can create a NPC that will open the menu when clicked!
The created NPC is like a normal NPC, you can edit anything about it except it's name or it won't work anymore.
The currency of this plugin is also flexible! You can use normal Vault or you can use a Skript variabile as currency! For more info about the usage of Skript just check the comments in the currency.yml config.
The plugin also supports TokenManager and PlayerPoints.
This plugin has HeadDatabase Compatibility!
You can set the id of an item to 'skull: hdb- id' and the head with that id will be displayed!
If the id is not valid, the head will become a question mark.
You can asign heads with texture without HeadDatabase by simply using: 'skull: username' or 'skull: texture value'
The plugin also has PlaceholderAPI Compatibility!
You can use placeholders inside the menus (not everywhere but in most places).
The plugin currently offers only 2 placeholders:
%auctionmaster_own_auctions% » Number of auctions you have
%auctionmaster_own_bids% » Number of auctions you placed a bid on
If you want to use some info from the plugin inside your plugin
add the plugin into your external libraries
Spoiler: Example API Usage
Events :
- AuctionCreateEvent
- BINPurchaseEvent
- LostBidClaim
- PlaceBidEvent
- SellerClaimEndedAuctionEvent
- SellerClaimExpiredAuctionEvent
- TopBidClaim
Auction auction = AuctionMaster. API. getAuction ( String id )
auction. getId ( )
auction. getSellerName ( )
auction. getSellerDisplayName ( )
auction. getSellerUUID ( )
auction. getBids ( ). getTopBidUUID ( )
auction. getBids ( ). getTopBidCoins ( )
auction. getBids ( ). getBidList ( )
auction. getCoins ( )
auction. isEnded ( )
auction. isBIN ( )
auction. getEndingDate ( )
auction. getItemStack ( )
auction. getUpdatedDisplay ( )
auction. forceEnd ( )
auction. getBidHistory ( )
AuctionMaster. API. getDeliveries ( String UUID )
AuctionMaster. API. setDeliveryCoins ( double coins )
AuctionMaster. API. setDeliveryItems (ArrayList <ItemStack > items )
AuctionMaster. API. removeDeliveries ( String UUID )
Category category = AuctionMaster. API. getCategory ( String categoryName )
category. getAuctions (Player p ) //returns auctions ordered by the player's select sort
category. getDisplay ( )
category. getBackgroundGlass ( )
category. getDisplayCategoryItemSelected ( )
AuctionMaster. API. getOwnAuctions ( String UUID )
AuctionMaster. API. getBiddedAuctions ( String UUID )
Code (Java):
Events :
- AuctionCreateEvent
- BINPurchaseEvent
- LostBidClaim
- PlaceBidEvent
- SellerClaimEndedAuctionEvent
- SellerClaimExpiredAuctionEvent
- TopBidClaim
Auction auction = AuctionMaster. API. getAuction ( String id )
auction. getId ( )
auction. getSellerName ( )
auction. getSellerDisplayName ( )
auction. getSellerUUID ( )
auction. getBids ( ). getTopBidUUID ( )
auction. getBids ( ). getTopBidCoins ( )
auction. getBids ( ). getBidList ( )
auction. getCoins ( )
auction. isEnded ( )
auction. isBIN ( )
auction. getEndingDate ( )
auction. getItemStack ( )
auction. getUpdatedDisplay ( )
auction. forceEnd ( )
auction. getBidHistory ( )
AuctionMaster. API. getDeliveries ( String UUID )
AuctionMaster. API. setDeliveryCoins ( double coins )
AuctionMaster. API. setDeliveryItems (ArrayList <ItemStack > items )
AuctionMaster. API. removeDeliveries ( String UUID )
Category category = AuctionMaster. API. getCategory ( String categoryName )
category. getAuctions (Player p ) //returns auctions ordered by the player's select sort
category. getDisplay ( )
category. getBackgroundGlass ( )
category. getDisplayCategoryItemSelected ( )
AuctionMaster. API. getOwnAuctions ( String UUID )
AuctionMaster. API. getBiddedAuctions ( String UUID )
If you want to display auctions outside the menu use this addon:
AuctionMasterItemDisplay
Preview of the addon:
Check out my premium plugin, maybe it might interest you!
I don't think I covered everything the plugin contains in the upper text but I can't think of what I missed. For me, as the author of the plugin, everything seems natural and I don't know on what I should insist with explications.
If you have a problem with the plugin, any kind of problem, please contact me!
My discord is qKing12#1918
Or just join my discord
I usually respond faster on discord but you can dm me on spigot too!
If you are interested in some translations for the plugin, there are some in my discord server!
I want to say this is the second plugin I ever make, it was quite challenging. When I started this I didn't even know how to make a chest open
.
If you want to support me and my work I would really apreciate if you would buy me a coffee <3
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — see the MC Java Mods guides for the full walkthrough.
AuctionMaster [REDIRECT LINK] is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 52,229 times (via Spigot). Download it and open it directly in the game.