TymDailyQuests

TymDailyQuests 是由 TymHaven 接手維護的分支，來源為已封存且採用 GPL-3.0 授權的 ODailyQuests。目前同時支援 Paper 1.21.11 至 26.2，並保留 TymHaven 現有的任務、指令、GUI、 PlaceholderAPI 與 SQLite 相容性。

核心插件已在 Paper 1.21.11、26.1.2 與 26.2 通過啟動及關服煙霧測試。 正式部署前仍須使用完整伺服器副本驗證 ItemsAdder 等外部整合。

相容性政策

專案與成品名稱為 TymDailyQuests，但 Bukkit 插件身分刻意保留為 ODailyQuests，藉此維持以下既有契約：

• plugins/ODailyQuests/ 與 database.db
• com.ordwen.odailyquests API 命名空間
• /dquests、/dq、/quests、/dqadmin 與既有指令別名
• 所有 odailyquests.* 權限節點
• odailyquests PlaceholderAPI 識別字

如果重新命名 Bukkit 插件身分，Bukkit 會改用新的資料夾，導致既有選單、權限、 placeholders 與玩家進度失效。

維護範圍

• Paper 1.21.11 至 26.2
• Paper 1.21.11 使用 Java 21；Paper 26.1 以上使用 Java 25
• 繼承自 ODailyQuests 的 SQLite、MySQL 與 YAML 儲存邏輯
• Vault 經濟獎勵
• PlaceholderAPI 佔位符
• ItemsAdder 物品查詢與資料重新載入處理
• Citizens NPC 選單互動
• TymHaven 使用中的原生 Bukkit 任務類型
• MONEY、COMMAND、EXP_POINTS、EXP_LEVELS 與 NONE 獎勵

TymHaven 版本已移除目前任務池未使用的直接整合：CoinsEngine、PlayerPoints、 TokenManager、ExcellentCrates 任務事件、MythicMobs、EliteMobs、Oraxen、Nexo、 MMOItems/MMOCore、堆疊插件 APIs、自訂釣魚與作物、Votifier、KGenerators、 保護插件 APIs、FancyNpcs、eco 事件與 UltimateAutoRestart 事件。

本版本會明確拒絕 required_regions，因為相關的 WorldGuard、Towny 與 PlotSquared 整合掛鉤不在 TymHaven 的維護契約內。

建置

需求：

• JDK 21
• 專案內附的 Gradle Wrapper

./gradlew clean build

整合依賴後的 JAR 會輸出至 build/libs/TymDailyQuests-<version>.jar。

若要用已停止的 TymHaven 資料副本驗證 189 個任務與 SQLite 基準：

python scripts/validate_tymhaven_contract.py /path/to/plugins/ODailyQuests

從 ODailyQuests 遷移

測試或部署前請先閱讀 MIGRATION.md。簡要流程是：停止伺服器、 備份舊 JAR 與完整的 plugins/ODailyQuests/ 資料夾、只替換 JAR，並先在伺服器 副本完成驗證，再考慮正式環境。

上游與授權

TymDailyQuests 以 Ordwen 的 ODailyQuests 為基礎，並持續採用 GPL-3.0 授權。 本 fork 保留完整的上游 Git 歷史與來源聲明。