Skip to content

Mod Compatibility zh CN

Jump to bottom
ABKQPO edited this page Jul 3, 2026 · 2 revisions

模组兼容

GuideNH 为部分模组内置了条件性兼容支持。每项集成只在目标模组加载时启用；目标模组不存在时，相关的标签、索引与按键绑定均保持静默，指南其余功能不受影响。

StructureLib

当 StructureLib 加载时，GuideNH 可以通过 <ImportStructureLib> 把多方块预览导入 <GameScene>。客户端指令 /exportStructure structureLib 也可以把这些预览导出为 PNG 文档截图。完整指令参数、StructureLib 专属选项以及相关的 gameScene 导出模式见 结构导出。

BetterQuesting

当 BetterQuesting 加载时，GuideNH 解锁三项能力：

  1. 页面前言新增 quest_ids 键，按 BetterQuesting 任务 id 建立索引。
  2. 新增两个标签：<QuestLink>（行内）与 <QuestCard>（块级）。
  3. 标准“打开指南”快捷键在 BetterQuesting 任务 GUI 中悬停某任务时也能生效：按住快捷键即可按任务 id 跳转到对应指南页。

按任务 id 索引页面

在希望与某个或多个任务关联的指南页 frontmatter 中添加 quest_ids 列表：

---
navigation:
  title: 第二阶段 — 蒸汽时代
quest_ids:
  - 01234567-89ab-cdef-0123-456789abcdef
  - AAAAAAAAAAAAAAAAAAAMug==
---

值可以是标准 UUID 字符串，也可以是 BetterQuesting 的紧凑 Base64 quest id。格式错误或为空的条目会被跳过并在日志中警告。

GuideNH 会优先按紧凑 quest id 解码，失败后再回退到标准 UUID 解析。这与 BetterQuesting 使用的 AAAAAAAAAAAAAAAAAAAMug== 这类 quest id 格式兼容。

不要在同一页面的 quest_ids 中同时写入同一个任务的两种编码；它们会归一化成同一个内部 UUID，并被视为重复项。

一旦某个任务 id 被某页索引，<QuestLink> 与 <QuestCard> 的点击行为会改为跳转到该指南页，而不是直接打开 BetterQuesting 的任务 GUI。

从 BetterQuesting 描述链接到 GuideNH 页面

BetterQuesting 任务描述可以通过 [guide] 标签跳回 GuideNH 页面。该标签只在 BetterQuesting 已加载时由 GuideNH 解析，并会转成 BetterQuesting 原生的 hyperlink-aware 文本框渲染，因此 BQ 自己的换行、滚动和点击热区仍保持兼容。

目标写页面 ID：

[guide]guidenh:navigation-guide[/guide]

如果目标页面存在，显示文本会替换为该指南页面的标题。.md 后缀可省略，因此当 guidenh:navigation-guide.md 存在时，guidenh:navigation-guide 也会指向它。

需要自定义显示文本时使用 page=：

[guide page=guidenh:navigation-guide]打开导航指南[/guide]

该链接会使用 BetterQuesting 原生链接的蓝色与下划线样式，鼠标悬停时显示 GuideNH tooltip，点击后打开目标 GuideNH 页面。也支持页面锚点：

[guide page=guidenh:navigation-guide#navigation-fields]导航字段[/guide]

<QuestLink> 与 <QuestCard>

两个标签都通过 id 接收 BetterQuesting 任务 id，并在编译时根据玩家进度决定外观：

状态 来源 渲染
可见 任务已解锁但未完成 普通可点击链接
完成 quest.isComplete(player) 返回 true 可点击链接，绿色，末尾追加 ✓
锁定 任务存在但未解锁，可见性不为 HIDDEN/SECRET 仍然是可点击的任务链接 / 任务卡片标题，会打开 BetterQuesting 或跳到索引页
隐藏 锁定且可见性为 HIDDEN 或 SECRET 深灰斜体占位符，不泄露任务信息
缺失 任务 id 在数据库中找不到对应任务 红色斜体占位符

对可见 / 完成 / 锁定状态，点击目标的优先级为：

  • 若任务 id 出现在某页的 quest_ids 中，则跳转该指南页
  • 否则按 BetterQuesting 原生的父界面链打开任务书中的任务界面

属性表与示例参见 标签参考。

隐藏任务的处理

GuideNH 永不渲染处于 HIDDEN 或 SECRET 状态且仍处于锁定的任务的标题与描述。占位文本采用翻译键，便于整合包做本地化：

翻译键 中文默认
guidenh.compat.bq.locked 未解锁任务
guidenh.compat.bq.hidden 隐藏任务
guidenh.compat.bq.missing 未知任务
guidenh.compat.bq.open_in_guide 在指南中打开

锁定但非隐藏的任务，在 <QuestLink> 以及 <QuestCard> 的可点击标题上仍可显示描述 tooltip，这与 BetterQuesting 自身在锁定任务 tooltip 中暴露描述的行为一致。可通过 show_tooltip="false"（或 showTooltip={false}）关闭该 tooltip；隐藏任务不会暴露任何 tooltip。

Note

任务状态在页面编译时根据本地玩家进度解析。编译结果按指南缓存；解锁或完成任务后重新打开指南会重新评估状态。

“打开指南”快捷键集成

默认打开指南快捷键（G，可在 key.guidenh.open_guide 中重新绑定）在 BetterQuesting 加载时获得第二种触发路径。当 BetterQuesting 任务图 GUI 打开时：

  1. 鼠标悬停在面板中的某个任务按钮上
  2. 按住打开指南快捷键

若任意已注册指南通过 quest_ids 索引了该任务 id，GuideNH 将跳转到对应页面（如果指南尚未打开则同时开启）。若没有任何页面索引当前悬停的 id，则快捷键不会执行任何操作 —— 不会回退到打开 BQ 任务 GUI，因为这恰好是 BQ 已经展示的内容。

该路径独立于物品 tooltip 触发流，背包内悬停物品仍按既有的物品 / 矿辞索引流程处理。

BetterQuesting 缺席时的行为

  • <QuestLink> 与 <QuestCard> 不会注册；使用了它们的页面会以标准“未知标签”错误形式呈现，直到你移除这些标签。
  • quest_ids 仍会被解析并存入 additionalProperties，但不会被读取。
  • 快捷键的任务悬停分支变为空操作。
  • BetterQuesting 描述中的 [guide]...[/guide] 链接不会被解析，因为 BetterQuesting 文本框和相关 mixin 都不会加载。

这意味着面向 BetterQuesting 的指南只需编写一次，即可在没有 BetterQuesting 的环境下静默降级。

GuideNH Wiki

English

中文

Clone this wiki locally