configuring-flo-auction-version-3/config.yml Options
Configuring floAuction version 3
config.yml Configuration Options
use-old-bid-logic: false
In floAuction 1, the logic applied when two users are competing with hidden maximum bids was a simple who has the highest hidden max bid, with preference for the first bidder in a tie.
In floAuction 2, a logic was created which simulates mathematically a series of minimum bids by each player until no more bids can be made (no loops were used, so don't worry about this possibly lagging your system). This removes any preference for who bid first, but can result in a bid lower than the looser's maximum. Even though it's more impartial, I anticipated that there might be those who prefer the simpler logic above. Set this option to true to use the floAuction 1 logic.
floAuction 3 uses the same logic as floAuction 2 by default, but still includes the ability to revert to floAuction 1's logic.
allow-bid-on-own-auction: false
This is primarily a debug option since I often don't have anyone to help me test this. Feel free to leave it as false. It may confuse your users to turn this on because they will be able to bid on their own auctions.
log-auctions: false
If true, it logs all the output of the floAuction to /plugins/floAuction/auctions.log.
default-starting-bid: 0
Many of the parameters in the start auction command are optional. This option sets what the starting bid will be if omitted when starting an auction.
max-starting-bid: 10000
This sets the maximum starting bid a user can assign any auction. Set to 0 for "no limit." It will technically limit them to 999,999,999,999.99999 or somewhere around there.
default-bid-increment: 1
Many of the parameters in the start auction command are optional. This option sets what the minimum bid increment will be if omitted when starting an auction.
min-bid-increment: 1
This is the minimum that a player can make the bid increment. This should be adjusted based on the value of your base currency unit. Having the value too slow can make for meaningless auctions being started. Having it too high may cause a loss in competition.
max-bid-increment: 100
This is the maximum that a player can make the bid increment. This should be adjusted based on the value of your base currency unit for the same reasons as the previous option.
default-auction-time: 60
Many of the parameters in the start auction command are optional. This option sets what the auction length (in seconds) will be if omitted when starting an auction.
min-auction-time: 15
You can adjust how short (in seconds) a user can make an auction. This can be adjusted based on the mood of the server. I've set it where I feel optimal by default, but in your server environment it may make sense to change it.
max-auction-time: 120
You can adjust how long (in seconds) a user can make an auction. This can be adjusted based on the mood of the server. I've set it where I feel optimal by default, but in your server environment it may make sense to change it.
allow-max-bids: true
Max bids allow players to specify a hidden amount that their bid will automatically increase to in order to outbid other players. It's similar to the eBay feature. This toggle, presented in version 2.3, allows you to disable this feature.
allow-early-end: false
Having much experience with auctioning, I've found that if players are allowed to end auctions early, they will often end when a specific player is the current high bidder, effectively using this plugin as a long-distance item transfer mechanism, clogging the chatways with moving their inventory or giving things to their friends. If you prefer to let your users use it this way, you can set this option to true.
allow-gamemode-creative: false
It makes no sense to auction while in creative unless you're testing, like I do frequently obviously. I don't know why you would want to, but set this option to true if you do.
allow-damaged-items: false
Before the auction software reported the amount of damage on an item, auctioning damaged goods would have been considered false advertising by the bidders (or worst case, source of a free item repair bug). The amount of damage will be displayed promently in the auction now, so feel free to turn this on if you like. I have no preference myself, so the default is just what I set it to when I first tested it.
allow-gamemode-change: false
Gamemode change while auctioning or high bidder was prevented in 2.4.1 because of multi-inventory concerns. It was made togglable with this option in 2.4.2.
max-auction-queue-length: 2
In version 2.2, the ability to queue auctions has been added. This sets how long that queue is. This number does not include the currently running auction. Setting this to 0 will effectively disable the ability for auctions to queue, with the exception below.
min-auction-interval-secs: 10
You can (since 2.2) specify that the auction plugin wait between auctions before starting another auction. If no auction is running, but the timeout has not been reached, the next auction will queue even if the queue length is 0.
auction-start-tax: 0
This is the amount deducted and required of the auction starter. Call it a fee, a tax, whatever. Set it to 0 to disable, otherwise set it to the amount that you want to charge for starting auctions. Added in 2.3.0.
auction-end-tax-percent: 0
This is the amount deducted from the winnings at the end of the bid. Again, call it what you will, a tax, a fee, etc. It is a percentage, so if you set it to 100, all of the winnings will be confiscated. If you set it to 10, one tenth of the winnings will be deducted from what is given to the auction starter. Added in 2.3.0.
deposit-tax-to-user: ''
Defaulting to empty, this will attempt to deposit any taxes from the previous two options into the specified user's economy account. Added in 2.4.0.
cancel-prevention-seconds: 15
Disallow cancellation within a certain number of seconds to the end of the auction.
cancel-prevention-percent: 50
Disallow cancellation within the last portion of the auction by percent.
anti-snipe: false
Anti-snipe extends the auction if someone bids within a certain nearness to the end of the auction.
anti-snipe-prevention-seconds: 15
This is how near to the end of the auction it has to be for the bid to trigger an extension.
anti-snipe-extension-seconds: 10
This is how many seconds will be added to the auction if anti-snipe is triggered.
allow-sealed-auctions: true
A new feature in 2.6.0 is sealed auctions. An actual bid is required, no auto-bidding. Max-bids are disabled. And no one can see what anyone else bids.
allow-unsealed-auctions: true
This is the normal pre-2.6.0 auction. If you disable this, all auctions will be sealed (see above). If you disable both, this will automatically reenable in any 2.x version, but will disable all auctions in 3.x.
broadcast-bid-updates: true
If you disable this, people will not be notified of bid updates unless they are bidding or are the previous highest bidder. This does not affect sealed bids which have bid update announcements already suppressed. (v.2.6.0+) NOTE: In 2.6.0, this was misspelled as "broadcast-bid-udpates" it was fixed in 2.6.1.
allow-auto-bid: true
Normally, the [bid amount] for the /bid command is optional and will allow a player to type "/bid" by itself and automatically up the bid by the minimum necessary. In 2.6.0, this was made togglable at the server level via config.yml. Personally, I wouldn't make this false, but it was extremely easy to do because of the new code needed for sealed auctions and you know how I like giving options for you guys.
suppress-countdown: false
Set this to true to suppress the countdown timer announcement broadcast. Added in 2.6.0.
allow-inferior-item-name-logic: false
Due to numerous complaints, ironically mostly from another auction plugin, I have added in 2.7.0 the option to use the quite inferior item name processing used by most other auction plugins. If this is enabled, WhatIsIt, a plugin which provides more accurate and descriptive names (and is also fully language compatible), is not required. However, it is highly recommended to use the superior naming logic provided by WhatIsIt for the sake of customizability, accuracy and fraud prevention.
banned-items: - 7 - 383;63
Beginning with version 2.3, you can ban items from being auctioned. Add the item id of any item you want to ban. If you want a specific data or damage value, append it with a ";". The default items are bedrock (7) and the Enderdragon spawn egg (383;63).
taxed-items: '0': 100%
The "taxed-items" was added by request in 2.8.7. It will override either the pre-auction tax or post-auction tax. Specify (where '0' is) the item id, and you can use a ; to add a data or damage value just like in "banned-items" above. It you put the value as a number, it will apply that to the item type times the quantity. You can add an "a" to the end (where the "%" is in the default) to tell floAuction to not multiply the amount by the quantity auctioned. If you end it with a "%" it will apply it as the end percent tax. These do not add to the other taxes, but replace them. However, if the end tax is specified any default starting tax will still apply and vice versa.
There is an anomaly because you can't keep a config group with no entries. This is why item '0' will always repopulate. That is air, which people cannot auction anyways, so you can just ignore the value.
allow-renamed-items: true
This option allows the auctioning of items renamed with an anvil. It was added in 2.8.8.
disabled-commands-participating: - '/ma join' - '/mobarena join' - '/arena join'
In order to eliminate the incompatibility between floAuction queuing auctions and MobArena trapping players who join an arena and giving them items, I have added the ability to disable certain commands to anyone currently participating in an auction, including those with queued auctions. The default value here provides this protection, but you can add any command suppression you like to this list. This update applies to floAuction v2.8.9 and above. This is the same option that was named "disabled-commands" in version 2, it was renamed in 3.0.0.
disabled-commands-inscope: {}
This command functions the same as "disabled-commands-participating" except disables the commands the entire time the player is in a specific auction scope.
banned-lore: - mcMMO Ability Tool
McMMO increases a tools enchantments to facilitate superbreaker and other bonus skills. Any item auctioned in such a state will display as if it had the additional enchantment, but McMMO will remove the bonus after it reaches the other player. To stop the confusion, I've added a lore filter, setting the default to protect against this McMMO activity. This parameter is available in floAuction 2.9.0 and above.
max-buynow: 10000 expire-buynow-at-first-bid: false allow-buynow: true
The BuyNow option gives players the ability to have bidders quickly end the auction if they're willing to pay a price preset by the auctioner. "max-buynow" is the highest price a player can set the BuyNow. If "expire-buynow-at-first-bid" is true, the option to buy will go away after someone makes any bid on the auction. "allow-buynow" is a toggle to turn the whole feature off.
Comments