自动记录你发现的资源和地点，追踪可再生资源的刷新，标记已完成的副本，并添加一个带星级筛选的实时生物雷达。这是《英灵神殿》的客户端模组。

轨迹账本

版本 0.6.1

TrailLedger是一款客户端《英灵神殿》探索与地图工具，能够自动记录你发现的实用资源和地点，保存可再生资源的可用信息，并提供可配置的实时生物雷达。

它记录你的客户端在已探索地形附近遇到的事物。它不会扫描未探索的世界数据，也不会揭示远处未加载的生物。

功能

自动发现

正常探索即可记录附近受支持的资源与有用地点。发现按世界存档保存，支持去重，并可配置遭遇距离。可在地图全览中预览发现半径、将附近同类资源分组，并选择要显示的标记。隐藏标记不会删除其发现记录。

类别	支持的发现
矿石	铜，锡，银，焰金
采集	树莓、蓝莓、云莓、蘑菇、黄色蘑菇、蓟、巨人菇、法师菇
种子	胡萝卜种子，芜菁种子
地下城	埋葬室、沉没墓穴、冰霜洞穴、虫害矿坑
其他	利维坦、苏特林生成器、灰矮人巢穴

资源地图筛选

使用分类筛选、单独的资源图标开关， 显示全部, 全部隐藏 以及全地图上仅分类的预设。保存的偏好设置会同时应用于全地图和小地图。

树莓 ×5 表示一个标记代表五个单独记录的附近树莓位置。每次发现都保留自己的位置和可用状态。组标签还可以显示有多少成员已确认可用。切换 工具 → 附近资源分组 在分组标记和单个标记之间切换。地下城入口始终保持独立。

可再生资源追踪

当TrailLedger观察到已知可再生资源被采集时，其位置仍会被记录。一个环形冷却指示器环绕其正常 全彩图标 当有可靠的运行时重生时长可用时。在全地图上选择标记以查看剩余的已知活跃时间和可用性详情。

TrailLedger只统计它确知的、你在该世界中游玩时处于活跃状态的刷新时间。登出、离线时间和暂停的游戏进程不会推进它的估算。这是有意为之，避免仅仅因为你离线了几个小时就告诉你资源已就绪。如果你重访时资源已经刷新，TrailLedger会立即自我修正。

过期估算在资源被观察到之前保持未确认状态。首次遇到且未知采集时间的空资源，其剩余时间为未知，而非虚构的倒计时。附近的实际游戏状态优先于估算。分组资源保留各自的计时器；详情显示下一个已知的倒计时。

生物雷达

启用 生物 → 显示生物雷达 显示附近已加载的生物。雷达默认关闭。

• 展开已解锁的生物群系标题，使用 + / −精心整理的目录将每个原版逻辑生物分配到唯一的标准生态区。突袭、入侵和特殊地点生成的生物不会改变其菜单位置。特殊生物仍归在次级分类下 特殊 / 地下城 标题。
• 敌人 涵盖所有未驯服的生物，包括野生动物和首领。 驯服 驯服后控制相同的生物类型。Boss是生物行上的元数据。
• 点击生物的运行时刻奖杯图标或名称即可启用/禁用。勾号表示已启用；斜杠表示已禁用。图标仍可辨认。当没有可用奖杯时，将回退使用原始类别图像。
• 每一行都有各自的最低星级控制： 任意 → 1★+ → 2★+ → 3★+ → 任意，当引用的定义使用更高等级时，会进一步延伸。星级等于等级减一。模组玩法允许更高的阈值；这并不意味着原版生物能自然拥有那么多星级。
• 启用所有生物类型, 禁用所有生物类型，以及生物群系 显示 / 隐藏 在不重置星级要求的情况下更改可见性。雷达主控和敌人/已驯服开关保持独立。

例如，设置 洛克斯 = 3★+ 和 死亡蚊子 = 任意 同时。隐藏并重新启用Lox仍保留其3★需求。后代、装备和睡眠变体共享逻辑生物过滤器。运行时雷达在生物的标准生物群系之外仍然有效。现有的星级值和星级控制循环保持不变，包括当目录条目移动时。

草甸始终可用。其他生物群系标题会在其前置Boss被击败后解锁 或 你亲身进入该生物群落后即可解锁。海洋和已命名的模组生物群落在进入时解锁。其他/模组生物群落仍可用于未分类的条目。解锁状态会为当前世界保存，且永远不会重新锁定。特殊/地牢会随其父级生物群落一同解锁。此菜单限制不会在地理上限制雷达。

