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
/blockdiff auto
/blockdiff auto
/blockdiff clear
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
No gallery available for this project.