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.
@StarTuxDev
Having an issue where en_us.yml resets itself on server restart, causing the customised messages to revert to default
Kind of annoying having to keep changing these messages every few days on restart
I Know the problem everybody! The author has to update their JDK version for java. The people having problems are the people with a higher version of Java than the JDK so if you haven't updated Java recently, it most likely will work for you. Please fix this though StarTuxDev. I love this plugin but can't use it because of my Java version.
This plugin works 100% correctly for me, as far as i can tell and i use it extensively on both of my servers. I couldn't live without this plugin. ;) Running the latest builds of Spigot & always on the latest builds.
@StarTuxDev
Im having the same problem!
@Brynny
Put CraftBay.jar in the plugins folder and (re)start the CraftBukkit server. If that doesn't work, either the server or the plugin might be outdated. The console output should give a clue as of what is wrong. :)
Hi sorry, I really love the idea of this plugin and I can't wait to use it. However When I downloaded it and put it into my plugins it didnt create a config folder and it doesnt recognize the plugin.. How do I fix this please??
@HammerCraftMC
CraftBay doesn't do any dark magic when it comes to permissions; they are either specified in the plugin configuration or checked by means of the API, like any other plugin out there. It must be some issue with the permission setup. Or maybe the players' world is listed in the blacklistworlds array in the config.yml?
@mobilephone2003
Thanks for the heads-up. I cannot account for this; obviously we don't have any of these issues on our server. It is hard to comment on this without any server logs, however. But whatever is visible on console will end up in the server.log file. As a last resort, deleting the auctions.yml file in your plugins/CraftBay folder could resolve this issue. Besides deleting it, should that help, giving me a copy of it via PM would be very much appreciated, so I can maybe reproduce and fix the problem. ;-)
@StarTuxDev
Hey,
Craftbukkit has worked amazingly up until recently.
Now, even if a user has the correct permissions, they cannot do what they are supposed to be able to do. The only way to fix it is to Op them. Even '*' won't work. Any yes, I am sure that the users have to correct permissions. Trust me, i've tried.
Thanks, - The HammerCraft Team
@StarTuxDev
Thanks bud.
The auction system has been working fine for the past few weeks up until now, where it froze on auction end and had been throwing up "PlayerJoinEvent" errors and "PlayerTeleportEvent" errors, dynamic unload/load and /auc reload made no difference
For some reason they didn't log in the server log so I can't grab you the error, but just a heads up
Sweet =)
@mobilephone2003 @InvisiCraftOfficial
Disregard my previous answers to your suggestions. I added item durability and more default chat settings. Whenever an item does not have full durability it will be displayed as a percentage along with the other item information, such as enchantments. New people won't automatically listen to the auction broadcast if the defaultchat.autojoin configuration node is set to "false".
@mobilephone2003
You have to create a new language file because the default ones will be reset on every restart. The process is explained here. The new file may contain only the fields you want to be changed. Everything missing will be taken from the default.
@StarTuxDev
I attempted to change the "en_us" language file previously but it got reset on server restart. Do I need to do a command in game to "load-in" the language file?
@mobilephone2003
The item damage value is displayed along with the id on the auction info screen. The corresponding variable in the language file is called {itemdamage}. The basic idea is that people can get all the information they need on the info page, but the announcements give them a general idea what the item is. So it just says "damaged" if the durability is not at 100%, hopefully encouraging them to look closer. Generally I would discourage the sale of damaged items and there might be an option for that in the future.
@InvisiCraftOfficial
I will consider adding that option, but don't think most admins mind having their new players reminded of the availability of auctions. What you can do for now, is not giving new people the auction.bid permission in which case they won't receive notifications. Also you can edit the configuration file and edit the spaminterval and reminderinterval to higher values. And of course there is the option to use one of the supported chat plugins that come with their own advanced settings for membership in a channel.
Could you PLEASE make it so that when you first join you are not being spammed by auctions? Make it so people have to type /auc listen before they can even hear the feed.
Thanks!
Working great so far, players are enjoying it, love the multi-world blacklisting, as thats a dealbreaker for us.
For damaged items, is there any chance a percentage damaged can be added to /auc?
If I wear an enchanted diamond sword right down to 5% and then sell it, players may think it will last longer when it says "Damaged Enchanted Sword" - Perhaps a durability field?
@NordicBlue
As you wish. The new release has two permission nodes for this purpose (see changelog). Very good idea; keep them coming. :)
This is absolutely the best auction plugin out there, Startux! Keep up the good work! :)
Edit: Btw i use this currently on both of my servers! :)
This plugin works great! And since the latest update the errors at startup have stopped too.
The players on our server enjoy it very much and there are no hours without an auction :)
A nice way to let players trade their items and to give new player the chance to buy items for a cheap price from other players!
I'd like to see a permission flag where I can allow a certain group to circumvent taxes and fees for getting an auction going, to give to my VIPs.
Thanks again! :)