任务目标

任务目标将符合条件的服务端事件转为数值进度或完成标志。类型自身的检查先于事件过滤树执行；任务中的全部目标完成后才会发放奖励。悬赏任务还需向接待员确认汇报后结算，见悬赏数据。

文件放在哪里

目标位于 data/<namespace>/quests/**/*.json 的 objectives 数组中，不是独立资源。任务数据说明外层文件、资源优先级、标识及整体目录校验。下文所有内置目标类型都使用 isekaiexpansion 命名空间。

最小示例

将此条目放入任务的 objectives 数组，并补齐任务数据页要求的根字段。它采用示范文件中的 visit-location 结构，不需要类型专用字段。没有事件过滤时，首个合格玩家刻即可完成。

{
  "id": "visit",
  "progress_type": "boolean",
  "type": "isekaiexpansion:visit_location",
  "data": {}
}

字段

目标外层结构

数值进度累加类型给出的非负增量，上限为 2147483647。布尔进度在首个匹配事件变为 true，不取决于该类型的数值增量。完成的目标不再接收常规进度、手动内容或失败检查。普通追踪路径要求存在归属玩家才能推进；附近无玩家归属的死亡不会提供击杀进度。

类型参数

以下字段位于目标的 data 中。其他类型的字段通常没有效果，除非解析器明确拒绝。

击杀归属会将直接玩家、玩家投射物、跟随 NPC 及其投射物解析到责任玩家。party 接受该归属玩家对共享档案的贡献，不会给周围所有队伍发放进度。player 排除伙伴归属；picker 将责任玩家与保存的领取者比较。武器谓词检查事件发生时该玩家的双手，不检查投射物或伙伴上保存的武器。

交互回调报告使用尝试，随后交还常规交互处理；目标不等待方块或实体交互成功。手部及归属选项去除首尾空白并忽略大小写，未知名称拒绝定义。配方和进度目标响应激活后的事件，不扫描历史制作或已经取得的进度。

实体、物品与方块谓词

单数和复数字段合并；两者均可接收字符串或数组，去除首尾空白、忽略空项并合并重复值。此处的实体类型、物品、方块及伤害标签均使用不带 # 的纯 ID，下文位置标签例外。

实体身份匹配任一类型 ID 或类型标签后，还须满足全部命令标签及 NBT 过滤。空实体谓词用作目标时，仍要求实体存在且未移除。空物品或方块谓词在加载时被拒绝。未知标签通常无法匹配；与显式物品、方块、实体 ID 不同，谓词解析器不检查这些标签引用是否存在。

NBT 过滤分别对比实体数据、物品堆叠自身 NBT 或方块实体数据，使用下文的类型化 NBT JSON 对象，不接受 SNBT 字符串。

位置与 NPC 身份

通用位置谓词同时应用维度、球形坐标、群系及结构条件组。群系组内或结构组内的候选之间为或关系。空位置对象仍要求存在世界与事件位置。

位置选择器的单复数字段同样合并、去除首尾空白并忽略空项。结构匹配使用异界核心解析出的包含结构；查询失败即不能满足结构条件。NPC 选择器检查 NPC 位置，而目标的 location 条件检查事件位置，例如交互方块中心、NPC 位置、击杀位置或照片位置。

NPC 身份别名可能匹配同类型通用 NPC 的多个实例。若任务要绑定某个区域，应添加位置范围；此选择器不强制要求唯一身份注册。

交付

以下字段位于 data.delivery 内。枚举字符串去除首尾空白并忽略大小写，未知选项拒绝定义。

主手来源要求该堆叠含有完整批次；背包及货车来源可在同一个库存内合计多个匹配堆叠。货车模式在加载时要求安装可选模组 Nifty Carts，围绕 NPC 搜索最近的合格库存货车，不要求货车与携带者连接。

自动接近检查每 5 刻执行一次，按玩家实体 ID 错开；每秒 20 刻时为 0.25 秒。一次检查只处理首个成功交付，不会处理全部待交批次。桥接先检查目标事件条件，再消耗物品，最后向指定任务和目标发送事件。

物品数量与目标进度不同。一批 16 个物品增加 1 数值进度，因此 required: 3 需要成功交付 3 批。consume_on_complete: false 时，接近目标可在后续检查重复使用同一批物品。交付消耗与随后追踪器执行不是可回滚事务。

已移除的 delivery.constraints 字段会被明确拒绝。受支持的失败规则应放在 data.failures。

目标事件条件

此条件树位于 objectives[].conditions，通过位置、实体或事件参数叶子过滤事件。玩家等级、队伍和 sequence 属于领取及内容触发器使用的另一套通用条件树。

分组采用短路计算。location 叶子直接将位置字段放入 data，没有额外 location 包装；entity 也直接包含实体谓词字段。只有不要求存在时，缺失或已移除实体才通过。payload 使用存储值的布尔或数值转换，不执行严格参数类型校验，因此应选择事件实际产生相应类型的键。