正常启动会读取已编译的原版列表，并且 生物图鉴.json它不会扫描每个生成表、地点、地下城、团队副本或角色预制体。未知的有效模组生物会在遇到时被缓存，并使用首次遭遇时的生物群系。不确定的定义使用其他/模组。游戏或模组变更会将缓存标记为可能过期，但不会自动重建。图标和生物行会按需为展开区域或雷达创建，然后在该会话中缓存。

下方 设置 → 生物图鉴，使用 重建整个生物图鉴 更换生物模组后，确认提示会警告：检查已注册定义时可能出现卡顿。按生物群系重建仅验证该类别缓存的动态条目。 重建当前生态群系 同时会考虑附近的生物。这些定向操作绝不会回退到全局扫描。资源发现和现有生物偏好会被保留。侧边栏在当前画布坐标系中填满地图的可用高度，并带有上下边距。导航保持固定，而各分区内容可滚动。拖动或点击滚动条，或使用滚轮，每次大约滚动一行。悬停在TrailLedger上时，地图滚轮处理程序会被抑制，在其外部则保持不变。分区滚动位置会在会话期间被记住；生物群系展开状态会被保存。资源行使用相同的图标/勾选/斜杠控件，数量显示在单独的非切换区域中。生物位置是 仅限直播 并且是 从未保存 在持久发现数据库中，死亡、未加载或超出范围的生物会从雷达上消失。TrailLedger使用玩家亲自探索过的地形和同一室内环境中本地已加载的角色；它不会搜索远处或未加载的实体。

银与许愿骨

新发现的银矿需要激活的许愿骨探测效果以及正常的距离和探索资格。此前已发现的银矿在卸下许愿骨后仍会被记住。

地下城

地下城入口会被持续记录并单独追踪。 地下城 → 追踪地下城内的资源 默认关闭。这样可以防止像 Burial Chambers 这样的地点用黄色蘑菇发现物填满地图，除非你明确想要显示这些信息。

该偏好会抑制在原版分类的室内区域中新发现普通资源。它不会隐藏入口或清除已记录的资源。入口旁的地表资源仍可被发现。不属于《英灵神殿》原生室内分类的自定义室内区域可能无法被识别。

已完成地下城

在全地图上左键点击TrailLedger地牢标记以打开 详情，然后选择 标记为已完成. 普通副本图标会显示一个明显的对勾标记和“已完成”标签。选择 标记为未完成 将其逆转。

或者，打开 地下城 → 浏览已发现的地下城… 并选择一个入口。地图会将其居中并打开相同的详情控制项。列表中包含较早的发现以及被可见性过滤器隐藏的入口，因此无需重新发现。

显示已完成 和 显示未完成 它们是独立过滤器，默认均开启。完成状态在会话之间持续保留。它仅为个人TrailLedger元数据，绝不会更改实际地下城或Valheim世界存档。

引脚标签

使用 设置 → 图钉标签 切换 两张地图 （默认）， 仅全地图 和 隐藏仅更改TrailLedger名称；计数、星级、可刷新计时器和地下城完成徽章仍然可见。

探索半径

打开 设置 → 发现半径 并使用 − 5m / + 5米设置会立即保存。其最小值为 5分钟, 默认 20分钟，以及最大 50米.

更改半径，或者选择 预览，在全地图上以你的玩家为中心显示一个临时的金色圆圈。它会跟随地图缩放和移动，持续八秒，并随设置面板或地图关闭而消失。该圆圈显示3D遭遇距离的水平范围；垂直距离仍然有影响。

设置 → 生物雷达半径 使用相同的控制和预览，至少 10分钟，默认 80米，以及最多 150米.

客户端模组

TrailLedger 在你的客户端上运行。专用服务器无需安装 TrailLedger，其他玩家也无需安装。它存储自己的发现元数据，不会直接修改 Valheim 世界存档，也不会将你的发现同步给其他玩家。

安装

Thunderstore / r2modman

安装 拉西顿·追踪账簿 通过Thunderstore或r2modman安装。兼容Thunderstore的管理器会自动安装所声明的依赖项。从该模组配置文件中启动英灵神殿。

手动安装

1. 安装 BepInExPack 英灵神殿 5.4.2350 和 尤顿 2.30.0.
2. 关闭 Valheim 后，复制 plugins/TrailLedger.dll 从ZIP压缩包中解压到 BepInEx/plugins/TrailLedger/ 在您的英灵神殿安装目录下。
3. 请将随附的许可证和第三方声明与您的本地副本一并保留。删除重复的旧版TrailLedger DLL文件，然后通过BepInEx启动。

经过测试的清单依赖项确切如下：

