🛒 Shop Stands

#Information

The Shop Stands add-on adds a block that buys and sells one item from one of your shops. A floating display above it shows the item and its prices. Every click goes through the same checks as the shop menu, so currencies, stock, limits, requirements, availability and conditions all apply.

A player who cannot open the stand's shop cannot use the stand either.

#Installation

To install this add-on, drag and drop the jar file into the PhoenixShop/addons folder, then restart your server.

#Placing a stand

Give yourself a stand with /pshop stand give, then place it like any block. The stand remembers the shop, category and item it was given for.

Click	Default action
Right-click	Buy one lot.
Shift + right-click	Buy up to a stack, as much as fits and the player can afford.
Left-click	Sell one lot.
Shift + left-click	Sell every matching item the player carries.

When the item is removed from the shop, the display says it is unavailable and clicks are refused until the stand is removed.

#Protection

Only players with the break permission can break a stand. Breaking it deletes the stand, and outside creative mode drops a new stand item for the same shop item. Explosions, pistons, fire, endermen and hoppers cannot move, destroy or reach into a stand.

#Settings

material: BARREL
refresh-seconds: 30
click-cooldown: 250
clicks:
  right: BUY
  shift-right: BUY_STACK
  left: SELL
  shift-left: SELL_ALL
display:
  text-height: 1.75
  show-item: true
  item-height: 1.35
  item-scale: 0.5

Option	What it does
material	The block a stand is placed as. Anything that is not a block falls back to BARREL. Changing it does not touch stands already placed, but old stand items can no longer be placed.
refresh-seconds	How often every display is redrawn, so price and stock changes show up.
click-cooldown	Milliseconds a player has to wait between two clicks on a stand. 0 turns it off.
clicks.*	The action of each click. One of BUY, BUY_STACK, SELL, SELL_STACK, SELL_ALL or NONE.
display.text-height	How far above the stand's base the text floats.
display.show-item	Whether the item itself floats above the stand, below the text.
display.item-height	How far above the stand's base the item floats.
display.item-scale	The size of the floating item. 1 is the size of a block.

The display text, the stand item's name and lore, and every message are in the translation file, under the shopstands section.

#Files

File	What it holds
PhoenixShop/addons/ShopStands/config.yml	The settings above.
Plugin database	Every placed stand. An old stands/ folder is moved there on first start and renamed stands.migrated.
PhoenixShop/addons/ShopStands/translations/shopstands.translations.<lang>.yml	The add-on messages and display lines.

#Placeholders

Available in the display lines.

Placeholder	Shows
%item%	The item's name.
%shop%	The shop's name.
%category%	The category's name.
%buy_price%	The price of one lot after its category sale, with the full price struck through beside it while a sale runs, or the unavailable text when the item cannot be bought. Price modifiers are left out of the shared display, but a click still applies them.
%sell_price%	What one lot sells for, or the unavailable text when the item cannot be sold.
%buy_amount%	How many items one bought lot gives.
%sell_amount%	How many items one sold lot takes.
%stock%	The stock left, or the unlimited text.

#Commands

Command	Description
/pshop stand give <player> <shop> <category> <item> [amount]	Gives an online player up to 64 stands for a shop item.
/pshop stand remove	Removes the stand you are looking at, block included.
/pshop stand list	Lists every stand with its shop item and position. A stand whose item no longer exists is marked as missing.

#Permissions

Permission	What it allows
phoenixshop.command.stand	Giving, removing, listing and placing stands.
phoenixshop.stands.break	Breaking a stand.

phoenixshop.admin grants both. Using a stand needs no permission of its own.