【4.1.2适配】任务物品指示器

原地址：任务物品指示器4.0.13回溯移植 – 模组详情 – The Forge
原搬运地址：4.0 任务指示器          谢谢SARIEL1472大佬

早就在想这个功能了，看到SARIEL1472大佬搬运的这个mod马上用ai适配  
顺便添加了mod任务物品也可以显示的功能，不过需要手动加白名单，如果玩我发的isb商人想找任务道具，下面我发了内置isb商人任务道具的白名单

一、这是什么？

  客户端 BepInEx 插件。进图后，如果 5 米内有”当前任务需要的物品”，

  屏幕中央会出现一个指向该物品的指示环，效果和原版任务物品完全一样。

  本适配版在 SPT 4.1.2上重新编译，并新增了

  “自定义任务物品白名单” 功能：

  其他 mod 的自定义任务物品，只要把它的模板 ID 加进

  taskitem_whitelist.json，就会和原版任务物品一样被指示环标记。

二、安装

  1. 把整个 TCF-TaskItemIndicator 文件夹复制到：

       <游戏根目录>\BepInEx\plugins\

  2. 启动游戏，BepInEx 会自动加载插件。

  3. 首次启动会在插件目录生成 taskitem_whitelist.json（自带中文注释）。

三、配置文件说明（taskitem_whitelist.json）

  文件支持 // 注释，保存后约 5 秒自动重新加载，无需重启游戏。

  includeVanillaQuestItems（默认 true）

    是否同时启用原版任务物品指示。

  extraQuestItems（额外任务物品模板 ID 列表）

    每个条目支持两种模式（mode）：

    (1) always 模式（默认）：只要附近出现该物品就显示指示环

        适用于”任务纯服务端、不同步进客户端 QuestBook”的 mod。

        写法：直接写字符串，或写成对象：

          “5d40419286f774318526545d”

          { “id”: “644c37e1801a792c3a26ea63”, “note”: “说明”, “mode”: “always” }

    (2) quest 模式：跟随任务状态，和原版完全一致

        只有客户端 QuestBook 中对应任务”进行中”(Started) 且条件未完成时

        才显示；未接任务、任务已完成都不显示。

        写法（mode 写 “quest”）：

          { “id”: “692d302aa11c340bc5198946”, “note”: “ISB 任务物品”, “mode”: “quest” }

    如何改成”跟随任务状态”？

      把该条目的 mode 从 “always”（或不写）改成 “quest” 即可。

      前提：这个 mod 的任务会同步进客户端 QuestBook。

      验证方法：进图后看 BepInEx\LogOutput.log，若该任务出现在

      “Wanted item(s)” 列表里，说明 QuestBook 能读到它，quest 模式可用。

  extraZones（额外放置区域 zoneId，可选）

    用于”把物品放到指定位置”类型的任务。键是 zoneId，值可以写说明

    字符串（always 模式），也可以写成对象指定 mode：

      “some_zone_id”: “区域说明”

      “aishi_gz_van1”: { “note”: “ISB 放置点”, “mode”: “quest” }

四、ISB 商人任务（已内置）

  本白名单已把 ISB-Aishi 商人的任务物品和放置区域全部加入，统一使用

  quest 模式（跟随任务状态），共 35 个物品、21 个区域：

    – 接了对应 ISB 任务且未完成时：指示环正常显示，与原版任务一致

    – 未接 / 已完成：不显示

  说明：ISB 任务通过 SPT 标准任务管线写入客户端 QuestBook（非纯服务端），

  所以 quest 模式完全有效。若某件 ISB 物品你希望改成常亮，把它的

  “mode”: “quest” 改成 “always” 或直接改成字符串写法即可。

五、可调参数

  指示环大小、粗细、颜色、扫描间隔等在 BepInEx 的 cfg 文件中：

       <游戏根目录>\BepInEx\config\com.thecrimsonfuckr.taskitemindicator.cfg

六、验证是否生效

  启动游戏后查看 <游戏根目录>\BepInEx\LogOutput.log，出现：

    – “Task Item Indicator loaded.”

    – “Task Item Indicator: whitelist loaded – 35 extra item(s), 21 extra zone(s) …”

  说明插件和白名单已加载。

七、常见问题

  – 物品 ID 在哪找？其他 mod 的任务物品模板 ID 通常在其数据库

    (items/*.json) 的 “_id” 字段里；ISB 物品也可在

    ISB-Aishi 的 db\Itens 中查找。

  – 改了白名单没反应？确认 JSON 格式正确（逗号、括号完整，不要有

    结尾多余逗号），最多等 5 秒自动重载；查看 LogOutput.log 是否有报错。

  – quest 模式不显示？说明该 mod 任务没有同步进客户端 QuestBook

    （纯服务端任务），请改用 always 模式。