定位更多

定位更多

寻找最近的 N 个结构、生物群系或 POI,而不仅仅是最接近的那个。精确距离排序,完全异步:服务器持续运行。同时修复原版 /locate 无法返回真正最近目标的问题 (MC-138887)。

优化

查找距离最近的 N 个结构、生物群系或 POI,而不只是最近的那一个。 严格按距离排序。服务器持续运行,不会卡顿。

/locate structure minecraft:mansion 20
/locate biome minecraft:mushroom_fields 3
/locate poi #minecraft:village 5

原版 /locate 会阻塞服务器线程,且只返回一个结果,而这个结果并不总是最近的。LocateMore 为原版命令增加了一个可选的数量参数,范围 1 到 100,并将原版自身的最近结构搜索接入同一引擎,因此普通 /locate、末影之眼、探险家地图和其他模组也能得到真正最近的结果,同时不会阻塞 tick。结果按由近到远流式输出到聊天栏,每行都可点击传送,Boss 栏显示进度。

为什么快

原版会螺旋向外扩展并重复检查重叠区域。LocateMore 从种子出发:种子决定了每个结构可能生成的唯一区块,引擎按真实距离顺序精确遍历这些候选区块,并用与原版相同的检查逐一验证。未生成地形中的候选通常可以通过纯数学确定(使用与真实生成相同的生成点数学和加权集合抽取,每一项都先经过裁判验证才被信任,若裁判在任何时候不一致,则该会话内撤销信任),因此无需加载或生成区块。结果与原版一致;只是数量更多、速度更快。

实测(发布构建、全新世界、种子 20260821、数量 20;warm 表示再次执行相同搜索):

结构 冷启动 热启动
mansion 1.7 s 0.06 s
ancient_city 0.10 s
monument 1.5 s
jungle_pyramid 3.7 s 0.10 s
#village(标签,多集合) 0.17 s
fortress(下界,多集合) 0.04 s

同一世界中,原版:20 个中有 13 个导致 10 秒的 tick 阻塞。每个发布版本在发布前都会在两个受支持的版本上与真实生成逐坐标对比(test/run-both.sh)。

生物群系和 POI

/locate biome 使用与原版相同的网格和相同的气候采样器进行采样,但在非主线程执行并严格按距离排序(原版的螺旋只是近似最近)。N 个结果对应 N 个不同的斑块:与已接受结果距离小于 biomeSeparationBlocks(默认 512)的命中会被抑制。默认半径为 12800,是原版的两倍,因为额外范围是纯数学计算。

/locate poi 搜索所有已探索地形,而非原版的 256 格半径,在非主线程读取 poi 存储,且不会像原版查询那样将 poi 数据固定在内存中。POI 是世界状态,因此无法搜索未探索地形;尚未写入磁盘的内存更改会被包含在内,命中结果在打印前会与实时内存重新核对。

面向其他模组的 API

LocateMoreApi.findNearest(level, structures, origin, 5).thenAccept(result -> {
    for (LocateMoreApi.StructureHit hit : result.hits()) {
        // hit.pos(), hit.structure(), hit.distance()
    }
});

com.rasmus.locatemore.api 是契约;其他所有包均为内部实现。在服务器线程调用;future 也在该线程完成,命中结果严格按距离排序,并带有 complete 和 orderingGuaranteed 标志以表示预算截断和未解析的情况。SearchOptions 可按调用降低预算、关闭区块生成(mathOnly()),以及排除之前的命中。

限制

  • 普通 /locate 有意返回真正最近的结果,而原版有时并非如此(MC-138887)。如需与原版完全一致(速通练习、种子工具):每个世界可实时切换 /gamerule locatemore:exact_locate false;config/locatemore.json 中的 improveVanillaLocate 是服务器范围的开关。
  • 未生成地形中的多集合结构需要将其候选区块生成到第一阶段,与原版 locate 完全一样;每次探测会向存档增加 4 到 12 KB,摘要会报告数量。单集合结构永远不需要探测。
  • 搜索状态不会跨会话保留;数据包重载会中止正在运行的搜索并清除会话备忘。标记是刻意的例外:它们是玩家自身数据中的书签,永远不会作为搜索结果的输入。
  • 默认边界:1,000,000 格半径、60 秒实际耗时、50,000 次候选检查、2 个并发搜索。部分结果会明确说明。所有这些都在 config/locatemore.json 中配置。

命令

命令 作用
/locate structure <id|#tag> <count> [min_distance] 异步搜索,流式输出最近的 N 个(可选至少在该距离之外)
/locate biome <id|#tag> <count> [min_distance] 异步生物群系搜索,N 个不同斑块
/locate poi <id|#tag> <count> [min_distance] 在所有已探索地形上异步搜索 poi
/locate near structure|biome <a> structure|biome <b> [radius] 距离最近的 a,且其半径内(默认 512)存在 b,例如沙漠旁的村庄(混合对时结构在前)
/locate mark <name> / /locate marks / /locate unmark <name> 保存你所在的位置 / 列出标记 / 删除标记;每行都有与搜索结果相同的可点击坐标和按钮,死亡时会自动标记 death(配置中的 deathMark 可服务器范围关闭此功能)
/locate track <mark|x y z name> 在动作栏显示实时距离和箭头,自动清除
/locate compass <mark|x y z name> 指向该位置的命名指南针
/locate verify <structure> 漂移检测:在 20 个区块上与原生解析对比
/locate prune 删除空区域文件(原版的扫描路径仍会留下它们,MC-311323)
/gamerule locatemore:exact_locate 每个世界切换原版调用点的行为

需要管理员权限,与原版 /locate 相同。每个子命令也存在于 /locatemore 下,该别名可供权限模组(LuckPerms 等)逐节点授予:locatemore.track、locatemore.compass、locatemore.mark、locatemore.prune、locatemore.verify、locatemore.near(原版 /locate 根命令要求 op 等级 2 才会查询任何子命令)。结构标签和所有维度均可用。专用服务器上的原版客户端看到正确的输出,因为每一行都使用原版翻译键。

版本

一个 jar 可在 26.1.2 和 26.2 上运行。Fabric,需要 Fabric API。MIT 许可证。服务端:安装在服务器上,原版客户端即可获得全部功能;单人游戏中,客户端安装即可。