千里寻踪 Trace-Seeker

QianLi XunZong

一个定点定位的世界探索实用工具模组：输入或选择目标结构/生物群系。点击搜索按钮进行定位，返回精确坐标和距离，并可一键传送至目的地。其突出特点是对整合包中其他模组的内容进行自动识别和本地化，开箱即用，无需联网。

1. 核心玩法

合成物品：在工作台使用桦木原木 + 紫水晶等配方合成 QianLi XunZong 物品。配方通过模组内置进度添加至配方书，加入世界时解锁。

打开界面：手持该物品并右键点击，打开 QianLi XunZong 搜索界面。单人游戏中游戏会暂停，与暂停菜单一致。

追踪流程：切换到 结构 / 生物群系 标签页 → 从列表中选择一个条目或在搜索框中输入目标 → 点击追踪。八卦罗盘指针会动态旋转指向目标。结果面板显示中文名称、X/Y/Z 坐标和距离。点击下一个可在范围内查找同类型的下一个实例（按半径依次迭代）。定位后，点击传送直接跳转到目标。传送逻辑经过优化，防止因卡在方块内而受到窒息伤害。搜索半径：待定。

2. 界面功能

三个标签页：结构 / 生物群系 / 历史记录。历史记录条目可重新查看并传送。智能搜索框：支持四种输入类型的筛选：中文名称、英文名称、拼音、来源模组 ID。示例：搜索 infested temple 可匹配 dungeons_arise:infested_temple。搜索中文模组名称（例如 Iron Spells、Dungeons Arise）或其模组 ID（例如 irons_spellbooks）可列出该模组的所有结构/生物群系。按维度分组：列表顺序为主世界 → 下界 → 末地 → 自定义维度。自定义维度不会被错误归类为主世界。八卦罗盘 + 结果面板：指针平滑旋转指向目标。结果以中文居中对齐，并自动换行。

3. 自动识别与本地化（重点功能）

该模组的翻译层 AutoNameResolver 会自动为整合包中所有模组的结构和生物群系分配可读名称，解析优先级如下：

1. 手动配置的自定义中文名称
2. 来源模组提供的内置本地化名称
3. 内置词库（整理自 wiki 资源）如果以上均不可用，则回退到原始注册名。所有处理均在离线运行，无需在线翻译服务。

4. 自动维度检测（兼容添加维度的模组）

当安装了维度扩展模组时（例如 Twilight Forest、The Abyss、自定义维度包），其结构和生物群系可以被正确分类。不保证与所有模组完全兼容；维度名称也将自动本地化。

5. 附加功能

HUD 投影：手持 QianLi XunZong 物品时，HUD 显示上次追踪结果和实时距离，供旅行途中参考。性能友好：目标列表仅在打开界面时向服务器请求一次数据；后续的罗盘计算和显示完全在客户端运行。多区块 / 多人游戏支持：搜索请求通过网络数据包发送并在服务端处理，在多人世界中完全可用。