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 <name> 会读取 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 <count>。
• poi.poiSearchRadius — 搜索兴趣点时使用的最大半径。

使用方法

1. 在服务器上安装 Locate Fixer（客户端也可以安装，建议安装以确保聊天消息一致）。
2. 照常运行 /locate 或 /locate biome。进度消息会显示当前正在扫描的半径。
3. 随后即可使用 /tp；模组会预加载目标区域，并在目标区块加载完成后安全地传送你。
4. 将 .schem 文件放入 config/worldedit/schematics/，即可通过 /locate schematic <name> 查找它们。
5. 仅限开发者：你可以将自己添加的、并非由数据包生成的结构注册到定位命令中；请使用我们的 API，API 文档请参阅源代码。

兼容性

• NeoForge 1.21.1
• 没有硬性前置依赖
• 设计上可与优化模组以及结构和世界生成内容包共存

无论你是在寻找一种稀有生物群系、确认某个结构是否生成，还是在模组服务器中带领新玩家探索，Locate Fixer 都能让定位流程从头到尾保持快速、信息清晰且安全。