Mineuniverse
Log in Register
Mods

Replacement Finder

A mod to help track down registry replacements that lead to mod incompatibilties
by tfarecnim
Download Claim this project
720 downloads
0 likes
Updated Jul 6, 2026
0 hypes
Miscellaneous

Overview

 

Once upon a time, the most popular way to mod was by changing the class files in the minecraft jar and distributing those.  But there was a problem.

If more than 1 mod touched the same class, then it was extremely difficult to fix because of overwriting.  Hence a mod api was created and agreed upon so that mods could add their stuff without changing base classes and causing hard incompatibilities.  This was all well and good until mods wanted to change the properties of vanilla objects.

It could be done using a coremod, however, it was so difficult that most people either didn't bother or wrote coremods so fragile that if another mod touched it would cause errors.

So in 1.12, registry replacement was invented as a way of allowing mods to alter vanilla blocks without coremods.  However, it has several issues.

 

1) Only one mod per pack can override an object at a time, last one takes priority.  Furthermore, there is no way to choose which mod "wins" since mod loading is nondeterministic and can change at any time.

 

2) Unlike coremods which usually only cause issues when touching the same method, registry replacements of the same object are always incompatible regardless of what they change.

 

3) The only way to be compatible with other mods that registry replaces is to write specific compats for every mod and those mods need to add support in turn or everything breaks down.  This is often infeasible in the case of ARR/closed source mods where implementing code can be problematic.  In either case, automatic hard incompatibility is a very bad thing.

 

4) These objects are cached everywhere in vanilla code including the fields of some objects, leading to issues in replacing some of them. (Cough DefaultBiomeFeatures).

 

So, in an effort to help identify such problematic mods, I created a tool that logs registry replacement of vanilla objects to track down incompatibilities.  It will log any registry replacement that happens and what class it was replaced with.  Example snippit below.

 

 

.Such mods should seek to find a more mod friendly way to alter blocks such as coremods or mixins as outright replacement is too destructive to be used on vanilla objects.

replacementfinder-2.0.jar
MC 1.16.3
Release 2020-10-23 Get

More from tfarecnim

AE2 Extras
9,507,442
Immersive Engineering Cloche and Pam's Harvestcraft 2 Compat
9,373
NBT Tracker
925
Balanced Enchanting
9,194,068
Fast Furnace minus Replacement
9,158,032
Paths
89,872

You Might Also Like

LoadingTips
A mod that adds custom tips to the loading screen
999,218
Sampler
Performance oriented debugging/administration tools
998,926
VulkanMod
Vulkan renderer mod for Minecraft.
997,115
Charm Fixer
Disables some modules on charm to fix incompatbility issues with owo
996,251
Trading station
Basic items to item trading machines
99,755
NarrateBookForMe [FABRIC]
Adds a narration keybind, and two GUI buttons to the book screen. Text-to-speech (tts) / narration on the go! Client sided.
99,734