SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
✓ VerifiedBuilding & decoration

Reliable Replacer

by evanbones · for Minecraft

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

79KDownloads
4d agoLast updated
MITLicense
Fabric · Forge +1Loaders

About Reliable Replacer

From Modrinth

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

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

Highlights

From source data

Game versions

Supports 7 Minecraft versions, the newest being 26.3.

Loaders

Runs on Fabric, Forge and NeoForge.

Footprint

Rated a light load on a server.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Building & decoration

Blocks, furniture, decorations and building tools.

Runs on your server

From source side support

Modrinth lists Reliable Replacer as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
FabricForgeNeoForge
Runs on
Serverrequired on the server
Game versions
26.3 and 6 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-01Open ↗
  • ✓Authorevanbones, as published on Modrinth
  • ✓LicenseMITFree

Reliable Replacer, answered

Generated from the mod’s own source data.

Do my players need to install Reliable Replacer?

Modrinth lists Reliable Replacer as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric, Forge and NeoForge.

Is it free?

Yes. Reliable Replacer is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Reliable Replacer on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Reliable Replacer in one click.