Swap Box

Quickstart

1. Obtain a Swap Box by crafting it at a crafting table or by using:

   /give @s com_swap_box_4orz37p2:my_sword
   

2. Hold the Swap Box and use it to open its five-step menu.
3. Choose a Target Block Category, then choose the exact Target Block to find.
4. Choose a Replacement Block Category, then choose the exact Replacement Block to place instead.
5. Select a radius from 5 to 50 blocks and press Submit.

The swap is centered on your current block position and affects a cube around you. Only blocks that exactly match the selected target are replaced. The Swap Box is reusable, and simply holding it does not perform an operation.

Overview

Swap Box is a reusable builder’s tool for changing matching blocks throughout a selected area. It is useful for remodeling, recoloring builds, replacing construction materials, clearing spaces, and filling areas with a chosen block.

The tool changes blocks in your current dimension without requiring replacement blocks in your inventory.

What It Adds

Swap Box provides a menu-driven area replacement tool with:

• Separate target and replacement block selections
• A large collection of building, natural, decorative, Nether, End, ore, and storage blocks
• Radius choices from 5 to 50 blocks
• Exact-match replacement, leaving all other blocks untouched
• Support for Air, water, lava, snow, ice, and other environmental blocks
• A reusable, single-item tool

How To Use

Use the Swap Box while holding it to open the selection menu.

Selection Steps

1. Target Block Category
   Choose the group containing the block you want to find.

2. Target Block
   Choose the exact block to replace. Variants such as slabs, stairs, panes, colored blocks, and weathered blocks are separate choices.

3. Replacement Block Category
   Choose the group containing the new block.

4. Replacement Block
   Choose the exact block that will replace the target.

5. Radius
   Choose a radius of 5, 10, 15, 20, 25, 30, 35, 40, 45, or 50 blocks, then press Submit.

Use Back to return to an earlier step. Closing or canceling the menu stops the operation without changing blocks.

Crafting And Obtaining

Craft the Swap Box at a crafting table:

The item can also be obtained in Creative mode or with the /give command shown in the Quickstart.

Abilities And Mechanics

Area Shape

The Swap Box creates a cube centered on the player’s current block position:

• The horizontal area extends the selected radius in each direction.
• The vertical area extends the same radius upward and downward.
• The area is limited by the dimension’s vertical build limits.

For example, a radius of 10 checks a cube 21 blocks wide, 21 blocks tall, and 21 blocks deep.

Exact Block Matching

Only the selected target block is replaced. Other blocks in the cube remain unchanged.

Different block states and variants are separate choices. For example, stone, stone slabs, stone stairs, and cobblestone are not treated as the same target.

Air And Environmental Blocks

Air is an available target and replacement. This allows you to:

• Replace selected blocks with air to clear them.
• Replace air with a chosen block to fill empty spaces.
• Work with water source blocks, flowing water, lava, flowing lava, snow, ice, packed ice, and blue ice.

Available Categories

The target and replacement menus include these categories:

Protected Blocks

Swap Box does not offer or replace protected infrastructure and container blocks, including:

• Bedrock, barriers, structure blocks, and structure voids
• Command blocks
• Chests, trapped chests, and ender chests
• Hoppers, dispensers, and droppers
• Furnaces, blast furnaces, and smokers
• Brewing stands
• Shulker boxes

The operation affects blocks only; it does not move entities or manage inventories.

Progression And Strategy

• Start with a small radius to test a target and replacement pair before working on a large build.
• Use exact variants deliberately. For example, select a specific colored concrete, slab, stair, or weathered copper block rather than a broad material family.
• Use Air as the replacement when clearing a repeated material from a build.
• Use Air as the target when filling empty sections with a chosen block.
• Keep the Swap Box in your hotbar while building so you can reopen the menu whenever you need another area operation.
• Avoid selecting a large radius near areas where you want to preserve a block type; every matching block inside the cube is replaced.