Auction off your precious items! CraftBay is an auctioning system that allows players to trade their items by bidding for them. After a set amount of time, the highest bid wins. Payment is handled via Vault.
Links
- GitHub page (Source code)
- SpigotMC resource page (1.13+ downloads)
- BukkitDev plugin page (Current and legacy downloads)
- Configuration file (yaml)
- Language file (yaml)
Intended use
Despite the wide availability of shopping plugins, an auction is still the best way for auctioneers to achieve the maximum price for their goods by reaching a broad audience and having them duke it out. Experience shows that especially rare items such as enchanted tools and armor can make for a very intense and exciting fight for the highest bid. The winning bid may even exceed the price for the same item available in shops.
Features
- Players can auction off items from their inventory
- Bid for items with your in-game currency
- World blacklist
- Live notifications about auction activity (players can mute it)
- Spam protection: Suppress messages when people spam bids
- Fully customizable messages
- Admin commands to moderate auction activity
- Auction history for in-game review
- Auctions survive server restarts
- Informative display of item properties (damage, enchantments, etc)
- Auctions will survive a server restart.
- A cancelled auction or one that ends without any bids will return the item to the owner.
- If items are handed over to a player with a full inventory, they will be dropped where they are standing.
Commands
Auctions are managed with simple commands with an interactive on-line help.
/auction
This command will always direct you to an overview of your current options./auc
An alias for /auction that works with all of the below/auc ?
Get help/auc info
Display information about the current auction/auc preview
Preview the auctioned item in a chest interface/auc history [id]
Review past or queued future auctions/auc bid [amount]
Place a bid/bid [amount]
Shortcut for /auction bid/auc start [starting price]
Auction off an item/auc hand [starting price]
Auction off the item in your hand/auc end [delay]
End the current auction/auc cancel [id]
Cancel an auction/auc ignore
Ignore broadcasts/auc listen
Receive broadcasts
Admin Commands
Admins have additional commands to get more information than normal users, moderate the market activity, auction off spawned items or stimulate the economy by bidding for items on behalf of the bank.
/auc bank <item> <amount> [starting price]
Auction off a spawned item/auc fake <name> [starting price]
Auction off a fake item/auc bankhand
Auction off item in hand on behalf of the bank/auc bankbid [amount]
Place a bid on behalf of the bank/auc log [id]
Display the log of an auction/auc reload
Reload the configuration file
Permissions
The defaults are set up so anyone can query auction information and place bids. Permission to start auctions, however, is not granted by default. Administrative actions default to op.
auction.info
Query information about the current auctionauction.bid
Place bids for auctions. Implies auction.receiveauction.start
Start your own auctionauction.admin
Perform administrative commandsauction.receive
Receive items you won (since v1.2.1)auction.nofee
Player is exempted from the auction feeauction.notax
Player is exempted from the auction tax
How it works
Every player with the appropriate permission can start an auction for any amount of items in their inventory. To do so, they can simply type /auc hand to sell whatever they are holding in their hand, or /auc start to be presented with a chest interface to put their items in. If everything is alright, the auction will be publicly announced and the plugin will claim the item and start accepting bids.
Placing a bid means declaring the maximum amount you are willing to pay for the item. After the auction times out, the participant with the highest bid wins, but all he has to pay is just enough to beat the second highest bid. This is how many online auction houses function.
The result of this system is that sniping, that is overbidding by a small amount in the last second, becomes very difficult. Also players don't have to worry about placing an unnecessarily high bid when nobody else is interested in paying nearly as much. They can just declare the maximum amount right away and be guaranteed to pay up to that but no more, and only as much as is necessary to win. Also, nobody else will know about it unless they bid even more.
Language
All in-game chat output is configurable and CraftBay comes with several language files: English (en_US), German (de_DE), Simplified Chinese (zh_CN), and Russian (ru_RU). The preferred language can be chosen in the configuration file and adjusted via configuration files.
@dunem666
If nothing else you made me stumble over a major issue with Spout. Servers using Spout should update CraftBay to version 1.1.1 as soon as possible.
For this update, I took your suggestions (and propably some others I forgot) into account.
@Lukethenuke There is now a reload command.
@deleted_7840180 User output is now customizable
@KingShibby There is now a configurable flat fee and also a tax which takes the starting bid into account.
@deleted_7840180 People cannot start auctions while in creative mode. It can be reenabled in the config, though.
@dunem666
Haha. Considering it ;-)
@Torleik_
Sure, that makes a lot of sense. A configurable output is the major change of 1.1, but what you suggest is not quite there yet. Give me some time to figure out a good way of implementing it. ;)
how about a gui for spout? :p
Hey, I was just curious if you would be willing to add chat presentation customizability into the config.
I am currently going to try to learn how to edit class files so that I can change the start of a bid to only take up one line instead of 5, and also edit the colors used for the chat presentation.
If you could add changing those things into the config it would be amazing. If not, I guess I will try to learn how to edit class files lol.
@InanZen
Decimal values are currently not supported.
@FuRiouSOne
The items are taken from the auctioneer's inventory before the auction starts, so it doesn't matter what he does while it is running.
@Eric2190
@deleted_7840180
What hoppsan4 said. Your normal users will need auction.info, auction.bid and auction.start. And all commands default to op.
@deleted_7840180
Alright, I am convinced :) Will re-add the option to disable auctions in creative mode.
@KingShibby
@deleted_7840180
Yes, I am on board with this idea. Optional fees will be in the next update.
is it possible to start a bid at 0.1 (gold) AKA 10 silver, or any other decimal value?
also can i set the lowest bid increment to 0.01?
@Eric2190 Permissions nodes are:
auction.info
auction.bid
auction.start
auction.admin
Or it usually works to just OP yourself. Use a permissions manager like PEX (I recomend it imo) or GroupManager.
What happens if a player is to start and auction and then go out to pvp and die? Does the auction cancel? If items are dropped from death and the auction ends is the transaction canceled due to the items missing?
hi my name is eric and i really like this craftbay plugin its great but i need to know how you get appropriate admin permissions on your own home minecraft server so you can do /auc hand (amount) (price) because it just keeps saying to me [auction] You Don't Have Permission! please someone tell me how i can fix this it would be greatly appreciated thank you.
Big problem. Please make it so that in Creative mode you can't auction stuff. Thanks ;)
<<reply 701396="">>
Isn't there plugins who can take money for commands? I'm sure its just to slap on the /auc and it will work, but nice idea. support!
Would it be possible to implement something that charges users a set fee to start an auction, that way there's a disincentive to auction off worthless stuff?
@Arcental
The current system diminishes the effects of sniping, that is placing bids in the last second, by accepting maximum bids, keeping the actual bid amount a secret so your competitors cannot know how much they have to bid to beat you.
In my books, there exist two concepts for auctions:
Auctions that have a set time limit and whoever has the highest bid after the time runs out, wins. Secret bids are advised to avoid cheap sniping. This is the method that online auction houses like ebay employ, and so does this plugin.
The other way are auctions that run as long as people are interested. Whenever a bid is placed, the remaining auction duration is reset to a small amount and what you bid is what you end up paying, so there are not secret or maximum bids. This is how real-life auctions are usually handled.
CraftBay has the first type because I think it makes the most sense for minecraft items and is propably the least spammy choice. For the future, I intend to have the second kind as an option, but I think that the two should not be mixed but stay seperated.
Really good plugin! I do have 1 problem though.. its that people bid at the last second and wins. Can you put a option that if you bid at the last second it will add a few seconds?