BlockDiff

Overview
BlockDiff is a Forge mod (1.20.1) for tracking and repairing differences in player-defined regions. It provides tools to save snapshots, compare current blocks against those snapshots, and repair missing/extra blocks using various payment methods.

Getting Started
Obtain the items/blocks from the creative tab “BlockDiff” or craft them using the recipes below.

Use the Snapshot Wand or the /blockdiff command to define and save a region.

Place a Repair Block inside the region to open the repair GUI.

Use the Remote Repair Terminal to access and manage multiple regions from a distance.

Commands
/blockdiff
Saves a snapshot or compares current blocks.

: missing, extra, all

/blockdiff auto start
Starts automatic comparison every second.

/blockdiff auto stop
Stops automatic comparison.

/blockdiff clear
Removes a snapshot.

Coordinates support Tab completion using the player’s targeted block or current position.

Items & Blocks
Repair Block
Right-click to open repair GUI for the containing region.

Shift + right-click to delete the region snapshot.

Can be crafted.

Remote Repair Terminal
Right-click to open a remote GUI listing all nearby snapshots (within remoteRange).

Only regions containing a Repair Block can be opened.

Left-click a region to open its repair GUI.

Right-click a region to rename it.

Click the red “Delete” button to remove the snapshot.

Shift + right-click the block itself to delete the snapshot containing it.

Has custom model and collision box.

Snapshot Wand
Shift + right-click: cycle mode (missing / extra / all).

Right-click first block: set point 1.

Right-click second block: set point 2 and show particle outline.

Right-click a third time: open naming screen and save snapshot.

The wand must be renamed (e.g., in an anvil) to give the snapshot a name, or use the naming screen.

Repair GUI
Buttons (top to bottom):

Token Selection: Click to cycle between diamond, gold ingot, and emerald.

Regular Repair: Hold to repair continuously.
Missing blocks consume their corresponding item; extra blocks consume 2 hunger per block.

Token Repair: Hold to repair using selected token (10× speed of regular).
If you are an admin (permission level 2), clicking this button performs instant, full repair ignoring all lists.

Show Differences: Toggles wireframe overlay for this region.
White = region border
Red = extra blocks (highest priority)
Blue = state-changed blocks (same block, different state)
Green = missing blocks
Overlay refreshes every second and stays after GUI closes.

Rename Region: Opens a screen to rename the snapshot.

Close: Closes the GUI.

Long-press repair buttons show a progress bar. Repair speed is controlled by repairSpeed config (default 5 blocks per second for regular, 50 for token).

Configuration
File: config/blockdiff-server.toml

Key Default Description
tokenItem minecraft:diamond Item used as default token
repairSpeed 5 Blocks repaired per second by regular repair
remoteRange 200 Search radius for Remote Repair Terminal
whitelist … Blocks that will not be removed as extra
blacklist … Blocks that will not be restored as missing
stateIgnoredBlocks … Blocks where state differences are ignored