
Simple Registry Aliases
Exposing Fabric API's registry aliasing in a simple, config driven way.
About this Mod
Simple Registry Aliases
This mod allows you to define registry entry aliases, by exposing Fabric API's registry alias
system in simple, config-driven way.
It supports both static (blocks, items, etc.) and dynamic (biomes, enchantments, etc.) registries.
Configuration.
All alias definitions are stored in ./config/registry_aliases/ as a json map.
For vanilla registries, the file should be named as <registry_path>.json,
so for example item registry aliases will be located it item.json, block as block.json,
biomes at worldgen/biome.json (worldgen is a folder) and so on.
For modded registries (through it also works in vanilla), the file should be named <registry_namespace>/<registry_path>.json,
for example for registry magic_mod:spells the name is magic_mod/spells.json.
The file itself is just a json map, with keys being the original entry id and value being the replacement.
For example, a file at ./config/registry_aliases/item.json with content
{
"toomanymetals:enderite_pickaxe": "minecraft:netherite_pickaxe",
"toomanymetals:enderite_axe": "minecraft:netherite_axe"
}
will make all item (as they are sourced from item registry) toomanymetals:enderite_pickaxe get replaced withminecraft:netherite_pickaxe once it's loaded.
Worth noting this only works if the registry entry you want to replace doesn't exist. If it does, this won't work and
the original entry will be used instead.
Available Versions
How to Install Simple Registry Aliases on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "Simple Registry Aliases". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+8 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Simple Registry Aliases server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is Simple Registry Aliases compatible with fabric?
Simple Registry Aliases officially supports fabric for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Simple Registry Aliases – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Simple Registry Aliases consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Simple Registry Aliases with just one click on your server.