shops.yml

Each shop is a file in shops/<name>.yml. The default is shards.yml (set by Shop.Default-Shop). Open it with /afkzone shop. Stock rotates on a schedule: each rotation, Slots items are drawn from the pool by Weight.

Settings:
  Permission: ""
  Rotation:
    Enabled: true
    Interval: 86400
    Slots: 7
    Announce: true

Menu:
  Title: "Shard Shop"
  Size: 36
  Item-Slots: [11, 12, 13, 14, 15, 20, 21, 22, 23, 24]
  Items:
    Rotation-Timer:
      Material: CLOCK
      Slot: 4
      Name: "&d&lNext Rotation"
      Lore:
        - "&5 - &dNext Rotation: &f{time}"
    Balance:
      Material: AMETHYST_SHARD
      Slot: 35
      Name: "&d&lYour Shards"
      Lore:
        - "&5- &dBalance: &f{shards} {currency}"
    Filler-Item:
      Material: BLACK_STAINED_GLASS_PANE
      Slots: [0-10, 16-19, 25-35]
      Name: "&r"

Item-Format:
  Name: "&d&l{name}"
  Lore:
    - "&8Shard Shop"
    - ""
    - "&5 - &7Price: &f{price} {currency}"
    - "&5 - &7Stock: &f{stock}x"
    - "&e➥ Click to purchase!"

Items:
  diamond_block:
    Material: DIAMOND_BLOCK
    Price: 400
    Weight: 5.0
    Limit: 2
  netherite_scrap:
    Material: NETHERITE_SCRAP
    Amount: 2
    Price: 650
    Weight: 3.0
    Limit: 1
  booster_2x:
    Material: AMETHYST_SHARD
    Name: "&d&l2x Shard Booster"
    Glow: true
    Price: 800
    Weight: 4.0
    Limit: 1
    Actions:
      - "afkzoneadmin booster give {player} shard2x 1"

Settings

Key	Description
`Permission`	Optional node to open this shop.
`Rotation.Enabled`	Whether stock rotates (`false` = fixed shop).
`Rotation.Interval`	Seconds between rotations (`86400` = 24h).
`Rotation.Slots`	How many items are stocked each rotation.
`Rotation.Announce`	Broadcast the `SHOP-ROTATED` message on rotation.

Title, Size (multiple of 9), Item-Slots (where rotating items go), and Items (decoration). Two item names are reserved: Rotation-Timer (uses {time}) and Balance (uses {shards}, {currency}). Everything else, like Filler-Item, is pure decoration. Slots accept numbers or ranges ([0-10, 16-19]).

Item-Format

Name/lore template applied to every stocked item. Tokens: {name}, {price}, {currency}, {stock}.

Items

Each entry is a standard item definition plus shop fields:

Key	Description
`Price`	Cost in shards.
`Weight`	Rotation odds (higher = more likely stocked).
`Limit`	Max buys per player per rotation.
`Permission`	Optional node required to buy.
`Amount`	Stack size given (default 1).
`Actions`	If present, runs these actions instead of giving the item - sell boosters, ranks, keys, perks, etc.

The confirm menu (when Shop.Confirm-Purchase: true) is confirm.yml. Rotation countdown placeholder: %optimalafkzone_shop_rotation_<id>%.