Daily and Weekly Quests (Premium)

Recurring quests automatically give players quest papers on a schedule. Configure plugins/SoapsQuest/daily.yml. This file is Premium only and is not included in the Free JAR.

---

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 conditions.permission, only players with that permission receive it.

---

Enable daily quests

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

daily:
  enabled: true
  schedule:
    time: "06:00"
  pool:
    quests:
      - zombie_slayer
      - lumberjack
      - gone_fishing
    mode: random
    count: 1
  bonus:
    enabled: false
    reward:
      xp: 150
      sigils: 25
      money: 100

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 or ordered
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
    mode: random
    count: 1
  bonus:
    enabled: false
    reward:
      xp: 600
      sigils: 100
      money: 400

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 tracked in playerdata.yml. 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.3 - Premium