定位 Plus

Locate Plus

查找任何方块、实体或物品，而不仅仅是结构。可进行扫描、勘测、检查并安全地传送你到目标位置。仅服务端，无需客户端安装。

命令

命令	功能
/lp	游戏内命令列表
/locate block <id|#tag> [<n> chunks|blocks]	最近的匹配方块
/locate entity <id|#tag> [<n> chunks|blocks]	最近的匹配实体
/locate item <id|#tag> [<n> chunks|blocks] [export]	在箱子、地面上、生物身上和玩家身上查找物品
/locate biome|structure|poi <id|#tag>	原版搜索，带有安全传送按钮
/lp inspect <x> <y> <z>	红石、光照、生物生成、农作物、容器、实体数据
/safetp [targets] <destination>	传送到你实际能站立的地方
/glow <target> <n> chunks|blocks	透过地形勾勒实体轮廓
/lp analyze blocks|entities|both [<n> chunks|blocks] [export]	勘测一片区域
/purgeentities <target> [<n> chunks|blocks] [export]	移除实体，并附带日志
/lp visualize <n> chunks|blocks [seconds]	勾勒扫描将覆盖的区域轮廓
/lp stop	停止任何正在运行的扫描
/lp clear [all|both|glow|markers]	清除此模组正在显示的内容
/lp config / /lp reload	显示设置，或重新读取配置文件

默认需要权限等级 2。在大多数命令后添加 forceload 可包含未加载的区块。

须知

省略半径时，命令将覆盖服务器已加载的所有区块，在普通世界中即你周围数百个区块。指定半径时，则精确覆盖该范围。

给出半径时，单位是必需的。 请写 64 blocks 或 4 chunks，绝不要只写 64。仅用复数。两个单位都会被回显，因此不会有歧义。

区块半径是触及距离，而非总数。 4 chunks 扫描向每个方向四个区块内的所有内容，即 49 个区块。20 chunks 触及 20 个区块远，覆盖 1,257 个区块。使用 0 chunks 则只扫描你所在的区块，不含其他。两个单位描述的都是距离，因此方块半径同理，覆盖其所及的任何区块。

半径是水平方向的。 世界的完整高度始终包含在内，因此飞到某物上方高处仍然能找到它。

目标支持 id、标签和选择器。 minecraft:zombie、#minecraft:skeletons、@e、@a、@e[type=minecraft:creeper]。模组 id 在任何命名空间下均可使用。搜索标签时，会分别列出每个匹配类型及其各自的计数和传送按钮。

除非你要求，否则不会强制加载任何内容。 不加 forceload 时，扫描只读取已在内存中的区块，绝不生成地形。被跳过的区块会被计数并报告。

想扫多远都行。 大型扫描会警告开销，然后运行，跨刻切片执行，因此绝不会使服务器卡顿。唯一的限制是 1,000 个区块和 16,000 个方块，这是因为半径描述的是一个圆盘：1,000 个区块已经是 3,141,549 个区块要保持在内存中。

你要找的方块会透过地面发光。 /locate block 会勾勒其最近命中目标的轮廓，因此埋藏的目标从你落地的任何位置都可见，无需跟随方向指引。轮廓是该方块本身按真实大小的副本。内部是普通玻璃，因此你要找的方块仍然是你看到的那个方块。当你挖掘该方块、替换它、一分钟后或执行 /lp clear 时，它会消失。将 block_marker_seconds 设为 0 可取消时间限制，block_marker_fill 可更改其材质，block_marker_colour 可以十六进制代码或染料名称更改轮廓颜色。填充物必须是有模型的方块：屏障、光源和结构空位不会绘制任何东西，因此会被拒绝并在日志中记录。将 mark_located_blocks 设为 false 可完全停止勾勒。

标记是一个显示实体：无碰撞箱、无碰撞、无可走入或击打之物。它以方块的真正大小绘制，略微放大，使轮廓恰好位于真实面的外侧，而不是与之闪烁。附近任何人都能看到它，与 /glow 一样，因为发光是实体状态。服务器停止而未清理时留下的任何标记，在再次加载时会被删除。

