FAQ
Questions that come up before something has actually gone wrong.
Can two servers share one auction house?
No. Even with MySQL, ZyAuctions keeps active listings in memory and treats that as the truth. Two servers on one database would not see each other's sales and could sell the same item twice.
MySQL is supported so your auction data can live in your existing database for backups and external tooling — not to share an auction house across a network.
What happens to listings when the server crashes?
Nothing is lost. Every listing and every collection bin entry is written to storage as it changes, and read back on the next start:
[ZyAuctions] Loaded 214 active listing(s) and 37 collection bin entr(ies).A listing that should have expired while the server was down is settled within a few seconds of it coming back up.
What happens to a bid when the auction is cancelled by an admin?
The bidder gets every penny back and is told why. The item goes to its seller's collection bin. Nobody loses anything.
Do sellers get paid if they are offline?
Yes. Money goes through your economy plugin, which handles offline players. They see the message the next time they log in only if they are online when it sells — but the money is already there either way.
What happens if a player's inventory is full when they buy something?
It goes to their collection bin and the message says so. They claim it with /ah collect
when they have room.
Can players sell shulker boxes with items inside?
Yes, and the contents come through intact — items are stored the way Minecraft stores them,
so enchantments, custom names, written books, banner patterns and container contents all
survive. Add SHULKER_BOX and its coloured variants to listings.blacklist if you would
rather they could not.
Why did my listing fee not come back when the item did not sell?
That is what a listing fee is. It is charged when the listing is created, to make listing
spam cost something. Set listings.fee.flat and listings.fee.percent to 0 if you do not
want one.
Can I see who bought what?
Not in 1.0.0 — there is no sale history. Sellers are told at the time, and the money is in
your economy plugin's records. If you need an audit trail, a small companion plugin
listening to ListingSoldEvent is about fifteen lines; see the
developer docs.
Does it work with Folia?
No. folia-supported is false in the manifest, so Folia will refuse to load it rather
than run it unsafely.
Does it support PlaceholderAPI?
Not in 1.0.0.
How many listings can it handle?
The browser is paginated at 45 per page and filtering is done in memory over an index, so several thousand active listings is unremarkable. The practical limit is player patience long before it is performance.
Can I stop players selling to themselves with an alt?
Not directly — nothing here can tell two accounts apart. The listing fee and sales tax are the usual answer: round-tripping an item through the auction house at a 2% fee and 5% tax is a losing trade, which is most of the point of having them.
Does removing the plugin give players their items back?
No. Items in live listings and unclaimed collection bins live in the plugin's database. See Installation for how to wind it down without stranding anything.
Can I change the menu layout, or which item is used for a button?
Not in 1.0.0. The colours and every piece of text are configurable; slot positions and button materials are not.