BlockScanner

A Minecraft Forge mod for scanning and replacing modded blocks to help with world maintenance and mod transitions.

Overview

BlockScanner provides tools to scan Minecraft worlds for blocks from specific mods, and replace them with blocks from other mods or vanilla Minecraft. This is especially useful when:

Uninstalling mods from an existing world
Upgrading worlds between Minecraft versions
Fixing broken/missing blocks after mod updates

Features

Block Scanning: Scans for modded blocks around players or in specified areas
Automatic Replacement: Configurable mappings to replace blocks from one mod with another
Property Preservation: Maintains block rotation, direction, and other properties during replacement
NBT Data Preservation: Keeps inventory contents and other block entity data when replacing containers and machines
Bulk Operations: Process entire areas or maps with a single command
Registry Scanning: Identifies all modded blocks and items in your current installation

Commands

BlockScanner provides several commands, all accessible via /blockscanner or the shorthand /bscan.

Basic Commands

/bscan scan [radius] - Scan for modded blocks around you
/bscan replace <fromBlock> <toBlock> [radius] - Replace specific blocks
/bscan reload - Reload configuration files
/bscan addblock <fromBlock> <toBlock> - Add a new block replacement rule
/bscan listscanned - List all scanned modded blocks
/bscan generateconfig - Generate a suggested replacement configuration

Area Processing

/bscan activate [radius] - Activate block replacements in an area
/bscan processall - Process all loaded chunks
/bscan replacechunk <pos> - Replace blocks in a specific chunk
/bscan status - Check replacement status

Map Operations

/bscan scanmap <x1> <z1> <x2> <z2> [renderDistance] - Scan a rectangular area of the map
/bscan replacemap <x1> <z1> <x2> <z2> [renderDistance] - Replace blocks in a map area
/bscan stopmap - Stop an in-progress map scan

Auto Scanning

/bscan autoscan on|off - Toggle automatic scanning around players
/bscan autoscan status - Check auto-scanning status

Registry Commands

/bscan registryscan - Scan and save all modded registry entries
/bscan listmods - List all mods with registry entries
/bscan listitems [modid] - List modded items (optionally filtered by mod)
/bscan listblocks [modid] - List modded blocks (optionally filtered by mod)

Configuration

BlockScanner stores its configuration in the config/blockscanner/ directory:

block_replacements.json - Main configuration file for block replacement rules
suggested_replacements.json - Generated suggestions based on scanned blocks
modded_blocks.yml - List of discovered modded blocks
modded_items.yml - List of discovered modded items

Block Replacement Format

The block replacement configuration uses a simple JSON format:

{
  "modid:block_name": "minecraft:replacement_block",
  "anothermod:some_block": "minecraft:stone",
  "problematic:machine_block": "minecraft:furnace"
}

Automatic Replacement

When block replacement is active, the mod will:

Preserve block orientation (e.g., a north-facing furnace remains north-facing)
Maintain block states (e.g., slabs placed on the top half stay on the top half)
Copy NBT data when possible (e.g., inventory contents in containers)

Advanced Usage

Fixing Missing Blocks

When a mod is uninstalled and leaves missing blocks, run these commands:

/bscan registryscan - Scan all available blocks in current installation
/bscan scan 128 - Scan around the player for modded blocks
/bscan generateconfig - Create suggested replacements
Edit the suggested_replacements.json file to adjust replacements
Rename to block_replacements.json or copy the content to the existing file
/bscan reload - Reload the configuration
/bscan activate 128 - Activate replacements

Map Processing

For large servers or maps, use the map commands:

/bscan replacemap -1000 -1000 1000 1000 256

This will systematically teleport to positions covering the specified area, activating replacements at each location.

Performance Considerations

Processing large areas can be resource-intensive
The mod uses multi-threading where possible to improve performance
For very large operations, consider increasing Java heap allocation

Compatibility

This mod is compatible with:

Minecraft Forge 1.18.2
Single player and multiplayer servers
Most other Forge mods

License

Credits

Developed by NexusNode team

Block Scanner & Replace