Using it

Stands and the info board

Every stand shows its item, spinning and bobbing, with text above it. The text comes from holograms.yml and the visual settings from the stands and board sections of config.yml.

stands:
  # Height of the item and the text above the stand's block.
  item-height: 1.25
  text-height: 2.0
  item-scale: 0.9
  text-width: 220
  # How far away the text can be read, in blocks.
  text-range: 24
  # The small block under the item. Its look comes from the rarity.
  base: true
  spin: true
  spin-degrees-per-second: 90
  bob: true
  glow: true
  particles: true
  # Items shrink and pop back as the new ones when the shop rotates.
  reveal: true
  • A stand shows the rarity glow, sparkle particle and base block set for the item's rarity.
  • When an item sells out, the glow turns off and the text changes to SOLD OUT with a countdown to the next rotation.
  • With reveal: true, items shrink away and pop back as the new ones when the shop rotates, one stand after another.
  • Stand entities are never saved in the world, so a crash cannot leave copies behind. They come back when a chunk loads.

Changing the text#

holograms.yml controls the lines above stands (stand.lines, stand.sold-out-lines, stand.empty-lines) and on the info board (board.lines). A line that only holds a placeholder is left out when it has no value. Stand placeholders are %rarity% %name% %description% %price_line% %stock_line% %countdown%. Board placeholders are %schedule% %countdown% %rotation% %left% %total%.

stand:
  lines:
    - "%rarity%"
    - "%name%"
    - "%description%"
    - "%price_line%"
    - "%stock_line%"
  sold-out-lines:
    - "%name%"
    - "&c&lSOLD OUT"
    - "&7Back in &f%countdown%"

Info board#

Place it with /shardshop admin setboard. Its size comes from board.scale, board.width and board.background-alpha.

board:
  scale: 1.5
  width: 300
  background-alpha: 96