Locate Fixer

定位修复器（Locate Fixer）

定位修复器（Locate Fixer）是一个适用于 NeoForge 1.21.1 的轻量级生活质量模组，旨在让 Minecraft 的 /locate、/locate biome 和 /tp 指令对玩家、服务器管理员及整合包作者更加可靠。该模组在原版放弃搜索后仍会继续寻找，将进度实时流式输出到聊天栏，并确保传送到结果位置的安全性，即使在繁忙的服务器上也是如此。在 2.1.1+ 版本中，当在丘陵生物群系或洞穴生物群系中传送时，您不再会卡在方块中，但请小心熔岩。如果您确实卡住了，请提交问题反馈。

亮点

• 递增搜索半径。 定位环从 6,400 格范围逐步提升至 256,000 格，使得遥远的建筑和模组生物群系变得实际可寻。
• 异步定位工作线程。 扫描在后台线程池中运行，主服务器线程保持响应，玩家移动不受影响。
• 智能缓存。 最近找到的建筑和生物群系会被缓存，并可在附近请求时即时复用，避免重复扫描。
• 更安全的传送。 对定位结果执行 /tp 时会预加载目标区块，显示 5 秒倒计时，并仅在一切就绪后才移动玩家。此外，它还使用光线投射来寻找落点，使您不会卡在方块之间。
• 原理图辅助。 /locate schematic <名称> 可接入 WorldEdit 的 config/worldedit/schematics 文件夹，便于重新访问自定义建筑。

配置

定位修复器（Locate Fixer）可通过生成的 config/locatefixer-server.toml 文件进行配置。

• locate.locateRings — 有序的搜索半径（以方块为单位）列表。您可以缩小或扩大搜索上限以适应您的世界大小。
• locate.locateThreadCount — 处理建筑和生物群系扫描的异步工作线程数（1-8）。
• locate.cacheDurationMinutes — 定位结果在过期前的缓存时长。
• locate.cacheChunkGranularity — 缓存结果可在原始请求周围复用的广泛程度。
• locate.biomeSampleRadiusMultiplier 和 locate.biomeSampleStepMultiplier — 调整生物群系采样密度，以实现更快或更精确的生物群系扫描。
• locate.enableNearestCommand — 启用 /locate nearest structure|biome <数量> 指令。
• poi.poiSearchRadius — 扫描兴趣点时的最大半径。

使用方法

1. 在服务器上安装定位修复器（Locate Fixer）（客户端安装为可选，但推荐以保持聊天消息一致）。
2. 照常运行 /locate 或 /locate biome。进度消息会显示当前正在扫描的半径。
3. 随后立即使用 /tp；模组会预加载目标区域，并在区块加载完成后安全传送您。
4. 将 .schem 文件放入 config/worldedit/schematics/ 文件夹，即可通过 /locate schematic <名称> 发现它们。
5. 仅限开发者：您可以通过我们的 API 添加非数据包生成的自定义建筑，并将其注册到定位指令中。请查看源代码以获取 API 文档。

兼容性

• NeoForge 1.21.1
• 无硬性依赖
• 旨在与优化模组以及建筑/世界生成内容包共存

无论您是在寻找一个稀有的生物群系、确认建筑是否生成，还是引导新玩家穿越模组服务器，定位修复器（Locate Fixer）都能让定位工作流程从始至终保持快速、信息丰富且安全。