任务数据

任务定义将目标、奖励和玩家或队伍的领取规则组合在一起。任务目录整体校验后才会替换：定义或前置关系图出错时，系统保留上一版目录。

文件放在哪里

路径为 data/<namespace>/quests/**/*.json，每个文件定义一个任务。例如 data/example/quests/misc/visit.json 默认对应 example:misc/visit，显式 id 可以改写该标识。同一路径由常规资源包优先级选择文件；不同有效文件声明相同任务 ID 时，任务目录重载被拒绝。

任务定义属于服务端数据。标题和描述来自客户端的 assets/<namespace>/lang/en_us.json 与 zh_cn.json，不是任务 JSON 中的字段。当前仓库 docs/examples/quests/ 中的示范任务是编写参考文件，不是已安装的玩法内容。

最小示例

下例保留了示范文件中 visit-location 目标的必要结构。将它保存为 data/example/quests/first_tick.json。由于没有位置过滤条件，领取后下一次符合条件的玩家刻即可完成；要指定目的地，需添加目标条件。

{
  "tier": "misc",
  "prerequisites": [],
  "objectives": [
    {
      "id": "visit",
      "progress_type": "boolean",
      "type": "isekaiexpansion:visit_location",
      "data": {}
    }
  ],
  "rewards": []
}

字段

根对象

层级与任务池名称去除首尾空白、忽略大小写，并将空格和连字符转为下划线。任务池常量为 DEFAULT、TOWN、COMBAT、DEBUG、ADVANCEMENT、CRAFTING、FORGERY、ALCHEMY；对应 JSON 名称为 default、town、combat、debug、advancement、crafting、forgery、alchemy。

常规领取路径只允许未组队玩家或队长操作。已激活任务和未满足的前置要求会阻止领取，之后还要检查冷却和领取条件。主线按剧情进度下界、任务 ID 排序，选择首个符合条件的定义。杂项任务在指定池及可选章节的合格候选中按相对权重抽取；权重不能绕过资格检查。已完成的 misc 任务还必须保持重复领取解锁状态。

前置任务、目标与奖励

任务目标列出目标参数与事件过滤器，任务奖励说明奖励参数和接收者选择。

领取条件

条件对象使用 type 和 data。条件节点位置上的数组是 isekaiexpansion:all 的简写。下表描述领取及目标内容触发器使用的通用条件，不适用于目标事件过滤器的叶子类型。

在线成员检查不统计离线队友，也不要求同维度。若找不到匹配的在线成员，但存在操作玩家，则使用该玩家作为后备成员。

objective_progress 将 boolean 的 false/true 映射为 0/1。数值型 crossed_only 要求旧进度低于 min、新进度处于包含边界的范围内；直接跳过 max 不满足条件。布尔跨越要求 false → true，同时仍须满足范围检查。普通领取条件应使用玩家或队伍叶子，不应依赖目标进度。

冒险者阶级由异界核心管理。已依据所消费版本 0.4.0-build60 对应的本地源码仓库检查：可用晋升目标为 copper、silver、gold、diamond、mythril、adamantite、stormyx、celestium，去除首尾空白并忽略大小写；此处拒绝 none。就绪要求目标是下一阶，且初次晋升以外还须达到依赖方的声望要求；已经达到目标不算就绪。这是源码仓库核对，不代表二进制等价验证。

结算冷却

虽然字段名含 complete，完成与失败都会启动结算计时。THIS 使用本任务最近一次结算；ALL 使用当前已加载、拥有正数 ALL 规则的任务中，本档案最近一次结算时间，并非无差别统计所有任务。

每个候选任务将自己的冷却时长应用到对应计时点。两类限制都结束后才可领取；负的已流逝时间按 0 处理，没有结算记录则没有冷却。计时依据世界游戏时间，不包含服务器停止期间的现实时间。

翻译键

路径中的斜杠转为点；目标 ID 中的斜杠和冒号都转为点。选择规范化后仍不同的 ID：原始 ID 唯一并不能保证翻译键唯一。

校验

JSON 文本损坏时，底层资源读取阶段可能在任务校验前就丢弃该资源。整体替换保证针对交给任务解析器的定义，不保证每个不可读取的文件都会保留旧条目。

重载

服务端数据重载会重建任务目录，只有定义与前置关系图均通过校验才增加版本号。成功加载的空目录也会替换旧目录。保存的任务档案独立于定义；修改 ID 不等于迁移存档。

完整客户端同步发送可见定义及对应的过滤后档案，翻译资源仍需在客户端提供。任务运行时说明同步时机、活动状态协调和诊断方式。

相关页面

• 任务目标 — 目标类型、事件过滤、交付、内容动作及失败规则。
• 任务奖励 — 奖励字段、接收者及失败处理。
• 任务运行时 — 状态归属、持久化与集成。