Refresh System

Use refresh to update dynamic menu content.

refresh:
  mode: SMART
  interval: 20
  click_delay: 1

Keys

• mode: Refresh strategy
• interval: Tick interval for periodic refresh modes
• click_delay: Delay after click for click-triggered refresh

Modes

• DISABLED: No automatic refresh
• FULL: Rebuild full menu each cycle
• SMART: Refresh only dynamic/changed items
• SLOT_ONLY: Slot-level refresh strategy
• ON_CLICK: Refresh after player clicks

Recommended usage

• Use DISABLED for static menus
• Use SMART for most dynamic placeholders
• Use FULL only when many dependencies change together
• Use ON_CLICK for reaction-based menus

Example: dynamic player stats

stats-menu:
  title: '&8Your Stats'
  type: SIMPLE
  size: 27

  refresh:
    mode: SMART
    interval: 20

  items:
    stats:
      material: PAPER
      name: '&eStats'
      lore:
        - '&7Kills: %player_kills%'
        - '&7Coins: %player_coins%'
      slot: 13
      dynamic_update: true
      update_interval: 20