Zone Configuration Reference¶

# ─── Zone Region ────────────────────────────
region:
  world: "world"
  min-x: -100
  min-y: 64
  min-z: -200
  max-x: 100
  max-y: 90
  max-z: 200

# ─── General ─────────────────────────────────
enabled: true
permission: ""
max-players: -1              # -1 = unlimited
ip-limit: 0                   # 0 = disabled

# ─── Rewards ─────────────────────────────────
reward-interval: 180          # seconds between rewards
rolls-per-interval: 1         # how many rewards per roll
reset-timer-on-reward: true   # reset countdown after reward

# ─── Streak & Combo ─────────────────────────
streak-interval-minutes: 30   # minutes to level up streak (0 = disabled)
streak-max-level: 5            # maximum streak multiplier level

# ─── Safety & Limits ────────────────────────
session-time-limit: 0          # max minutes per session (0 = unlimited)
auto-kick-minutes: 0           # kick after X minutes AFK (0 = disabled)
daily-reward-limit: 0          # max rewards per player per day (0 = unlimited)

# ─── Enter Conditions ───────────────────────
enter-conditions:
  min-playtime-minutes: 0     # minimum total playtime (0 = none)
  min-level: 0                 # minimum XP level (0 = none)
  required-permission: ""      # additional permission node

# ─── Anti-Redirection ───────────────────────
redirection-grace-seconds: 5   # grace period after entering zone

# ─── Time-Based Activation ──────────────────
active-days: []                # empty = every day. e.g. [SATURDAY, SUNDAY]
active-hours: []               # empty = always. e.g. ["18:00-22:00"]

# ─── Display ────────────────────────────────
display:
  soft:
    title: "&#7C3AED⌚ &#8B5CF6AFK"
    subtitle: "&#7C3AEDZone: &#8B5CF6%zone%"
    action-bar: "&#7C3AED— &#8B5CF6Next: &#7C3AED%time%"
    bossbar:
      text: "&#7C3AED⌚ &#8B5CF6AFK &#7C3AED— &#8B5CF6Next: &#7C3AED%time%"
      color: PURPLE
      style: SEGMENTED_20
      direction: DECREASING
  hard:
    title: "&#FF4444⚠ Forced AFK"
    subtitle: "&#FF6666Move to exit AFK mode"
    action-bar: "&#FF4444Move to exit"
    bossbar:
      text: "&#FF4444⚠ AFK — Move to exit"
      color: RED
      style: SEGMENTED_20
      direction: DECREASING

# ─── Sounds ─────────────────────────────────
sounds:
  zone-enter: ENTITY_EXPERIENCE_ORB_PICKUP
  zone-leave: ENTITY_ITEM_BREAK
  reward-receive: ENTITY_PLAYER_LEVELUP

# ─── Commands ───────────────────────────────
enter-commands: []
leave-commands: []

# ─── Rewards Table ──────────────────────────
rewards:
  - chance: 60
    display: "&bDiamond x5"
    commands:
      - "give %player% diamond 5"

  - chance: 30
    display: "&a$500"
    money: 500

  - chance: 10
    display: "&6Netherite Ingot"
    commands:
      - "give %player% netherite_ingot 1"