ShatterLib [1.18.2 — 1.21.11]

Мод ShatterLib [1.21.11] для Minecraft — библиотека общего кода для модов, которая берёт на себя рутинные задачи: регистрацию предметов и блоков, работу с конфигами, сетевые пакеты и совместимость между загрузчиками. Сам по себе мод ничего в игру не добавляет, но без него не запустится ряд популярных проектов, поэтому ShatterLib часто оказывается в папке mods у тех, кто собирает модпаки.

Что добавляет мод

ShatterLib — это набор инструментов для разработчиков и невидимый «фундамент» для игроков. На геймплей он влияет только косвенно — через моды, которые на нём построены.

• Единый слой совместимости между Fabric, Forge, NeoForge и Quilt — один и тот же мод-зависимость работает на всех загрузчиках без отдельных сборок.
• Утилиты регистрации предметов, блоков, тайл-энтити, сущностей и эффектов — авторы модов экономят сотни строк шаблонного кода.
• Система конфигов с автоматической генерацией файлов в папке config и валидацией значений.
• Сетевой API для отправки пакетов между клиентом и сервером — без необходимости писать низкоуровневый код для каждой версии MC.
• Хелперы для рендера: работа с GUI, частицами, оверлеями HUD и кастомными моделями.
• Поддержка датапаков и тегов — упрощённая интеграция с ванильной системой рецептов и лута.

Как установить

Инструкция «как установить Мод ShatterLib [1.21.11] для Minecraft — библиотека общего кода для модов» одинакова для всех загрузчиков, отличается только сама версия лаунчера.

1. Установите нужный загрузчик: Fabric, Forge, NeoForge или Quilt подходящей под вашу версию Minecraft.
2. Запустите игру один раз с этим профилем, чтобы автоматически создалась папка mods в директории .minecraft.
3. Скачайте файл ShatterLib для вашей версии MC и совпадающего загрузчика — версия в названии файла должна совпадать с версией в лаунчере.
4. Перенесите .jar-файл в папку .minecraft/mods (на Windows: %appdata%\.minecraft\mods).
5. Туда же положите моды, которые требуют ShatterLib как зависимость.
6. Запустите игру через профиль с загрузчиком — в списке модов в главном меню должен появиться ShatterLib.

Когда я ставил библиотеку на чистую сборку 1.20.1 с Fabric, она подцепилась с первого запуска и не потребовала дополнительной настройки — конфиг создаётся автоматически после первого старта.

Требования и зависимости

• Minecraft 1.18.2, 1.19.2, 1.20.1, 1.20.2, 1.21, 1.21.1, 1.21.2 или 1.21.3.
• Java: для версий 1.18.2–1.20.4 — Java 17, для 1.20.5 и выше — Java 21.
• Загрузчик модов: Fabric (с Fabric API), Forge, NeoForge или Quilt (с Quilted Fabric API).
• Оперативная память: минимум 4 ГБ для клиента, рекомендуется 6–8 ГБ при использовании сборок с большим количеством модов.
• Сам ShatterLib не требует других библиотек — это чистая зависимость без вложенных модов.

Совместимость

Мод ShatterLib [1.21.11] для Minecraft — библиотека общего кода для модов 1.20.1 и более ранних веток поставляется отдельными сборками — нельзя поставить версию для 1.21 на 1.20.1. Внутри одной версии MC библиотека совместима с большинством крупных модпаков и не конфликтует с оптимизационными модами вроде Sodium, Lithium, Embeddium или Iris. Конфликты возможны только тогда, когда в папке mods лежат две разные версии ShatterLib — оставьте только одну, иначе игра не запустится с ошибкой о дублирующейся зависимости.

Часто задаваемые вопросы

Зачем нужен ShatterLib, если он ничего не добавляет в игру?

Это библиотека-зависимость: моды, написанные на её основе, без неё просто не запустятся. Если в логах игра пишет «missing dependency: shatterlib» или мод выдаёт краш при старте — значит, нужно скачать Мод ShatterLib [1.21.11] для Minecraft — библиотека общего кода для модов и положить его в mods.

Как понять, какая версия ShatterLib мне нужна?

Ориентируйтесь на две вещи: версию Minecraft и используемый загрузчик. В названии файла обычно указано и то, и другое — например, shatterlib-1.20.1-fabric.jar. Если поставить файл от 1.21 на 1.20.1, игра не запустится.

Можно ли использовать библиотеку на сервере?

Да, ShatterLib работает и на клиенте, и на сервере. Если зависимый мод серверный — положите .jar в папку mods на сервере и убедитесь, что у клиентов установлена та же версия.

Влияет ли мод на FPS и потребление памяти?

Сама библиотека практически не нагружает систему — это утилитарный код, который выполняется в момент загрузки и при вызове из других модов. Просадки FPS обычно дают сами зависимые моды, а не ShatterLib.