非照片事件的常用参数键包括：交互的 hand、sneaking；击杀的 credit；对应 NPC 事件的 npc_identity、dialogue_id、delivery_source、delivered_count；制作的 recipe_id、recipe_type、recipe_serializer、output_item_id、crafted_amount、source；进度的 advancement_id、criterion、complete；地牢完成的 dungeon、difficulty。可选制作元数据可能缺失。

摄影事件参数

Exposure 桥接依次选择获奖服务端玩家、执行拍摄的服务端玩家、玩家持有者；均不存在时不发送任务照片事件。事件来源是相机持有者，目标是 Exposure 提供的照片实体列表中距照片位置最近、未移除的生物实体。

这些键用于 isekaiexpansion:payload，属于生成的事件数据，不是 photograph.data 的额外字段。“有记录时”表示 Exposure 照片含有对应元数据。

照片实体列表汇总所有有效拍摄对象；普通实体过滤器只检查最近目标。要要求画面任意位置出现某种类型，应检查 entity_types_in_frame。空字符串列表不会写入参数，因此只有该参数条件设为 require_present: false 时，缺失列表才直接通过。

内容触发器与序列状态

普通推进先修改数值，再执行 objective_progressed；若此次修改首次完成目标，随后执行 objective_completed。手动内容事件本身不增加目标进度。每次触发条件通过都会按编写顺序执行动作，没有隐式的仅一次标志，因此内置生成动作可能反复执行。

序列进度按 id 存储在整个活动任务内，复用 ID 应有明确目的。序列记住已满足步骤，到达末尾后保持真；每次回调只计算当前子条件。嵌套有状态子条件报告状态变化时，会短路父序列的状态写入，父序列可能需要下一次回调才记录推进。嵌套序列不是原子的多步骤求值器。

生成动作

唯一内置内容动作是 isekaiexpansion:spawn_entities，其 data 使用下表字段。距离单位为方块，角度单位为度；数值超界时拒绝而非钳制，所有作者浮点值必须有限。

quest_picked 使用领取位置为锚点，进度或完成事件使用事件位置，手动触发使用传入的位置。radius 模式忽略 offset。spread 为每个实体独立搜索；cluster 先解析基准，再为后续实体搜索附近位置。搜索失败会记录警告，也可能只生成部分实体，不会撤销目标进度或奖励。

候选搜索要求有承托且无碰撞的空间，并应用室外、流体、可见性、结构及局部连通规则。同房间搜索受来源垂直邻域 ±4 方块和节点预算限制。精确偏移路径检查空间与高级约束，但不应用 max_vertical_delta。依赖来源的策略在缺少同世界来源时失败。

遭遇数量限制统计扫描盒内未移除且带指定标签的实体，包括其他动作复用此标签生成的实体；它不是全局数量上限，也不是任务所有权驱动的清除策略。生物初始化先于作者 NBT，之后设置命令标签、持久标志和目标。禁用动作会移除；若触发器所有动作均被禁用，该触发器无效。

失败规则

delivery_item_leaves_hand 在玩家刻检查尚未完成目标的原领取者；若其主手不再持有匹配的完整批次，整个任务失败。它没有“首次拿起后才启用”的阶段，也没有宽限时间。delivery_damage_while_carrying 在该领取者仍持有匹配完整批次时，因玩家受伤事件使任务失败。

同一事件先执行失败检查，再执行进度检查；失败检查不复用目标事件条件树。完成的目标不再提供失败检查。严格携带的多批次目标消耗一批后，可能在下一刻因剩余物品不足而失败，因此目标尚未完成时仍需满足物品要求。

类型化 NBT

普通 JSON 对象变为 compound，布尔值变为 byte，整数字面量变为 int 或 long，其他有限数值变为 double。数组必须转为同一种 NBT 元素类型，null 被拒绝。要指定基本类型或基本类型数组，使用恰好含下列字段的嵌套包装对象：

整数字面量首先必须位于有符号 64 位范围内；声明 byte、short、int 时范围更窄。float 包装还会拒绝溢出有限 float 表示的数值。类型包装含额外键、列表元素类型混合或类型名称未知时，任务定义被拒绝。

校验

未知类型、缺少必填对象、范围错误、空物品或方块谓词、不支持的交付组合、重复失败类型或无效内容触发器，均按任务数据规则拒绝任务目录重载。未知键通常被忽略，因此把有效字段放在错误的目标类型下，可能静默失去预期限制。

显式实体、物品及方块 ID 会检查注册表。配方、进度、对话、维度、地牢及许多标签引用主要检查标识语法，并在后续事件中匹配；语法正确但不存在的目标可能成功加载却永不推进。启用的生成动作要求实体类型已注册，但执行时仍可能找不到可用位置。

重载

目标随外层任务重载。活动进度按任务 ID 和目标 ID 保存；修改类型、目标、所需次数或序列 ID 时，不会自动迁移其含义。修改定义后，应同时检查已激活任务和新领取任务。

服务端保持权威。客户端数据只是用于展示的投影，不包含完整可执行内容触发树。翻译及资源修改需要单独重载客户端资源。

相关页面

• 任务数据 — 完整任务文件、领取及冷却。
• 任务奖励 — 接收者选择与奖励执行。
• 任务运行时 — 事件钩子、存档状态与调试。
• NPC 对话 — 对话及菜单集成。