Simple Registry Aliases

Simple Registry Aliases - технический мод для Майнкрафт на Fabric, который решает одну очень частую и очень больную проблему: вы удалили мод из сборки, а его предметы, блоки или биомы остались в мире, в сундуках и в инвентарях игроков. Обычно это заканчивается ошибками в логах, "дырявыми" слотами в инвентаре и ванильным сообщением про missing registry entries при загрузке мира. Этот мод открывает доступ к системе алиасов реестров (registry aliases), встроенной в Fabric API, и упаковывает её в простой формат: папка конфигов плюс обычные JSON-файлы. Никакого кода, никаких датапаков с хаками.

Скачать Simple Registry Aliases стоит в первую очередь тем, кто ведёт долгоживущий сервер или большую сборку модов и периодически чистит её от лишнего контента.

Что мод умеет

Мод позволяет объявить замену любой записи реестра: старый ID указывает на новый, и при загрузке мира Minecraft подставляет замену автоматически. Поддерживаются оба типа реестров:

• Статические реестры - блоки, предметы, сущности, эффекты и всё остальное, что регистрируется на старте игры.
• Динамические реестры - биомы, зачарования, структуры и прочий worldgen-контент, который подгружается при создании мира.

Это принципиальное отличие от ручной правки level.dat и прочих "костыльных" способов: Fabric API сам подменяет ID на этапе загрузки, так что мир остаётся целым, а игроки даже не замечают подмены.

Как настроить Simple Registry Aliases

Все правила лежат в папке ./config/registry_aliases/. Это обычные JSON-файлы, каждый файл отвечает за один реестр.

Для ванильных реестров имя файла совпадает с путём реестра:

• item.json - алиасы предметов
• block.json - алиасы блоков
• worldgen/biome.json - биомы (папка worldgen создаётся отдельно)
• и так далее по аналогии

Для модовых реестров формат чуть длиннее: <неймспейс>/<путь>.json. Например, для реестра magic_mod:spells файл будет называться magic_mod/spells.json. Тот же формат работает и для ванильных реестров, если вам так удобнее.

Внутри файла - простой словарь, где ключ это оригинальный ID записи, а значение - её замена. Пример: вы удалили мод с "эндеритовыми" инструментами и хотите, чтобы они превратились в незеритовые. Создаёте ./config/registry_aliases/item.json с таким содержимым:

{
  "toomanymetals:enderite_pickaxe": "minecraft:netherite_pickaxe",
  "toomanymetals:enderite_axe": "minecraft:netherite_axe"
}

После загрузки мира каждый toomanymetals:enderite_pickaxe, будь то в инвентаре, сундуке или лежащий на земле дроп, станет обычной minecraft:netherite_pickaxe. То же самое с топором из примера.

Важные нюансы

• Замена работает, только если оригинальная запись отсутствует в реестре. Если мод всё ещё установлен и toomanymetals:enderite_pickaxe существует в игре, алиас игнорируется и используется настоящий предмет. То есть это инструмент именно для вывода контента из обращения, а не для глобального ребаланса.
• Алиасы срабатывают на этапе загрузки мира, поэтому достаточно один раз зайти в мир с настроенными конфигами - подмена "приклеится" навсегда (до тех пор пока конфиг на месте, лучше его не удалять).
• Мод рассчитан на Fabric, так как опирается на механику Fabric API. Для NeoForge и Forge подобные задачи решаются другими средствами, здесь они не поддерживаются.

Кому реально пригодится

Если вы просто играете с фиксированным набором модов и ничего не удаляете - мод вам не нужен, это чисто инструментальная вещь. А вот админам серверов и сборщикам модпаков это must-have: типичный сценарий - выкинуть "мод-мусор" с кучей руд и декоративных блоков, не наказывая игроков потерей вещей. Вместо тысячи unknown-предметов в инвентарях люди получают ванильные аналоги, а логи остаются чистыми.

Ещё один интересный кейс - облегчённая миграция между похожими модами: например, перенос контента одного библиотечного мода на другой, если ID совпадают по смыслу. Главное правило простое: сначала настраиваете алиасы, потом удаляете мод, и только после этого грузите мир.

Скачайте мод Simple Registry Aliases и забудьте про битые сохранения после чистки сборки - пара JSON-файлов решает проблему раз и навсегда.