命令/locate

locate

需要的权限等级	2^[仅Java版] 1^{[仅基岩版]}
限制条件	启用作弊^{[仅基岩版]}

在聊天框中为命令执行者显示给定类型结构、生物群系^{[新增：JE 1.19]}或兴趣点^{[新增：JE 1.19]}的最近坐标和距离。在Java版中，返回的坐标可以点击以自动在聊天框中输入/tp @s 坐标。

语法[]

locate <structure>^{[失效：JE 1.19]}

locate biome <biome>^{[新增：JE 1.19]}

locate poi <poi>^{[新增：JE 1.19]}

locate structure <structure>^{[新增：JE 1.19]}

locate <feature: Feature> [useNewChunksOnly: Boolean]

JE: biome^{[新增：JE 1.19]}

指定要定位的生物群系的命名空间ID或生物群系标签。参见生物群系/ID及标签#生物群系以查看所有可用的生物群系ID和生物群系标签。

JE: poi^{[新增：JE 1.19]}

指定要定位的兴趣点的命名空间ID或兴趣点标签。参见标签#兴趣点以查看所有可用的兴趣点标签。

JE: structure
BE: feature: Feature

指定要定位的结构的命名空间ID或结构地物^{[失效：JE 1.19]}/结构^{[新增：JE 1.19]}标签。参见标签#结构地物^{[失效：JE 1.19]}或标签#结构^{[新增：JE 1.19]}以查看所有可用的结构地物^{[失效：JE 1.19]}或结构^{[新增：JE 1.19]}标签。

在Java版中，此参数区分大小写。

下表列举了原版数据包内所含结构的命名空间ID：

结构名称	Java版	基岩版	所在维度
远古城市 ^{[新增：JE 1.19和BE 1.19.0]}	`ancient_city`	`ancientcity`	主世界
埋藏的宝藏	`buried_treasure`	`buriedtreasure`	主世界
末地城	`end_city`	`endcity`	末地
下界要塞	`fortress`	`fortress`	下界
林地府邸	`mansion`	`mansion`	主世界
废弃矿井	`mineshaft` `mineshaft_mesa`	`mineshaft`	主世界
海底神殿	`monument`	`monument`	主世界
海底废墟	`ocean_ruin_cold` `ocean_ruin_warm`	`ruins`	主世界
沉船	`shipwreck` `shipwreck_beached`	`shipwreck`	主世界
要塞	`stronghold`	`stronghold`	主世界
沙漠神殿	`desert_pyramid`	`temple`	主世界
雪屋	`igloo`
丛林神庙	`jungle_pyramid`
女巫小屋	`swamp_hut`
村庄	`village_desert` `village_plains` `village_savanna` `village_snowy` `village_taiga`	`village`	主世界
掠夺者前哨站	`pillager_outpost`	`pillageroutpost`	主世界
下界化石	`nether_fossil`	–	下界
堡垒遗迹	`bastion_remnant`	`bastionremnant`	下界
废弃传送门	`ruined_portal` `ruined_portal_desert` `ruined_portal_jungle` `ruined_portal_mountain` `ruined_portal_nether` `ruined_portal_ocean` `ruined_portal_swamp`	`ruinedportal`	主世界下界

BE: useNewChunksOnly: Boolean：bool

仅定位在尚未生成的区块中的结构，默认为false。

必须为布尔值（true或false之一）。

命令	触发条件	Java版	基岩版
任意	参数未正确指定	无法解析	执行失败
任意	当前维度中不生成所请求的对象	执行失败
`/locate ...^{[仅基岩版]}^{[失效：JE 1.19]} /locate structure ...^{[新增：JE 1.19]}`	无法在201×201区块的正方形区域中找到请求的结构^{[需要测试]}
`/locate biome ...^{[新增：JE 1.19]}`	无法在12801×12801方块的正方形区域中找到请求的生物群系		N/A
任意	执行成功时	显示距离命令执行者最近的指定对象的坐标。在Java版中，某些对象的Y轴坐标会显示为`64`。

命令	版本	条件	成功次数	`/execute store success ...`	`/execute store result ...`
任意	Java版	失败	0	0	0
	Java版	成功	1	1	执行者与对象之间的水平距离
	基岩版	失败	0	N/A	N/A
	基岩版	成功	1	N/A	N/A

获得最近的林地府邸的坐标：/locate mansion^{[失效：JE 1.19]}或/locate structure mansion^{[新增：JE 1.19]}
获得最近的沙漠生物群系的坐标：/locate biome desert^{[新增：JE 1.19]}
获得最近的讲台的坐标：/locate poi librarian^{[新增：JE 1.19]}

Java版
1.11	16w39a	加入了`/locate`命令。
1.13	18w06a	`/locate`现在接受之前在`Temple`分组下所有结构的不同名称`Desert_Pyramid`、`Igloo`、`Jungle_Pyramid`、`Swamp_Hut`。
1.13	18w08a	为`/locate`命令输出的坐标添加了可点击的传送链接（将传送指令输入至聊天窗口）。
1.14	18w47a	`/locate`现在接受`Pillager_Outpost`。
1.14	18w48a	`/locate`现在接受`New_Village`。
1.16	20w11a	`/locate`现在接受`Nether_Fossil`。
1.16	20w21a	现在结构名称全部使用小写字母。
1.18.2	22w03a	现在结构名称使用命名空间ID，而不是之前的硬编码值。
	pre1	现在支持标签，用`#`前缀与一般的ID做区分。
	pre1	参数类型由结构类型（Structure Type）改为配置的结构（Configured Structure）。
Java版（即将到来）
1.19	22w19a	将`/locatebiome`作为子命令`/locate biome`并入了`/locate`。
		`/locate`原有的功能由`/locate structure`继承。
		加入了`/locate poi`子命令。
携带版
1.0.0	0.17.0.1	加入了`/locate`命令。
	0.17.0.2	移除了`/locate`命令。
	1.0.0.0	重新加入了`/locate`命令，但仅能用于查找要塞。
1.1.0	1.1.0.0	`/locate`现在可查找其他结构。
基岩版
1.17.30	1.17.30.22	`/locate`现在可用于只查找在未生成区块中的结构。