ShatterLib | OctoLib

ShatterLib (или OctoLib) - библиотека общего кода, созданная студией OctoStudios для своих модов в Майнкрафт. Если вы устанавливаете любой мод от этой команды, скорее всего, вам потребуется и эта библиотека - она отвечает за базовые механики работы.

Что делает и зачем нужна

Это не самостоятельный мод, а скорее техническая прослойка, которая обеспечивает:

• YAML-конфиги - вместо обычных .json или .toml файлов (как в ванильных настройках или модах вроде Cloth Config), здесь используется формат похожий на датапаки, но проще и удобнее для правок
• Авто-валидация - если в конфиге ошибка, мод не упадёт с крашем, а просто проигнорирует проблемный параметр или укажет на строку с ошибкой
• Глубокая сереализация - это значит, что настройки сохраняются и загружаются без потери данных, даже сложные структуры
• Безопасность - защита от дурака в конфигах, чтобы игрок случайно не сломал себе игру

Что с этим зуммером делать?

Если ты обычный игрок - просто поставь эту библиотеку, когда требуют другие моды от OctoStudios. Ничего настраивать не нужно, она работает в фоне.

Если ты разраб модов - вроде можно использовать в своих проектах, но кодовая база меняется иногда неожиданно, поэтому автор рекомендует не завязываться на неё сильно.

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

• Для Minecraft 1.19-1.21
• Работает на Fabric, Forge и NeoForge (через промежуточный Architectury API)

Важно: на версии 1.20.1+ требуется установить Architectury API как обязательную зависимость. Без него библиотека просто не запустится.

Нюансы

Студия OctoStudios не рекомендует использовать её в сторонних модах, если вы не готовы подстраиваться под изменения. Но для обычного пользователя это не проблема - поставил и забыл.

Если собираете сборку модов и видите требование ShatterLib - ставьте без вопросов. Это как Forge или Fabric API, только для конкретных проектов. Без неё моды студии просто не заведутся или будут выдавать ошибки на старте.