Simple Registry Aliases

Simple Registry Aliases

Exposing Fabric API's registry aliasing in a simple, config driven way.

by
13.7K Downloads
fabricutility
Rent Server with this Mod

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 with
minecraft: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

1.1.0+26.1release
MC 26.1, 26.1.1, 26.1.2fabric
March 27, 2026
1.0.0+1.21.4release
MC 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11fabric
February 9, 2025

How to Install Simple Registry Aliases on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

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

fabric

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+8 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Simple Registry Aliases with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 only
Server-side
Required

Supported Versions

26.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.61.21.5+1 more