Reliable Replacer
Modby evanbones
A lightweight utility for replacing one block with another, both during worldgen and afterward.
Type
Mod
CurseForge Downloads
544,068
CurseForge ID
1450759
Modrinth Downloads
34,471
Modrinth ID
swDAEYpN
Last Updated
Jul 27, 2026
Description
# Reliable Replacer
A lightweight utility for replacing one block with another, both during worldgen and afterward.
This mod allows modpack creators to effortlessly ban items or restrict their
usage using standard JSON files, without the need for complex scripts.
## What About [Block Swap](https://modrinth.com/mod/block-swap)?
I'm glad you asked! I made Reliable Replacer because of some of my personal frustrations with Block Swap. Here are
some reasons to consider switching!
Why Reliable Replacer?
* Reliable Replacer is frequently updated and supports the latest versions, while as of the time of writing this, Block
Swap is stuck on 1.20.1.
* Live config reloading! Run `/reload` and see your changes instantly take place.
* Reliable Replacer is fully server-side, so it's compatible with Vanilla clients!
* Advanced filtering:
* Filter swaps by biome, dimensions, placed feature, coordinates, or structure!
* Toggle retrogen on or off _per rule_.
* Toggle player placement replacing _per rule_.
* Much more flexible configuration, supporting simple JSON configuration in user-defined folders and integrating with
Cloth Config.
* Per-rule toggleable persistence:
* Decide if replacement blocks should inherit the properties of the old block.
* Doesn't require any external libraries.
## Migrating From Block Swap
Making the switch is easy! Reliable Replacer supports a legacy format designed to work exactly like Block
Swap's configuration.
When you first launch the game with Reliable Replacer installed, a `swapper.json` file will be automatically generated
in your `config/reliable_replacer` folder. This file uses a simple key-value pair format identical to Block Swap.
To migrate, simply copy the "swapper" block from your old configuration into this file:
```json
{
"swapper": {
"oreganized:lead_door": "supplementaries:netherite_door",
"farmersdelight:rope": "supplementaries:rope",
"minecraft:dirt": "minecraft:stone",
...
}
}
```
*Note: Rules defined in `swapper.json` automatically inherit default settings (retrogen enabled, replace on player
placement, etc.). For more advanced control, use the standard rule format.*
## Features
A full feature list is available on
the [Modded Minecraft Wiki](https://moddedmc.wiki/en/project/reliable-replacer/latest/docs/reliable-replacer/features).
For information and examples on how to use the mod, please also refer to
the [wiki](https://moddedmc.wiki/en/project/reliable-replacer/latest/docs/reliable-replacer/usage).
## Quick-Start Example
Create a file called `my_replacement.json`, or whatever else you'd like, in `config\reliable_replacer`:
```json
[
{
"inputs": [
"minecraft:dirt"
],
"output": "minecraft:diamond_block",
"biomes": [
"minecraft:plains"
],
"min_y": "-30",
"max_y": "64",
"player_blocks": "true",
"keep_nbt": "true"
},
{
"inputs": [
"minecraft:stone"
],
"output": "minecraft:gold_ore"
}
]
```
## License
[](https://github.com/evanbones/Reliable-Replacer/blob/1.20.1/LICENSE)
---
[](https://discord.com/invite/JcGRdT6Pbx) [](https://github.com/evanbones/Mod-Template)
Compatibility
Mod Loaders
Fabric
Forge
Neoforge
Game Versions
1.20.1
1.21.1
26.1.2
Screenshots
Similar Mods
Stackable Stew and Soup
Now you can stack the default stews and soups up to a maximum of 8 (configurable)
Mod
5,784,224
bspkrsCore
A set of shared classes used by all mods released by bspkrs.
Mod
5,783,025
Satin API
A Fabric library to help modders with shader usage
Mod
5,773,133
Reputation
Faction based reputation mod
Mod
5,771,402
Doctor Who: Weeping Angels
Adds the Weeping Angels! Don't Blink!
Mod
5,766,658
Flytre Lib (FlytreLib)
Common utils for Flytre's mods!
Mod
5,761,723
Included in Modpacks
Seecret Sunday
Legacies
Free No Virus
Old Scenery
Simple Vanilla Overhaul
Squibbin Hangout
Elysium Days
VORTEX Foundations
Vanilla Reinvented
Artilide