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.
Doesn't work in 1.4.4 dev
Does this work?
for 1.4
Can you dd a config option to keep bidders and auction announcements with a bidders name anonymous? This would still show the winner at the end. What im trying to do is prevent bidding wars and arguments when other users outbid each other, etc.
Running a bank auction from console results in no auction messages showing up, or so i believe.
I'm using herochat. There is also an issue where you dont see auction messages when you are not focused on the channel.
Could not pass event AuctionStartEvent to CraftBay
Can you add single permission for like craftbay.auction.end ?
There should be an option to announce a new auction to a different channel. So I can set CraftBay to a Trade channel but I want players to be notified so they can actually join that channel when a auction they like is going on. I know the ignore command is there but it does not do what I want because you need to re-enable listening to commands
Thanks
I've encountered some possible 'bugs' in your plugin. Posted them on your github for the sake of convenience. https://github.com/StarTux/CraftBay/issues I hope the information I provided was useful.
@dotapurex1
Actually, it is possible for normal players to cancel their own auctions, but only as long as there haven't been any bids on it. This is to avoid auctioneers cancelling in the last second when the development of the price didn't meet their expectations or when they are simply trying to troll people.
You should add a permisson so that, your able to cancel your own auction when you accidently auctioned up an item, but you can't cancel another players auction.
/auc end, doesn't really work well, if players have bidded for the item, but you just want the item back, because it was mistakenly placed up.
@dotapurex1
I mean it has never been there. Since the first release, I have paid special attention to keeping the original data value (which represents the damage in case of gear), enchantments and proper stack sizes. We have been using the plugin on our server ever since and this has never occured once, hence my confusion.
The rare loss of items however is something I have addressed with this release and it should be fixed now.
@StarTuxDev
You mean you fixed this repair gear thing on this update?
@dotapurex1
Can you provide steps to reproduce any of this? I especially doubt the repairing of gear since this is one thing I have taken extra care of right from the start.
StarTuxDev, You need to fix 2 known bugs. Sometimes players won't receive their items they've won or the items back when nobody won the auction.
Also, when you auction up a piece of equipment that has used durabillity, it will fully repair it when nobody wins the bid and if they win it.
@Taeila_Fae
Multiworld permissions using permissionsex is the best way to do that.
The new update attempts to fix a rare bug where players were not recognized so items could get lost. It seems to work on our server, but like I said, it was rare and hard to reproduce.
Another fix is that written books (or signed books) can now be auctioned and will keep their content, which was not possible due to a bug, which was my bad. This will not work however across server restarts since Bukkit cannot serialize books properly at the moment. It is just a matter of time, though.
@cuddyier
Does not exist yet but good idea. Considering it.
@Techno96
That is intentional to keep the initial spam to a minimum. Players have the chance to get more information when they just type /auc where a listing of all the enchantments is shown. If you wanted to change it; the output can be configured by making your custom language file as described here.