Using it

Rotation and deals

The rotation decides which catalog items are on the stands. It fills itself as soon as items or stands exist, and /shardshop admin rotate rotates immediately. The countdown carries on through a reload.

rotation:
  # When false, the shop only changes with /shardshop admin rotate.
  enabled: true
  # interval: every X. daily: each day at a time. weekly: one day each week.
  mode: interval
  # interval mode. Examples: 12h, 3d, 1d12h
  every: 7d
  # daily and weekly modes. 24-hour clock.
  time: "18:00"
  # weekly mode.
  day: FRIDAY
  # Blank uses the server clock. Example: America/New_York
  timezone: ""
  # An item stays out of the shop for this many rotations, when there are enough other items.
  avoid-repeats: 1
  # Chat message, title and sound when the shop changes.
  announce: true
  # Warnings before a rotation.
  warnings: [24h, 1h, 10m, 1m]
  • mode: interval rotates every every (for example 12h, 3d, 1d12h). mode: daily rotates each day at time. mode: weekly rotates on day at time. time uses a 24-hour clock.
  • Set enabled: false to rotate only by hand. An interval of 0 is also an off switch.
  • timezone takes names such as America/New_York. Blank uses the server clock.
  • avoid-repeats keeps an item out of the shop for that many rotations, when there are enough other items.
  • warnings are the times before a rotation when players are warned.

How items are chosen#

Always-on items are placed first, then each rarity's guaranteed amount, then the remaining slots are filled by rarity weight and item weight. Items outside their season or marked enabled: false are skipped.

Deals#

Each rotation, a random discount is applied to some items. Items with deals: false or no price are never picked. The percentage is kept between 1 and 90.

deals:
  enabled: true
  per-rotation: 1
  min-percent: 10
  max-percent: 30

Rotation editor#

In /shardshop admin, open Rotation to see what is on sale, swap any item for another one, or rotate on the spot.