/locate

/locate

来源：Commands/locate；原文修订 ID：3784532。

权限等级：Java 版为 2，基岩版为 1；基岩版需要启用作弊。

在执行命令的玩家聊天中显示距离最近、属于指定类型的已生成结构或生物群系的坐标。Java 版也能显示最近的兴趣点；原文将基岩版相关功能标记为即将推出。

用法

/locate structure ... 查找结构时忽略结构的垂直坐标。Java 版的水平搜索范围为结构间距的 201 × 201 倍，间距值见默认结构集。例如林地府邸间距为 80 区块，故可搜索至正负 128000 方块后才失败。要塞等同心环结构没有固定最大距离。同一结构集中的结构大致按曼哈顿距离排序；一个错误使间距较大的结构优先于其他结构，因此找到的结构未必最近（MC-138887）。

/locate biome ... 的水平搜索分辨率为 32 方块、垂直分辨率为 64 方块，过窄的生物群系可能找不到。Java 版水平搜索范围为 12801 × 12801 方块；基岩版范围原文仍缺少资料。

Java 版 /locate poi ... 搜索半径 256 方块的球体。

成功定位结构或兴趣点时，聊天显示 The nearest <requested thing(s)> is at [<x> ~ <z>] (<distance> blocks away)；<distance> 为执行者到目标的水平距离。定位生物群系时显示 The nearest <requested biome(s)> is at [<x> <y> <z>] (<distance> blocks away)；距离为执行者到生物群系的空间距离。

Java 版可以点击这些消息中的坐标，将 /tp @s <x> ~ <z> 填入聊天框，再执行以传送到该处。Java 版命令由函数运行时不显示这条消息（MC-298295，按预期工作）。

语法

Java 版

  • /locate structure <structure>。
  • /locate biome <biome>。
  • /locate poi <poi>。

基岩版

  • /locate structure <structure: Structure> [useNewChunksOnly: Boolean]。
  • /locate biome <minecraft: Biome>（保留原文语法中的参数名称）。

参数

  • Java 版 biome（resource_or_tag）／基岩版 biome: Biome（枚举）：要定位的生物群系。Java 版也接受生物群系标签，使用 minecraft:worldgen/biome 注册表。
  • Java 版 structure（区分大小写，resource_or_tag_key）／基岩版 structure: Structure（枚举）：要定位的结构；Java 版使用 minecraft:worldgen/structure 注册表，参见生成结构的数据值。
  • 仅基岩版 useNewChunksOnly: Boolean：是否仅在新区块中定位结构，true 为是、false 为否，默认为 false。
  • 仅 Java 版 poi（resource_or_tag）：要定位的兴趣点，使用 minecraft:point_of_interest_type 注册表。其资源位置如下。
兴趣点 ID
高炉 armorer
蜂巢 bee_nest
蜂箱 beehive
烟熏炉 butcher
制图台 cartographer
酿造台 cleric
堆肥桶 farmer
木桶 fisherman
制箭台 fletcher
床 home
炼药锅 leatherworker
讲台 librarian
避雷针 lightning_rod
磁石 lodestone
切石机 mason
钟 meeting
下界传送门 nether_portal
织布机 shepherd
锻造台 toolsmith
砂轮 weaponsmith

该参数还支持兴趣点类型标签：

标签 包含项目
#acquirable_job_site armorer、butcher、cartographer、cleric、farmer、fisherman、fletcher、leatherworker、librarian、mason、shepherd、toolsmith、weaponsmith
#bee_home bee_nest、beehive
#village #acquirable_job_site、home、meeting

结果

命令不完整或任意参数不正确时无法解析；生物群系和兴趣点的资源位置或标签无效也属于无法解析。

  • locate structure ...：Java 版结构资源位置或标签无效时失败；基岩版对此视为参数不正确。指定结构不在当前维度生成，或在结构间距 201 × 201 倍的正方形范围内无法定位目标时失败；基岩版对应范围仍需测试。
  • locate biome ...：在 12801 × 12801 方块范围内无法定位生物群系时失败；基岩版对应范围仍需测试。
  • locate poi ...：在半径 256 方块的球体内无法定位目标兴趣点时失败；不适用于基岩版。
  • 其他情况成功。

输出

Java 版失败时成功次数、success、result 均为 0。成功时成功次数与 success 为 1；结构或兴趣点的 result 为执行者到目标的水平距离，生物群系的 result 为执行者到目标生物群系的距离。基岩版失败成功次数为 0，成功为 1。

示例

  • 最近林地府邸：/locate structure mansion。
  • 仅在新区块寻找最近掠夺者前哨站（基岩版）：/locate structure pillager_outpost true。
  • 任意类型的最近村庄：Java 版 /locate structure #village；基岩版 /locate structure village。
  • 最近沙漠：/locate biome desert。
  • 最近的村民使用兴趣点（Java 版）：/locate poi #village。

外部链接

中文翻译/改编自 Minecraft Wiki 原条目，原文作者可由页面历史查看；译文遵循 CC BY-NC-SA 3.0（署名、非商业性使用、相同方式共享）。