任务标记

Side Quest Map Markers

### 描述

我在游玩《龙之信条2》时很快意识到，对我来说缺少了某些东西。

我不是那种喜欢随机游荡几个小时、希望偶然碰到内容的玩家。仅仅玩了几个小时后，我就已经接近终局，却突然意识到自己几乎没完成任何支线任务。

于是我开始研究原因。

问题在于，《龙之信条2》常常几乎不给你任何提示，告诉你支线任务究竟可以在哪里开始。有时即使你完成了某个 NPC 的任务，之后也没有明显理由再回去找他们。除非你上网搜索，或者恰好撞对了地点，否则你很容易错过大量有趣内容。

我找不到另一个能以自然方式简单解决这个问题的模组。所以我自己做了一个。

**Side Quest Map Markers** 会为当前可接取的支线任务添加地图标记，使用游戏原生的任务标记系统和运行时任务目录。目标很简单：让玩家有理由探索世界、发现更多游戏内容，而不必不断打开浏览器搜索任务攻略。

---

### 重要：工作原理

本模组严格遵循《龙之信条2》的原生任务标记行为：

* **要看到可接取支线任务的标记，你的日志中必须没有当前激活/选中的任务。**
* 如果你选择追踪某个任务，游戏会自动隐藏其他支线任务标记。这是正常且有意为之的设计，可让你的地图保持整洁。
* 只需在日志中取消追踪/取消选择当前激活任务，所有可接取的支线任务标记就会立刻重新出现。

---

### 主要功能

**智能地图整合**

* 显示当前可接取/可接受支线任务的原生地图标记。
* 随着任务可接取状态变化自动实时更新。
* 根据你是否正在追踪激活任务，无缝切换可见性。

**高级引擎运行时逻辑（v2.3.1）**

* **100% 动态且无需 JSON：** 在运行时直接从游戏引擎读取任务目录数据（`QuestCatalogDict`、`CharacterManager`、`NPCManager`）。不需要外部 JSON 文件或 Quest Tracker 依赖，因此对未来游戏补丁和 DLC 更具前瞻性。
* **死亡 NPC 保护：** 自动检查任务发布 NPC 是否已死亡或位于停尸房。如果某个任务的所有发布者都已死亡，则不会显示该标记。
* **失败/取消任务过滤：** 查询深层引擎状态，确保失败、取消或静默关闭的任务永远不会生成幽灵标记。

**性能与稳定性**

* **零内存泄漏：** 干净的原生标记实例化，防止长时间游玩期间内存累积和崩溃。
* **CPU 优化：** 使用积极的反射缓存（`REFramework`）以及 2 秒签名节流间隔，确保对帧率或卡顿零影响。

---

### 要求与安装

1. 需要 **REFramework**。
2. 下载 `SideQuestMapMarkers.lua`。
3. 将文件放入你的游戏目录下：
`[Game Directory]/reframework/autorun/SideQuestMapMarkers.lua`
4. 启动游戏。模组将自动加载。

[heading]FAQ（常见问题）[/heading]
[list]
[*][b]Q：这会在 DD2 Dark Arisen 上生效吗？[/b]
[b]A：[/b] 会，不过未来特定的活动触发支线任务可能暂时还不会显示在地图上。
[/*]
[*][b]Q：我需要安装外部 JSON 文件或其他模组（例如 Quest Tracker）吗？[/b]
[b]A：[/b] 不需要。本模组 100% 独立，完全依赖游戏引擎运行时（[i]Clean Room Runtime[/i]）。它会实时直接从内存读取所有信息，不需要外部数据文件或依赖。
[/*]
[*][b]Q：为什么我在地图上看不到支线任务标记？[/b]
[b]A：[/b] 请确认你的日志中没有任何激活或追踪中的任务。遵循游戏严格的原生行为，可接取支线任务标记只会当你[b]没有[/b]追踪任何激活目标时自动出现。
[/*]
[*][b]Q：这个模组会影响性能或导致延迟/卡顿吗？[/b]
[b]A：[/b] 不会。代码通过积极缓存和 2 秒刷新间隔进行了优化，即使长时间游玩也能确保零 CPU 影响和零内存泄漏。[/*]
[/list]
[list]
[*][b]Q：这个模组与 Quest Tracker 有关吗？[/b][/*]
[*][b]A[/b]：没有。本模组 100% 独立，与“Quest Tracker”没有任何代码或数据关系。虽然 Quest Tracker 提供详细任务日志、追踪菜单和自定义名称，但 **Side Quest Map Markers** 只专注于显示可接取支线任务位置的原生地图标记。它们是完全独立的项目，不过如果你选择一起使用，它们可以和平共存。 [/*]
[/list]---

### 法律声明与版权免责声明

**发送私信（PM）前请先阅读：**

本模组完全独立开发。**它不包含任何复制自或衍生自其他现有模组的代码、资源或 JSON 文件。**

本脚本中使用的所有函数、类型、方法和变量都仅与公开的 **REFramework SDK** 以及原生 **RE Engine** 游戏类（例如 `app.GuiManager`、`app.QuestManager`、`app.NPCManager`）交互。有关 API 调用和游戏数据的信息来自技术逆向工程、公开的 REFramework 文档以及官方游戏 wiki。

为完全透明并避免任何误解，本模组中用于特定区域触发或隐藏支线任务（即没有标准 NPC 发布者的情况）的任何手动坐标参考或后备位置，均由我个人在游戏内独立搜索、测试并记录。未使用任何外部代码、资源或第三方数据集。

**官方 wiki 和公开引擎 SDK 上可获取的信息、变量和 API 结构属于公共领域，任何模组作者都不能将其声称为知识产权。**

*任何试图发送私信声称虚假版权侵权、对公开引擎变量提出毫无根据的所有权主张、散布虚假暗示，或骚扰作者的人，都会被立即拉黑，并向 Nexus Mods 工作人员举报其滥用举报系统和骚扰行为。*