1wholibs

1wholibs - это библиотека для Майнкрафт, которую автор 1whohears вынес в отдельный проект, чтобы не дублировать один и тот же код в своих модах. Сама по себе она ничего в игру не добавляет: ни блоков, ни предметов, ни мобов. Но без неё зависимые моды просто не запустятся, потому что именно здесь лежит общий API, система настроек и техническая база.

Если вы скачали какой-то мод от 1whohears и лаунчер требует 1wholibs - это не ошибка. Просто поставьте библиотеку рядом с основным модом, и всё заработает.

Что умеет библиотека

По факту 1wholibs закрывает сразу несколько технических задач, которые мододелы обычно решают каждый по-своему. Тут всё собрано в одном месте:

• Кастомные игровые правила (gamerules) - можно добавлять свои переключатели мира, которые работают как ванильные gamerule и настраиваются через команды или интерфейс создания мира.
• JSON-пресеты с синхронизацией данных - система конфигураций на основе json-файлов. Важный момент: данные синхронизируются между сервером и клиентом, так что на сервере все игроки видят одни и те же настройки, без рассинхрона.
• Рендер OBJ-моделей поверх сущностей - библиотека умеет отрисовывать модели формата .obj прямо над мобами и другими энтити. Это нужно, когда стандартной модели Minecraft мало и хочется более детализированную геометрию.
• Система кастомных анимаций - отдельный инструмент для анимирования моделей и сущностей за пределами ванильных возможностей.

Для обычного игрока из этого списка важно одно: если мод использует OBJ-модели или нестандартные анимации, без 1wholibs они работать не будут.

Зачем вообще нужны моды-библиотеки

В Майнкрафт-моддинге это стандартная практика. Представьте: у автора пять модов, и в каждом нужна синхронизация данных, рендер моделей и свои gamerule. Копировать один и тот же код пять раз - значит получить пять мест, где может сломаться одно и то же. Поэтому общий код выносят в библиотеку вроде 1wholibs, а моды просто подключают её как зависимость.

Плюсы для игрока тоже есть: библиотека обновляется отдельно, баги чинятся в одном месте, а размер каждого конкретного мода меньше. Из известных аналогов - Fabric API, Cloth Config или Architectury, только 1wholibs заточен под нужды конкретного автора.

Совместимость и установка

Актуальные сборки 1wholibs ориентированы на современные версии Minecraft 1.20.x - 1.21.x. По загрузчикам ситуация зависит от конкретного релиза: проект выходит под семейство Fabric / Quilt / NeoForge, так что перед скачиванием проверьте, под какой загрузчик собрана нужная вам версия и совпадает ли она с версией основного мода.

Установка стандартная:

1. Скачайте 1wholibs под свою версию игры и загрузчик.
2. Закиньте файл в папку mods.
3. Убедитесь, что версия библиотеки совместима с версией зависимого мода - обычно это указано на странице самого мода.

Важный нюанс

Не ставьте 1wholibs "на всякий случай" или просто ради коллекции. Без модов, которые её используют, библиотека - мёртвый груз: она ничего не меняет в геймплее и не даёт никаких преимуществ. Ставить её имеет смысл только когда этого явно требует другой мод.

И ещё момент: автор прямо пишет, что нормальная документация появится позже. Так что если вы мододел и хотите использовать API библиотеки в своём проекте - придётся разбираться по исходникам. Для игроков это не проблема, но разработчикам стоит иметь в виду.

Кому нужен этот мод

• Игрокам - только как зависимость для модов от 1whohears. Скачайте 1wholibs, если лаунчер или игра ругается на его отсутствие.
• Сборщикам модпаков - обязательно включайте библиотеку в сборку, если в ней есть зависимые моды, иначе у игроков будет краш на запуске.
• Разработчикам - если пишете моды и вам нужны JSON-пресеты с синком, OBJ-рендер или кастомные анимации, можно посмотреть в сторону этого API.

Короче, 1wholibs - это классическая техническая библиотека: незаметная, скучная, но без неё никуда, если вы играете с модами этого автора.