Lib39

Lib39 - это библиотека для Fabric, которая собрала в себе кучу полезных миксинов, событий и утилит, изначально написанных для мода Yttr. Разработчики заметили, что народ постоянно "тырит" миксины из Yttr, потому что там полно полезных штук, и решили вынести их в отдельную библиотеку. Название отсылает к иттрию (39-й элемент таблицы Менделеева), так что произносить можно как угодно - хоть "либ сэнти най", хоть "либ три най", хоть "либ мику".

Зачем это нужно

Если вы пишете моды для Майнкрафт на Fabric, то наверняка сталкивались с ситуацией, когда нужно сделать что-то нестандартное - например, добавить кастомные рецепты, изменить рендеринг частиц или организовать сетевой обмен. Вместо того чтобы писать всё с нуля или искать разрозненные решения, можно просто подключить нужный модуль Lib39 и получить готовый функционал. Это экономит кучу времени и сил.

Как подключить

Lib39 распространяется через Sleeping Town Maven. Добавьте в build.gradle:

repositories {
    maven {
        url 'https://repo.sleeping.town'
        content {
            includeGroup 'com.unascribed'
        }
    }
}

dependencies {
    modApi include("com.unascribed:lib39-core:2.0.7+1.20.1")
    // остальные модули по желанию
}

Также библиотека есть на Modrinth (/mod/lib39), но разработчики настоятельно рекомендуют подключать модули через JiJ - они маленькие, и это упрощает распространение.

Модули Lib39

Модуль	Размер	Что делает
Core	26.12KiB	Базовые утилиты: AutoRegistry, AutoMixin, звуки крафта
Lockpick	4.38KiB	Убирает искусственные ограничения: углы поворота моделей, размеры рецептов
Ripple	6.06KiB	Кастомизация текста на загрузочном экране
Tunnel	27.85KiB	Удобная сетевая система на основе Concrete Network из 1.12
Phantom	12.10KiB	Временное скрытие блоков без удаления из мира
Waypoint	22.33KiB	Дополнительный слой рендеринга для светящихся эффектов
Weld	16.69KiB	Система "больших блоков" для префабов (как кровати, но без ограничений)
Sandman	6.56KiB	Заставляет предметы "всегда тикать" через случайные тики
Crowbar	6.83KiB	События для низкоуровневой генерации мира и доступ к чанкам
Keygen	34.88KiB	Загрузка музыки в форматах XM, S3M, MOD через IBXM2
Dessicant	9.23KiB	Логические таблицы лута и авторазблокировка рецептов через "discovered_by"
Machination	33.06KiB	Новые типы рецептов: замачивание в жидкости, раздавливание поршнем (с поддержкой EMI)
Recoil	9.79KiB	События для управления камерой и FOV, перехват атак/использования (для модов с оружием)
Util	5.58KiB	Разные утилиты (без документации пока)
AQI	5.20KiB	Исправляет рендеринг частиц за полупрозрачными блоками (два прохода, как до 1.14)
Mesh	13.99KiB	Эффективная графовая система для сетей блоков (трубы и т.п.) - без доков
Wrangle	9.62KiB	Система подсказок управления - тоже без документации пока

Бывшие модули

• Fractal - система подгрупп для творческих вкладок. Теперь поддерживается DaFuqs как отдельная библиотека (/mod/fractal-lib/).

Планы на будущее

Разработчики планируют вынести ещё несколько штук из Yttr:

• Equivalence - система замены предметов в рецептах и тегах
• Conflagration - конфигурация на основе CSS и фреймворк для GUI

Версии Minecraft

• Lib39 1.4 и старше - только Minecraft 1.19-1.19.2
• Lib39 1.5 - добавили поддержку 1.18.2 и 1.19.3, а также экспериментальные сборки для 1.20.1
• Lib39 2.0 - API-совместима с 1.x, пока только для Minecraft 1.20.1, разрабатывается вместе с Yttr

Если вы собираетесь делать мод на Fabric с нестандартными механиками - Lib39 может серьёзно упростить жизнь. Особенно полезны модули вроде Lockpick (снимает ограничения), Machination (новые рецепты) или Recoil (для оружейных модов). А модуль AQI вообще стоит подключить всем - он фиксит баг с частицами за полупрозрачными блоками, который бесит многих игроков.