NWorks's Simple Measurement Tool

NWorks's Simple Measurement Tool

Turn a plain stick into a 3-axis measuring tool. Right-click two points to get exact X/Y/Z block spans, diagonal distance and total block count. Fully client-side, no server install needed.

3 downloads 0 followers

Simple Measurment Tool

Hold a stick. Right-click two points. Get real numbers.

No new items, no recipes, no commands, nothing to install on the server. Pick up any ordinary stick and it becomes a measuring tool.

How it works

Hold a stick and a red cube marks whatever block you are aiming at - up to 128 blocks away, far past normal reach.

Action Result
Right-click Places the first measurement point
(while measuring) A green box spans your point to your cursor, with a live floating readout above it
Right-click again Prints the full result to chat and clears the measurement

The live readout updates every frame as you move:

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

And the final result lands in chat:

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

What the numbers mean

Everything is inclusive - a single block measures 1, not 0, which is what you actually want when you are counting blocks to place.

Field Meaning
X / Y / Z Block span along each axis, inclusive of both endpoints
Measurement Distance Straight-line distance between the two points
Blocks Total blocks in the box: X × Y × Z

Handy for sizing a build before you start it, checking that two halves of a symmetrical structure actually match, measuring track spacing and station lengths, or just finding out how many blocks a wall is going to cost you.

Fully client-side

  • Install it on your client only. The server never needs it.
  • Works on vanilla servers and on servers running a completely different modlist.
  • Sends nothing, changes nothing, saves nothing to the world.
  • Safe to add or remove from an existing instance at any time.

One thing to know

While a stick is in your main hand, right-click is consumed by the tool - so you cannot open a chest or place your off-hand item with a stick held. That is intentional, so measuring never triggers something else by accident. Turn it off with suppressVanillaUse = false if you would rather keep normal right-click.

Configuration

config/simplemeasure-client.toml, all client-side:

Option Default What it does
enabled true Master switch
triggerItem minecraft:stick Which item acts as the tool
maxRayDistance 128.0 How far you can aim, in blocks
snapMode SM_EXACT SM_EXACT snaps like the original tool; TARGET_BLOCK always picks the solid block you are pointing at
suppressVanillaUse true Swallow right-click while the tool is held
clearPointOnUnequip false Drop a half-finished measurement when you switch items
playSound true Click sound on each point
showAimMarker true The red aiming cube
labelMaxDistance 128.0 Where the floating readout fades out

Compatibility

  • Minecraft 1.21.1, NeoForge
  • No dependencies
  • No mixins, no registry entries, no network packets - nothing for another mod to collide with

Support

A Discord server for troubleshooting and support, for this mod and my other projects right here.

Credits

The measuring behaviour, the arithmetic and the red/green visual language are modelled on the Measurement Tool from Advanced Tools by 00Fant, for Scrap Mechanic.

This is an independent reimplementation for Minecraft. No code and no assets from that mod were copied, reused or redistributed - only the externally visible behaviour and the measurement formulas were reproduced.

Version Minecraft Loader Download

NWorks's Simple Measurement Tool 1.1.0

1.1.0

1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
neoforge
Download