Skip to content

Reliable Replacer

A lightweight utility for replacing one block with another, both during worldgen and afterward.

FabricNeoForgeForge
Loaders
FabricNeoForgeForge
Downloads on Modrinth
103K
Followers on Modrinth
91
versions
162
Updated
November 17, 2026Nov 17
Published
in 2026
Config Screen — Visually edit your global config · swipe

At a glance

Runs on Fabric, NeoForge and Forge
For Minecraft 1.21.1, 26.1–26.3 …
Server only — players don't need to install it
Latest version — 1.8.3+26.3-neoforge from November 17, 2026
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.20.1, 1.21.1, 26.1–26.3

Reliable Replacer

forge fabric neoforge

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?

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:

{
  "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.

For information and examples on how to use the mod, please also refer to the wiki.

Quick-Start Example

Create a file called my_replacement.json, or whatever else you'd like, in config\reliable_replacer:

[
  {
    "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

Code license (MIT)


discord-plural github-plural

FAQ

How to install Reliable Replacer?

Install Fabric for your Minecraft version, download Reliable Replacer for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Reliable Replacer support?

Reliable Replacer has builds for Minecraft 1.20.1, 1.21.1, 26.1–26.3.

Is Reliable Replacer needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More