传送会将你置于最近的安全位置，并让你面朝目标。台阶、楼梯、路径和浅水都算作可站立之处。聊天中的 [Teleport] 按钮运行 /safetp，因此具有相同的安全检查。若确实无处可站，例如被密封在实心岩石内的位置，你仍会被送到精确位置，并被告知落点未经检查。将 fallback_to_vanilla_tp 设为 false 则会取消传送。

这些按钮有两个开关，因为两类结果不同。方块、实体或物品结果指向真实存在的东西，因此由 safe_teleport_from_results 控制。生物群系、结构或兴趣点结果指向一个地点而非方块，由 safe_teleport_from_biome_results 控制。将任一设为 false 则执行普通的 /tp 到精确坐标。

导出有四个独立的开关。 无论它们如何设置，每种方块类型都会被精确计数；它们只决定哪些同时还会获得坐标列表。

开关	列出	默认
export_modded_blocks	来自其他模组的任何内容	开
export_placed_blocks	玩家可放置的原版方块	开
export_notable_blocks	矿石、刷怪笼、紫水晶及其他稀有发现	关
export_natural_blocks	普通地形：石头、泥土、水	关

它们是独立的，因此任何组合都可行：仅模组方块，或没有建筑的矿石，或反过来。

模组方块按模组共享的标签排序，因此模组矿石算作矿石，模组石头算作地面。完全没有标签的则被视为放置物，这对机器、管道和存储是正确的。

导出以文本文件写入 config/locate-plus/exports/，在后台线程中进行。聊天显示前 60 种类型，并说明有多少被省略，这由 chat_results_shown 更改。使用 export 获取包含每个坐标的完整列表。

玩家绝不会被 /purgeentities 移除，无论目标如何书写。它也不产生掉落物、经验值和死亡消息。

发光和方块标记持续一分钟。 /glow 仅限实体。

/locate item 会查找物品可能存在的所有地方： 容器（包括模组容器）、位于其他容器内的潜影盒、地面上的物品、生物装备、物品展示框，以及玩家物品栏和末影箱。结果按位置分组，最大堆优先，每行说明持有者是什么。其中任何位置都可以在配置中关闭，如果你的服务器将玩家物品栏视为隐私，那么这样做值得。

在你不拥有的服务器上安装

你无法做到。此模组只在运行服务器的机器上起作用，因为它添加的每条命令都注册到服务器的命令树中，每次扫描都读取服务器的世界副本。将 jar 放入你自己的 mods 文件夹并加入他人的服务器对你毫无用处：你的客户端以纯文本发送命令，而没有该模组的服务器会回答“Unknown or incomplete command”。没有任何透视，因为客户端从不是执行查找的一方。

同样的道理也是它一开始无需客户端安装的原因。作为客户端作弊无用与对玩家不可见，是同一属性。

谁能看到什么

命令输出是私密的。每条消息只发送给执行命令的人，因此坐标绝不会向服务器公告。

唯一的例外是发光。它是实体状态而非消息，因此任何能看到该实体的玩家都能看到轮廓；没有按玩家区分的版本。这影响 /glow 和 /locate entity，后者会标记其最近匹配。将 glow_located_entities 设为 false 可去掉标记，或完全关闭 glow。

配置

config/locate-plus/config.json 在首次启动时写入。它是 JSON，但允许注释，且每个设置都在文件本身中说明。编辑它并运行 /lp reload，或重启。

你可以更改权限等级、完全关闭个别命令、设置默认半径、选择 /locate item 允许搜索的内容、调整每刻扫描可用的时间，以及提高或降低模组施加的每个限制：它将接受的最大半径、聊天显示多少结果、一次导出或物品搜索可容纳多少，以及它深入嵌套容器多深。/lp config 打印服务器当前已加载的内容。

有语法错误的文件会被保留不动并在日志中报告，因此一个拼写错误绝不会让你失去设置。超出范围的值会被钳制，而不是拒绝。

默认值

/locate 半径	64 blocks
/lp analyze 半径	4 chunks
权限等级	2（OP，或单人游戏中的作弊）
扫描预算	每刻 8 ms

AI 免责声明

我使用 AI 撰写 README 和描述，以帮助改善我的写作和语法。希望这没问题！