游戏内任务：每日任务和奖励

玩家看到什么

• 以标签页呈现的周期：每日、每周、成就，并显示到下一个周期的计时。
• 每个任务上的进度条，以及显示全部目标的详情弹窗。
• 用于已完成任务的**“全部领取”按钮**。
• 积分进度条，宝箱随积分累积而开启。
• 有已完成任务待领取时，标签页上的徽标。

任务的结构

• 周期：一组按计划进行的任务：每日、每周、常驻或限时活动。周期可以按阶段依次进行，例如一个八周的赛季，每周都有自己的任务和积分进度条。
• 任务：一个或多个目标，每个目标有自己的计数器（“击败 20 个怪物”），以及一份奖励。任务可以要求先完成另一个任务：任务链就是这样构建的。

奖励有三种，并且同时生效：

1. 任务奖励：所有目标完成时发放。
2. 积分进度条上的宝箱：领取任务会增加周期积分，达到所需总数时开启宝箱。
3. 分组奖励：同一组中完成了设定数量的任务时发放。

进度从哪里来

开发者须知

任务通过 @idosgames/core 中的 client.quest 工作。进度按计数器名称而不是按任务发送：服务器会把它交给所有监听该计数器的进行中任务。

// 在发生的位置：击败了一个怪物
await client.quest.addQuestProgress('monsters_defeated', 1)

// 任务界面：玩家的进度；周期会自动向前滚动
const state = await client.quest.getUserQuestState()

// 领取已完成任务的奖励
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)

• addQuestProgress 只推进来源为游戏的目标。服务器自己统计的目标会被拒绝。
• 永远不要“保险起见”多发数值：如果目标有单次调用上限，超出会导致玩家账号被封禁。
• 发放的奖励已经应用到 SDK 缓存中的余额，不需要重新加载。

每个字段都在技能 quest-system 中有说明，由 SDK 的 MCP 服务器提供。