AuctionMaster 是一款功能丰富的 Minecraft 拍卖行插件，允许玩家买卖物品。它提供了可定制的菜单、类别和多种拍卖选项，包括竞价和一口价，还支持 NPC 集成、货币选项和 API，方便其他插件集成。

🚀 AuctionMaster 插件文档

📜 插件描述

由于个人原因，原作者已停止维护此插件。不过，另一位开发者 SedatTR 将接手维护工作！

重定向链接：

• SpigotMc Link
• 新开发者 Discord 链接：https://discord.gg/9wjkj9fk9k

⚙️ 依赖

• ProtocolLib：用于支持告示牌交互，如果缺少，则会使用铁砧界面。
• Vault：用于处理货币。
• 用于处理经济的插件，例如 Essentials。

🛠️ 配置

几乎所有菜单项都可以自定义，包括管理菜单。配置文件中有详细的注释说明，并包含占位符。

config.yml

#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  &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

currency.yml

#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%} would be balance.%player%
skript-variable: 'balance::%player%'

bids_related.yml

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

auctions_manager.yml

#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 %b