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!
At first-run the plugin will give an error that the orphanLots.ser file doesn't exist. I had to make the plugin create that file by making an auction and logging off. Realistically this is a non-issue since the plugin functioned fine without that file, but I try to make sure that my server launches without any errors.
I'm still getting some errors related to the plugin interfacing with BOSEconomy. I'll be working on it today, and it's likely an issue with BOSEconomy itself, but if you have any advice I'd gladly take it. I recently had to switch to BOSEconomy because iConomy has been abandoned for such a long time.
12:06:46 [INFO] [floAuction] Enabling floAuction v2.4.4
12:06:46 [SEVERE] Error occurred while enabling floAuction v2.4.4 (Is it up to date?)
java.lang.NullPointerException
at net.milkbowl.vault.economy.plugins.Economy_BOSE7.currencyNamePlural(Economy_BOSE7.java:115)
at net.milkbowl.vault.economy.plugins.Economy_BOSE7.format(Economy_BOSE7.java:158)
at com.flobi.utility.functions.formatAmount(functions.java:18)
at com.flobi.floAuction.floAuction.sendMessage(floAuction.java:794)
at com.flobi.floAuction.floAuction.onEnable(floAuction.java:305)
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217)
at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:365)
at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:381)
at org.bukkit.craftbukkit.CraftServer.loadPlugin(CraftServer.java:265)
at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:247)
at net.minecraft.server.MinecraftServer.i(MinecraftServer.java:296)
at net.minecraft.server.MinecraftServer.d(MinecraftServer.java:275)
at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:225)
at net.minecraft.server.DedicatedServer.init(DedicatedServer.java:140)
at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:378)
at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)
@incredinex
Thank you :)
May I also ask how the plugin handles server reboots or crashes?
Every time my server reboots the current auction messes up and the buyer loses money and the seller doesn't get the money.
@ShakyTom
Okay, I can't see a reason that people cannot auction unsafe enchantments. But I'm not calling it a fix.
EDIT: http://www.hollowmatrix.com/files/floAuction-1.4.5-gBay.jar
@incredinex
I use SilkSpawners which stores the entity ID in both the durability and silk touch enchantment level.
It works fine for all shops and WhatIsIt.
@ShakyTom
If you've read my comments in GoldIsMoney, you would know I'm very picky about using the word "fix." It implies something is broken in my plugin, which isn't. Saying it's a fix implies to other users that something may have been wrong with the version they have installed.
Anyways, one piece of advice on storing a Metadatable implementation in a predefined abstract...don't. Especially if you're (as it seems) effectively storing just the main id (which seems to be out of the bounds Enchantment normally takes). Why not just store it in durability (a short) like all the other plugins out there which store it do?
Even if I made floAuction able to handle your unusual exception, then I'd have to go have WhatIsIt handle it too and you're going to have other problems with any other plugins that do anything related to reading Enchantments, like shop plugins.
And by the way, I was editing my last post maybe while you were writing yours, so go read it again in case you missed the "EDIT" section. (Nevermind, you replied to it as I was typing this one.)
EDIT: And by the way, if you store the mob's id in the durability, it should auction and display fine via WhatIsIt (untested, but probably true).
@incredinex
Thanks!
Any chance on fixing that error too? :D
I store the type of mob spawner by using the enchantment so hopefully you could fix this too :)
@ShakyTom
Will look into it. ....
EDIT: Okay, I looked into it and apparently registering dynamic commands is actually a huge hassle involving overriding basic security features built into bukkit (or something like that anyways), but I compiled you your very own floAuction 1.4.4 alt with gBay command and prefix.
Enjoy: http://www.hollowmatrix.com/files/floAuction-1.4.4-gBay.jar
Just discovered this plugin, looks exactly what my users are looking for.
(Total donated to date: 0 USD) <- Should probably update that :)
PS, can we get alias'? I want to use /gbay instead of /auction
@MechaTech84
I just had Rob (from iAuction) look into it and he said that bukkit hasn't implemented access to the book contents quite yet, so just don't auction them, or expect their contents to get wiped.
@MechaTech84
That's very good information!
Auctioning written books is not working, when you auction a book it wipes all the words from it as well as the title. Tested on AerialHeights.
@Illysp
Yeah, the only thing you need to do for 1.3 is to update WhatIsIt. And actually, WhatIsIt doesn't even need to be updated if you want to manually add the new items into the names.yml. On the other hand, the most recent copy of WhatIsIt has a much better potion identification routine, so it's worth it to update anyways.
Seems to work fine for 1.3.1 RB 1. I tried out a few of the new items and they seem to work just fine.
@Camtaro
It already has that, friend.
While it's off the user can't interact with the auction until they type /auction on
Hey flobi. Is there a way you can /make it so you don't see messages from the auction plugin?
That way people can choose wither or not to see the messages?
Thanks for the work on the great plugin!
@incredinex
Alright, that's a pretty nice way to solve it.
@PyrostasisTDK
We have a similar situation on the Aerial Heights. At the moment, we've just disabled auction in PvP, but I am working on a solution. It's just taking a bit to flesh out.
@sheepwool7
What I'm doing to make world specific will greatly speed up chat specific ones.
@Both: Basically the concept I'm working on is to make "scopes" for auctions. The first scope definition will be worlds. This will make it so that a person can only be in one "scope" at a time. Those scopes will be defined in the config file as a group of worlds, or (later) chat channel, possibly even defined regions like an auction house or something.
@PyrostasisTDK
I think once we have the chat specific ones, that will in turn make it world specific, because you can say if you want it global or not.
I think less is more in this case, although I may be wrong.
Any chance we could setup something so auctions are world specific?
We have 2 worlds (one towny, one pvp) and our inventories are separate. We wanted auctions on both worlds, but they are now simply using the auction system to trade... and a bit counter productive to our idea =(