NWorks’s Simple Measurement Tool

简易测量工具

手持一根木棍。右键点击两处位置。获取精确数值。

无需新增物品、合成配方或命令，也无需在服务器上安装任何东西。拿起任意一根普通
木棍，它就会变成测量工具。

使用方法

手持木棍时，红色方块会标记你瞄准的方块——最远可达 128 格，
远超普通交互距离。

| 操作 | 效果 |
|—|—|
| 右键点击 | 放置第一个测量点 |
| （测量过程中） | 绿色方框会从测量点延伸至光标位置，其上方会实时显示悬浮读数 |
| 再次右键点击 | 在聊天栏显示完整结果并清除测量 |

移动时，实时读数会逐帧更新：

Distance: X: 5 | Y: 3 | Z: 4

最终结果会显示在聊天栏中：

Measurement Distance: 7
X: 5
Y: 3
Z: 4
Blocks: 60

数值含义

所有数值都采用包含端点的计算方式——单个方块的尺寸是 1，而不是 0。数方块来规划建造时，这才是
你真正需要的结果。

| 字段 | 含义 |
|—|—|
| X / Y / Z | 各轴方向上的方块跨度，包含两个端点 |
| Measurement Distance | 两个测量点之间的直线距离 |
| Blocks | 方框内的方块总数：X × Y × Z |

无论是开工前估算建筑尺寸、检查对称结构的两半是否完全一致、测量轨道间距和车站长度，还是单纯想知道建一面墙要花多少方块，这个工具都很实用。

完全在客户端运行

• 只需安装在客户端，服务器无需安装。
• 可在原版服务器上使用，也兼容运行完全不同模组列表的服务器。
• 不会发送任何内容、修改任何内容，也不会向世界保存任何内容。
• 随时可以在现有实例中安装或移除。

注意事项

主手持有木棍时，右键操作会被工具拦截——因此无法用木棍右键打开
箱子，也无法放置副手物品。这是有意设计的，避免测量时意外触发其他操作。如果你
希望保留原版右键功能，可以通过 suppressVanillaUse = false 关闭此功能。

配置

config/simplemeasure-client.toml，以下选项均仅在客户端生效：

| 选项 | 默认值 | 功能 |
|—|—|—|
| enabled | true | 总开关 |
| triggerItem | minecraft:stick | 用作测量工具的物品 |
| maxRayDistance | 128.0 | 可瞄准的最远距离，以方块计 |
| snapMode | SM_EXACT | SM_EXACT 按照原工具的方式吸附；TARGET_BLOCK 始终选择你所指向的实心方块 |
| suppressVanillaUse | true | 手持工具时拦截右键操作 |
| clearPointOnUnequip | false | 切换物品时清除尚未完成的测量 |
| playSound | true | 每放置一个测量点时播放点击音效 |
| showAimMarker | true | 显示红色瞄准方块 |
| labelMaxDistance | 128.0 | 悬浮读数开始淡出的距离 |

兼容性

• Minecraft 1.21.1，NeoForge
• 无前置库
• 不使用 mixin、注册表条目或网络数据包，不会与其他模组发生冲突

支持

如需排查问题或获取这款模组及我的其他项目的支持，请加入 Discord 服务器：点击此处。

致谢

本模组的测量方式、计算逻辑以及红绿视觉设计，参考了 Scrap Mechanic 中由
00Fant 制作的 Advanced Tools
里的测量工具。

这是一个面向 Minecraft 的独立重新实现。**未复制、复用或再分发该模组的任何代码和资源**——仅复现了外部可见的行为和测量公式。