TheRuler

# Ruler

**Ruler** is a lightweight, client-side selection and measurement tool for Minecraft 1.21.1 (Fabric). It lets you mark two positions in the world and instantly see a clean holographic 3D visualization of the selected area — along with all relevant measurements in a HUD overlay.

Inspired by WorldEdit CUI, but completely standalone. No server plugin or WorldEdit installation required.

—

## How it works

Press **R** to activate the ruler (rebindable under Controls → Ruler).

– **Left-click** a block to set **Pos1**
– **Right-click** a block to set **Pos2**

That’s it. The selection renders immediately.

Press **R** again to deactivate and clear the selection.

—

## 3D Visualization

The selection is rendered as a holographic wireframe box directly in the world:

– **XYZ color-coded edges** — X red, Y green, Z blue
– **Subtle inner grid** for spatial orientation
– **Transparent block highlights** at Pos1 (green) and Pos2 (red)
– Single positions are shown before the second is placed
– Clean, modern look — no chunky vanilla-style boxes

—

## HUD Overlay

A small panel in the top-left corner shows:

| Field | Description |
|——-|————-|
| Pos1 / Pos2 | Block coordinates |
| Distance | Direct 3D diagonal (air-line) |
| X / Y / Z | Dimensions of the selection |
| Area | Footprint (X × Z) |
| Volume | Total blocks (X × Y × Z) |

—

## Languages

Ruler ships with **37 languages** out of the box:

**Standard:** English, Deutsch, Français, Español, Italiano, Português, Русский, Українська, Polski, Nederlands, Svenska, Dansk, Norsk, Suomi, Čeština, Slovenčina, Magyar, Română, Türkçe, Ελληνικά, 简体中文, 繁體中文, 日本語, 한국어, العربية, עברית, Tiếng Việt, ภาษาไทย

—

## Compatibility

– ✅ **Client-side only** — works on any server, no server mod needed
– ✅ **ModMenu** — appears correctly in the mod list
– ✅ Fabric API required

—

## Requirements

– Minecraft **1.21.1**
– Fabric Loader **≥ 0.17.3**
– [Fabric API](https://modrinth.com/mod/fabric-api)