Frequently Asked Questions

While not technically ever asked, many people seem to need to know this information. I'm sorry to mislead you with this title.

Q: Why did you delete my comment?

A: Because you didn't read the FAQ.

Q: How do I report a bug or issue?

A: If you are a player on a server who does not have access to the server log file or the console history (which are typically the same thing), report the issue to a player on the server who does and have that person contact me.

I generally need these things in order to troubleshoot an issue:

• The specific version of floAuction. Do not send me "latest version," "most recent build" or the like because that generally could refer to up to 5 different actual version numbers, each with different source code, and sometimes even more.
• The specific build number of craftbukkit running on your server. I do not officially support anything but "recommended" level builds of Bukkit, I do not officially support any build of Spigot or MCPC+. However, if I look at the error (see next item on the list) and think it is irrelevant of your build, I will probably address it.
• The error on your console/server log. There are two places you must look. First, you need to check your log at the time the issue occurs. Second, you must check the point in the log where your server loads floAuction. If, and only if, you have checked these and there are no errors, you can include, "there are no console errors when loading floAuction or when the bug happens," or a paraphrase of that would be acceptable.
• If the issue is an interaction with any other plugin, include the version of that plugin.

Once you have all this information, review the tickets, recent comments and version history to make sure it hasn't been reported or fixed. If I've reported it fixed in a more recent update, make sure you're updated before reporting it broken. If it's been reported already, feel free to comment or reply to that report with any additional information you can add which will help me track down the issue. But in all cases, make sure you have the information in the list above.

Then, send it to me along with a description of the issue: post a comment on floAuction's main page, submit a ticket in floAuction's ticket system, or send me a private message here on Bukkit. If you know me personally, you can contact me any way you normally would, e.g. email, phone, in-game. If you are not a regular player on a server and you see me on that server, I will redirect you to this site. It's just too much to track otherwise. I do not review twitter messages frequently, so don't send bug reports there even if you do know me.

Q: Why aren't there any questions here that have actually been asked?

A: While I can't specifically verify this, I presume that it's because I've spent a ton of time on the description and configuration page. Most people seem to be able to navigate these pages and get their answers without asking me. Okay, okay, I'll put some questions that have actually been asked.

Q: How do I [toggle/configure/suggest] [some feature]?

A: Most of the features of floAuction are togglable or configurable. Refer to the configuration page (version 2.x, version 3.x) for details on all the configuration options and language options and the main list of features to see if it's been implemented or suggested already. If you still have any questions, comment on the main page. You could PM me, and I'll answer you, but many times, other visitors more familiar with the plugin can answer before I check the site if you post it publicly.

Q: floAuction doesn't do anything!

A: Obviously this isn't a question, but people seem to want a response. If you follow the procedure to report a bug at the top correctly, you will probably notice that you are missing a dependency. If so, remember that I've listed very clearly on the front page that Vault and WhatIsIt are required. Download them, install them and then restart your server.

Q: Why is floAuction rounding things to 10's?

A: You should change to a currency plugin which doesn't lie about rounding. floAuction rounds based on Vault's getting of the fractional digits count. The actual text in Vault's API reads as follows:

"Some economy plugins round off after a certain number of digits. This function returns the number of digits the plugin keeps or -1 if no rounding occurs."

The reality of the matter is that all economy plugins either explicitly round off after a certain number of digits or are doomed to suffer the consequence of Java's infamously terrible rounding of double's which results in absurdities like 1 + 1 = 1.999999999999999987 or 2.0000000000000000014 and the like.

When floAuction 2 was created, one of the issues it resolved (over it's predecessor which was an iAuction fork) was this shitty Java double rounding by converting the number to a long integer. It seems only relatively recently that at least one economy has decided to start lying about rounding.

My options in the issue are these:

1. Ignore the problem and let the economies be responsible for telling the truth about its rounding. (I mean seriously, if you have a currency that's telling you that you have $1000.000000000000000003432, you've got an issue beyond floAuction, and if it's relying on java's implicit double rounding, that's the type of thing what you'd be seeing).

2. Interpret -1 as 0, and always round to zero decimal places. But that's not what -1 is supposed to mean.

3. Interpret -1 as some other arbitrary rounding. But that's also not what -1 means.

4. I could revert all floAuction's math back to version 1's use of double and return the rounding issues to everyone...no, this isn't really an option.

5. I could convert floAuction to use an absurdly precise and complicated structure, like a BigDecimal...but what would be the point since it's going to be converted back to a double and you're going to have to get used to the rounding issues of other plugins anyways.

At this time, the only viable option for me to take is to ignore the problem.

Q: What happened to being able to show the full auction info when the auction is initially announced?

A:Oh, you want to make it show all the info right from the auction beginning? I think that's what you're asking. The specific part of the config doc you're looking for is, "%C8/%N8 - If the message is being broadcast to the server or auction scope. False if the message is being sent to a specific player." What you want to do is remove everything between consecutive %C8's (or between the last one end of the line if there's an odd number) and remove all the %N8's, on and remove all the %C8's. You know what, it'll just be easier if I do it.

auction-info:
- '&b%A1&9 is auctioning &f%A3 %CB&4damaged %CB%C4&benchanted %C4&a%L1&9%C5 named &f"%L2"&9%C5 for &c%A7&9.'
- '%CB&lItem damaged: &6%L6 &aremaining.'
- '%CEEnchantments: &a%L7'
- '%C9Book is titled: &a%L5'
- '%C0Book signed by: &a%L4'
- '%CCFirework Flight Duration: &a%L3'
- '%CCFirework payload: &a%R2'
- '%CDBuy now for &c%A6 &9with &a/bid buy&9.'
- '%N6%C7The current bid is &6%B3&9 by &b%B1&9.'
- '%N6%N7Bidding starts at &6%A4&9.'
- '%C6Bidding starts at &6%A4&9.'
- '%N6Min bid increment is &6%A5&9.'
- '%CA--&1LORE&9--------------------'
- '%CA|  &5&o%R3'
- '%CA--------------------&1LORE&9--'
- '%C6&fThis is a SEALED auction, bids are hidden from other players.'

Note: I was never asked this question directly, the question is a paraphrase that encompasses the meaning of other statements and questions asked to me.

Q: How do I unsuspend a player from auctions?

A: You can use "/auc suspend" to suspend all auctions. Use "/auc resume" to unsuspend them. Adding a playername makes these specific to a single player. So "/auc suspend flobi" would make is so the player named flobi cannot auction. Using "/auc resume flobi" would allow that player to auction again.