• denikson-BepInExPack_Valheim-5.4.2350
• 瓦尔德海姆模组开发-Jotunn-2.30.0

依赖 DLL 未包含在 TrailLedger 的包中。

用途

1. 安装TrailLedger后启动英灵神殿，正常探索即可。
2. 正常打开完整地图 M.
3. 打开 探索记录 · 发现.
4. 选择资源类别和可见性，或在下方启用雷达 生物 → 显示生物雷达.
5. 为详情选择标记，包括资源倒计时和副本完成情况。
6. 使用 设置 用于发现/雷达半径和 工具 用于分组和标记维护。

工具 → 重建 TL 标记 重建TrailLedger的持久标记层，同时保留发现记录、地牢完成状态、计时器和偏好设置。实时雷达单独进行校准。普通手动标记不受影响。

工具 → 高级… → 清除此世界的TrailLedger发现记录… 确认并备份后，仅删除当前世界的TrailLedger记录。Discovery随后暂停，直到 继续探索 或下一场会话。其他世界和筛选偏好保持不变。

数据和配置

路径相对于当前激活的英灵神殿安装目录或模组管理器配置文件：

文件或文件夹	用途
BepInEx/config/au.astra.trailledger.cfg	BepInEx设置，包括探测/雷达半径和分组
BepInEx/config/TrailLedger/world-<UID>.json	每个世界的发现、可刷新状态及地牢完成度
BepInEx/config/TrailLedger/creature-catalog.json	版本化动态生物缓存及游戏/模组指纹
BepInEx/config/TrailLedger/filters.json	资源/生物可见性选项、运行时生物目录、各类型最低星级和界面偏好

备份整个 BepInEx/config/TrailLedger/ 用于保存个人发现和筛选条件的目录，以及 .cfg 配置文件。数据按世界存储，由使用相同安装/配置文件的角色共享。生物类型名称和选择可以保存，生物位置无法保存。

旧版 schema-1 发现会自动迁移，并将原始内容保留在 .前-0.4.备份 文件。待处理的更改会定期保存，并在正常退出时保存；崩溃可能会丢失最新的未保存更改。共享前请检查发现文件，因为它们包含位置和世界标识符。

来自开发版本的按生物星级设置将被保留。规范的显式偏好优先于别名冲突；仅有别名的配置会复用其原始偏好键和值。未使用的别名设置仍会保留。

升级旧版0.4过滤器时，原始文件会备份为 filters.json.pre-0.5-<timestamp>.bak全球最低星级设置已取消；每个生物初始为 任意现有的显式类型选择和资源选择保持不变。在没有显式类型选择的情况下，隐藏的旧版家族将并入已知类型可见性中。敌人现在涵盖所有未驯服的生物；迁移后请检查该开关。

用于诊断，请使用 拖尾账本统计 在控制台中或启用 详细日志地下城列表还提供 诊断点击问题（2分钟） 用于临时交互记录。

兼容性

之前的 0.4.0 版本已在 Valheim 1.0.12、BepInEx 5.4.23.5（打包版本 5.4.2350）和 Jötunn 2.30.0 环境下进行了游戏内测试。0.4.0 的资源计时器、全彩图标、奖杯雷达、生物筛选/星级以及地下城完成流程均已在游戏中确认无误。

它的设计初衷是与原版或手动放置的地图标记共存。如果另一个模组独立添加了资源或生物标记，可能会出现视觉信息重复；地图界面模组也可能导致控件重叠。无法保证与所有地图模组兼容。

发现需要已加载的对象和亲自探索，不进行视线检测。不可再生资源、生成器和利维坦在耗尽或消失后仍可保留记录。群组中心点为近似位置，渲染标记数量限制可能会隐藏部分远处记录，但不会将其删除。控制器导航和本地化尚未实现。

Bug 反馈与建议

Bug 与建议：消息 拉西顿 在Discord上。

请包含你的游戏/模组版本、相关日志信息和复现步骤。分享日志或数据前请移除个人信息。

AI辅助开发

TrailLedger 的开发大量使用了 AI 辅助编码和测试。其模组包图标也是 AI 生成的；Thunderstore 页面使用的是 AI生成 类别。

制作人员

TrailLedger：Astra / TrailLedger 贡献者。源代码和原始几何类别艺术作品均依据 MIT 许可证发布。

感谢BepInEx、Jötunn、HarmonyX和Json.NET的贡献者。Valheim及其运行时美术素材归Iron Gate及其各自权利人所有。游戏物品栏和奖杯精灵图仅在运行时调用，从未提取或打包。详见 第三方声明.md 关于依赖声明和美术作品来源。