Daily and Weekly Quests (Premium)

Recurring quests automatically give players quest papers on a schedule.

Premium config files

File	Role
daily.yml	Daily and weekly schedules, pools, bonuses, and reset notifications

Edition: Premium only. Free ignores this file. Defaults: Default daily.yml · Hub: Config Reference.

---

Overview

• Daily quests reset every day at schedule.time (server timezone).
• Weekly quests reset on schedule.day at schedule.time.
• Online players are notified on reset. Players who join mid-cycle receive any quests they have not yet gotten this cycle.
• Quest IDs must exist under quests: in quests.yml.
• If a quest has root permission:, only players with that permission receive it.

---

Enable daily quests

Global timing for join/reset assignment:

Key	Description
settings.join-delay-ticks	Wait after join before assigning (default 40)
settings.give-delay-ticks	Wait after reset before giving papers (default 20)

settings:
  join-delay-ticks: 40
  give-delay-ticks: 20

daily:
  enabled: true
  schedule:
    time: "06:00"
  pool:
    quests:
      - lumberjack
      - zombie_slayer
      - gone_fishing
      - baker
      - shepherd
      - sigil_training
    mode: random
    count: 2
  bonus:
    enabled: true
    reward:
      xp: 200
      sigils: 30
      money: 150

Field	Description
enabled	Master toggle for daily cycle
schedule.time	HH:mm 24-hour format
pool.quests	Pool of quest IDs to assign
pool.mode	random (shuffle and pick) or ordered (first IDs in the list)
pool.count	How many quests to give per cycle
bonus	Optional extra reward when all daily quests are claimed

---

Enable weekly quests

weekly:
  enabled: true
  schedule:
    day: MONDAY
    time: "06:00"
  pool:
    quests:
      - iron_miner
      - mob_hunter
      - diamond_rush
      - nether_explorer
      - master_builder
    mode: random
    count: 2
  bonus:
    enabled: true
    reward:
      xp: 800
      sigils: 120
      money: 500

Valid schedule.day values: MONDAY through SUNDAY.

---

Reset notifications

notifications:
  mode: "actionbar"   # actionbar | chat | title | bossbar | none
  sound:
    enabled: true
    type: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.0

Message text is in messages.yml under recurring-quest-reset-* keys.

---

How papers behave

Recurring quest papers use the same Active/Queued rules as /sq give papers. Progress is stored in playerdata.yml or data/players/<uuid>.yml when sharding is enabled. When a cycle resets, assignment records clear and eligible players receive fresh papers.

---

Setup checklist

1. Confirm Premium JAR is installed.
2. Add quest IDs to daily.pool.quests or weekly.pool.quests.
3. Set enabled: true on the cycle you want.
4. /sq reload
5. Test with a short quest pool and one player online across a reset time.

---

Version 1.0.6 - Premium