floAuction
floAuction - In-game auction software
There are no supported versions of floAuction v3.0.x higher than 3.0.4.
floAuction provides a powerful chat based auction system with many options to help control "spam" and scams and many customizable features making it perfect for any server. Help support development of floAuction: Donate
Notable Features!
floAuction has too many customizable features to reasonably put on the main page here, but here's a list of notable ones.
- Full language customization, even (with the use of WhatIsIt) item names themselves.
- Auction house, silent auctions, sealed auctions, countdown suppression, individual opting-out of all auctioning, and many other "spam" limiting features!
- Reserves funds (i.e. removes them from the player account), ability to disable auctioning damaged and renamed items, full item details displayed, and other abuse and scam prevention features!
- Percent of winnings or price per auction taxes, limits on max's and min's of different auction aspects, banned items list and other economy protection features!
- And, finally ss of the release of floAuction version 3: Auction scopes. The ability to designate world grouping and create multiple auction houses, each with distinct language and config settings.
A list of main features, complete, in progress, planned and under consideration can be found here. Specific per-version history can be found here. And GitHub here.
Important Notes and Disclaimers
- Before commenting, read the FAQ!
- This plugin requires Vault and WhatIsIt, make sure they're installed if you want floAuction to work.
- floAuction uses PluginMetrics to create pretty graphs and charts on mcstats.org. All the data uploaded to their site is impersonal data, including version numbers of your server and floAuction, hardware capabilities, and ip info. If you are uncomfortable with this, go into your /plugins/PluginMetrics folder, change the "opt-out" value to "true" and restart your server.
- floAuction version 3 uses gravitylow's Updater functionality. You can disable it in floAuction's config.yml by setting "auto-update" to "false" or disable it for all plugins using that code in the /plugins/Updater/config.yml by setting "disabled" to "true". This Updater functionality contacts Bukkit's servers to determine if an update is available and installs it so.
- The GitHub for version 2 has moved to 2.x.x-archive as it is no longer under active development. The 2.x.x branch on GitHub is temporarily being used to develop version 3.
- A number of technical difficulties have corrupted floAuction versions 2.10.0 through 2.10.2, do not use these versions!
Videos
- https://www.youtube.com/watch?v=-yPU3c8eFM8 - Admin How-To for version 3
- https://www.youtube.com/watch?v=yKhZKwejao8 - Usage tutorial (v3)
- https://www.youtube.com/watch?v=XScxexjbTQs - A great installation tutorial for version 2, but version 3 is basically the same on all these points.
- http://www.youtube.com/watch?v=n7XOsLisdI0 - Me rambling on about version 2, and kinda just rambling
- http://www.youtube.com/watch?v=kgG4gSkUCJk - How to use floAuction (v2)
- http://www.youtube.com/watch?v=bsws7f4Rwh0 - floAuction Overview with some very distracting stuff going on (v2)
- http://www.youtube.com/watch?v=CpMrRnE1KNQ - A long, but good showcase video (v2)
Send me a message if you know of any videos I missed here and I'll see about getting them added.
Commands
- /auction - Main auction interface, use "/auction ?" in-game for more information, permissions vary per functionality. Requires permission "auction.bid":
- /auc - Shortcut for "/auction" (v2.6.0+)
- /sealedauction same syntax as "/auction" but forces sealed auction. (v2.6.0+)
- /sauc - Shortcut for "/sealedauction" (v2.6.0+)
- /bid [bid amount] [max bid] - Bidding, all parameters optional. If [bid amount] is omitted, bid automatically becomes the current bid + minimum bid increment. In sealed auctions, [bid amount] is required and [max bid] is ignored.
Permissions
- auction.start - Allows creation of auctions.
- auction.bid - Allows bidding on auctions.
- auction.admin - Allows administrative functions including cancelling current auctions, suspending player's auction capability, pausing and restarting auctions. (default: op)
Setup and Configuration
This plugin requires Vault and WhatIsIt.
Click here to view a detailed list of all config options for floAuction version 2 and how to use them. As of the release of floAuction 3, floAuction 2 will no longer be supported. floAuction 3 has all the features that version 2 has, plus more!
Click here to see detailed configuration and setup details for floAuction 3. It is multiple pages, but if you take the time to go through it, you will discover that floAuction is by far the most powerful auction plugin available for Minecraft.
Development Participation
I sometimes upload development or "alpha" versions of my plugin to a folder on my own website. If you would like to participate in helping me make sure these major changes have been well tested before I make an official release here on Bukkit, feel free to visit http://www.flobi.com/projects/floAuction/files/ and download the most recent version available on that site. Read the readme file there before participating. I recommend against using any of these files for any server where you need to guarantee up-time or functionality, but only on development or test servers. If you choose to use these against this recommendation, do so at your own risk (though technically it's your own risk in any case, lol, I'm not guaranteeing anything).
Misc
Sometimes I post development stuff here: https://twitter.com/flobiKenobi
I don't always play Minecraft, but when I do, I play on:
Drop by and pay us a visit!
IMPORTANT UPDATE! 2.4.1
Okay, I pushed this stuff up, just waiting for devbukkit approval:
@Gamerologist1
Note this text under completed features: Per user silencing of auctions: /auction [stfu|quiet|off|silent|silence]. (v 2.1+)
It's a good idea ;). I liked it when I came up with it and I still like it when you come up with it.
@Splazeing
I'm gonna have to have more info than that, Splazeing. I'm eager to fix anything that's borked, but bid permissions are working fine on mine so I don't know where to start looking for your problem.
Hey dude. You know what would be cool? If people can disable the chat floauction gives. Meaning if someone doesnt want to bid, He can type a command like /auction chat off To disable the spam caused by it. Hopefully you take my idea into the planned section =D
BUG BUG: The permission doesnt work on my server. People cant bid with the perm "auction.bid"
@Ra1n1337
2.3 Is up (once devbukkit approved) with your requested change.
BUG ALERT: Due to some system optimization programming, "/auction this" always only auctions 1, it's supposed to auction the stack size of what you're holding. I hadn't taken everything into account, apparently.
I'm fixing at the moment, 2.3.0 should be out within a few hours. (or up for devbukkit approval anyways) Being so close, not going to worry about a 2.2.1
@Ra1n1337
At the moment, it is looking like tomorrow. Just wanted to give a heads up in case you were ocd watching the page :).
EDIT: Yeah, got's to head to bed. Work tomorrow. I'm pretty close, but it's definitely going to be tomorrow or the next day. Probably tomorrow.
@sheepwool7
I know what you mean, I rewrote the previous post like twice. Feel free to say anything you like, but I suppose if you get too much off the topic of the plugin, I might ask to have the conversation moved to a forum somewhere, lol. I'm currently working on the 3 items in "In Development Features" hoping to get them done tonight. Could happen :).
Thanks for the clarification. (I was going to write something longer, but it sounded stupid :P)
@sheepwool7
Rereading what you originally posted about "Channel-grouping of auctions", it is a little more complicated than that. The goal is that there can be multiple scopes auctions can be run in, and multiple auctions will be able to be run simultaneously in different scopes. Those scopes are supposed to include channel confined auctions. This way, donators may be able to auction in a donator only chat channel, while someone else is auctioning in a PvE world auction and even another in a PvP world auction. I'm not entirely sure how this will work with what I recently learned about the limitations of economy plugins...but that's what the concept was supposed to be.
floAuction 1 was indeed a fork off of iAuction, so I'm familiar with rob4001's work on it and I respect what he has done. The reason for the initial fork was that rob's updates were often delayed and iAuction was not very customizable and the initiative to share with you guys is what spawned a complete rewrite (no iAuction code is in floAuction 2). Most of what iAuction is, is encompassed in my bullet point under completed, "Base auction functionality." The first two things I did beyond that are what have been on his todo list for quite some time. As you can see, floAuction has a lot more functionality and a lot more customizability. It seems I simply have more time than rob to do these things, and I can't fault him for that. I have every respect for him and iAuction, but for the sake of a little intellectual integrity, being that the two products are effectively competition, I'm not going to reference it when building this (even though both licenses say I can).
But I do appreciate your intentions as being helpful. I gave you this so you can understand a bit of the relationship between the two plugins and I'm not in any way irritated that you brought it up (if you might have thought that).
iAuction has this functionality. http://dev.bukkit.org/server-mods/iauction/ and he has the source code there as well https://github.com/Rob4001/iAuction
@sheepwool7
Yes. Unfortunately (why can't they all be finished and bug free now?!?!) that's my lowest priority of the things listed under "Planned", but you describe it accurately. At the moment, I don't have any experience with channel plugins so I'm going to rely on Vault's documentation heavily. I also haven't had anyone ask for that; I only put it on the list because floAuction 1 had it...or may have had it, it was a fork off something else and I never used that feature, but there was code for it that may or may not have worked, idk.
With the ability to toggle auction visibility on a per person basis now, I'm not sure this is really necessary.
I might sneak some http://metrics.griefcraft.com in 2.3 too...but that is off topic. I'll make a config to disable it if I do.
"Channel-grouping of auctions" means support of per-chat channel auctions right? Ex. I am in the Auction chat channel, and Bob is in the Global channel. I can see the Auctions in mine, but Bob can't.
That's terribly written but you might get the gist.
@Ra1n1337
Yeah, that's going to be in floAuction 2.3. I actually started on that code last night because finishing up GoldIsMoney plugin, I realized I don't want people to auction gold. Of course, it was planned to do this next anyways. Lots of reasons to not let people auction certain things, like TNT and bedrock.
You can expect that this week, not sure what day. I want to get those 2 things on the In Dev section done before I start on scopes. If it goes really really smoothly with the taxes and the banned item list (the latter being what you asked for), there's a possibly I'll have a file ready tonight. I'm figuring maybe a 50% likeliness of that. Otherwise, it will probably be tomorrow. Also depends on if people start finding a ton of bugs in GoldIsMoney which I'll have to fix first...might put a delay on things. But definitely this week. I still want to have the scopes (floAuction 2.4) ready before MC1.3 releases.
Could you make it so I can exempt certain items from being being bidded? Like I don't want people with higher kits then other people to auction their kits for money :/
@huntershenep
I apologize. It's just me working on the thing, and sometimes I miss stuff. The permission node is "auction.start" not "auction.create". I updated the page here.
@incredinex
Yes, I have Vault installed, but does this mean that my permission problem is your fault? I am really frustrated lol
Haha, found a bug in floAuction while writing another plugin (the not-yet-approved GoldIsMoney). I'll post a patch real quick, but when you install 2.2.0, it checks to see if there is an economy before it loads the economy...so it always defaults to the built in gold standard option.
You can get around this by updating the config.yml after starting and using "/auction reload" to reload the config.
@huntershenep
Do you have Vault installed?