Auto Replace
Auto Replace makes a held block or tool refill the slot it came from after a block is broken, so a pickaxe or axe keeps working without the player reselecting it.
What it does
Auto Replace is a NeoForge mod for Minecraft 1.21.1 that acts on block breaking with the main hand or the off hand. When the main-hand item breaks a block, a matching block placed in the main hand takes its place. When an off-hand pickaxe, axe, shovel or hoe is used while the main hand is empty, the main hand is refilled automatically. Other items in the off hand do not trigger the action.
The feature only applies under a few conditions, so it stays out of the way for most building. It is aimed at players who work through long mining sessions and want fewer manual swaps. A Game Rules option named Disable Auto Replace, backed by the disableAutoReplace gamerule and off by default, lets a server owner or a world owner turn the behavior off.
The mod runs on the client or on the server, and it is optional on both sides. Only one NeoForge file is published, version 1.0.0 for 1.21.1, released on 2025-07-05. The code is not open source, and the mod is released under All rights reserved.
Key features
Main-hand block replacement
A block placed in the main hand fills the slot when the held item breaks the block it was used on.
Off-hand tool refill
An off-hand pickaxe, axe, shovel or hoe refills an empty main hand after it is used on a block.
Limited conditions
Other items in the off hand do not start the replacement, so the action stays tied to specific tools.
Game rule toggle
The Disable Auto Replace Game Rules option and the disableAutoReplace command switch the feature off.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Players on NeoForge 1.21.1 who work through long mining or chopping sessions and want held items refilled, and server owners who want the option available but switchable through a game rule.
Questions
Does Auto Replace need to be installed on the server?
Can the automatic replacement be turned off?
Which loader and version does Auto Replace support?
In the catalog
Auto Replace is one of 3,545 Optimization mods on ModsFinder, and one of 1,250 Optimization mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
Similar mods
What the author says
With this mod, if you have blocks at your main-hand or off-hand and break the blocks, it will replace the blocks automaticly. -If you have blocks at your main-hand and break any block with your main-hand, it will automaticly replace the block at your main-hand.
Official listing
- Modrinth page
- modrinth.com/mod/auto-replace
- Owner
- BarnameNevisetun
- Published
- 2025-07-05
- Updated on Modrinth
- 2025-07-05
- Facts verified
- 2026-10-15