SnDisplayShops changelog

Changes

The owner menu is a SnLib menu now. SnLib 1.28.0 added menus that can receive an item (input cells + an open player inventory + item offers), and this release moves the owner menu onto it. The layout lives in guis/owner.yml, in the same dialect as the buyer menu; the old owner-menu.yml at the plugin folder root is no longer read, and the plugin logs a pointed warning if it finds one. "Your item is read, never consumed" is now enforced by SnLib itself.

What changed in how the menu behaves, each on purpose:

• Shift-click ONLY deposits. A stack that does not match the traded item is refused with a message instead of silently replacing what the shop trades. Setting or changing the traded item is the center cell alone: click it holding the item on your cursor, or drag one onto it.
• Pickup asks twice. The first click arms a red confirm cell; the second click within five seconds removes the shop. Left alone, it disarms itself.
• Real pagination. A page indicator between the arrows, arrows that gray out at the ends, and no more click-past-the-end counter to click back down.
• The menu is live. Stock, price, mode, currency and the title follow changes while the menu is open - trades update the grid under you.
• Everything answers. Refused deposits, full inventories, empty cycles and dead cells all say why; withdraw-all now reports what you got, not only what stayed.

Upgrading

• Requires SnLib 1.28.0 or newer on the server (API level 19). Update SnLib.jar first: https://github.com/ValentinTarnovsky/SnLib/releases/tag/v1.28.0
• Owner menu customizations must be redone in guis/owner.yml (SnLib menu dialect). The old owner-menu.yml is ignored; delete it once restyled. To remove the withdraw button, delete the w from the layout - there is no toggle key any more.

Changes

• The display item bobs. The floating item now rises and falls the way a dropped item does, on top of the spin it already had. Two new keys under hologram: in config.yml: bounce-amplitude (0.1 blocks, 0 turns it off) and bounce-period-ticks (80). The bob is carried by the same push the spin already sends, so it costs nothing extra no matter how many shops are loaded.
• The chat price prompt accepts formatted numbers. 1k, 1.5m, 2b, up to Qi, and 1.500.000 typed back exactly as the menu prints it. Numbers written out in full stay exact at any size. A line with more than one separator, or one past the largest price there is, is refused instead of guessed at.
• config.yml ships two example currencies instead of six - one command-backed, one EdTools-backed, one of each shape. currencies: is marked extensible, so nothing an operator already declared is added, removed or touched by the update.

Player-owned display shops: place a tagged item, set a price, and it trades on its own.

What it does

• Shops are placed, not commanded. A shop is any block placed from a tagged item, so its material is whatever the operator configures. Identity lives in the item's PDC, never in the block type.
• A rotating hologram over every shop. A native ItemDisplay spinning above a text line, with DecentHolograms driving the text where it is installed and a native TextDisplay where it is not.
• Two menus. Buyers get a compact offer with a one-click and a trade-all button; owners get a full management screen for the item, the price, the currency, the direction, pausing, stock and pickup.
• Buy or sell. A shop faces either way: it sells its stock to players, or it buys from them and pays out of its owner's balance.
• Storage without slots. Stock is held per item variant as a 64-bit amount rather than as inventory slots, so a shop can hold more of something than a chest could ever represent.
• As many currencies as you configure. Each one is independently backed by an economy plugin's commands or by EdTools, so a server can run coins, gems and tokens side by side.
• SuperiorSkyblock aware. Shops on an island can be removed with it when it disbands or when their owner loses membership, both behind operator toggles.
• PlaceholderAPI: %sndisplayshops_shops_count%, %sndisplayshops_shops_max%, %sndisplayshops_shops_total%.
• A public API for other plugins to read shops and their stock, and to draw stock down.

Requirements

• Paper 1.20.x or 1.21.x
• SnLib
• Optional: PlaceholderAPI, DecentHolograms, EdTools, SuperiorSkyblock

Configuration

Everything the plugin says and every number it uses lives in config.yml, lang/messages_en.yml, guis/buyer.yml and owner-menu.yml. All four are managed: new keys are merged in on upgrade and your edits are kept.

Two worth knowing before you tune them:

• database.pool-size ships at 1 on purpose. Two writers can land a shop's stock updates out of order, and the losing write is the one that survives a restart. The plugin logs a SEVERE if it finds MySQL configured above 1.
• limits.max-pickup-stacks has no "off" value. Picking up a shop hands its whole stock back in one tick, so an unbounded value is a hang rather than a preference.