Collective

Collective - это базовая библиотека с общим кодом, без которой не запустится ни один мод от автора Serilum. По факту, это фундамент. Вы не найдете тут новых блоков или мобов, но именно этот проект заставляет всё остальное работать стабильно.

Мод объединяет общие функции для Fabric, Forge и NeoForge, что сильно упрощает поддержку проектов на разных загрузчиках. Когда автор обновляет какую-то механику, ему не нужно переписывать код в десятке отдельных модов - достаточно обновить Collective. Это экономит время и избавляет от багов. Если вы собираете свою сборку модов для Minecraft и ставите туда проекты от Serilum, без этой библиотеки они просто не запустятся.

Что делает мод под капотом

• Управление конфигами - создает файлы в .minecraft/config/ и добавляет меню настроек прямо в игре.
• Совместимость - содержит переменные, которые помогают модам лучше дружить друг с другом.
• Вспомогательные функции - убирает дублирование кода, забирая всю рутину на себя.
• События для замены энтити - позволяет пересоздавать мобов с сохранением их лута и брони.
• Управление бандлами - если вы скачали пакет модов, Collective позволяет включать или выключать отдельные проекты.
• Access Transformers/Wideners - открывает доступ к приватным полям игры для тонкой настройки.
• Сетевой код - отправляет пакеты через Common source set.
• Обратная совместимость - централизованно решает проблемы при переходе на новые мажорные версии Майнкрафт.
• Проверка обновлений - асинхронно пишет в консоль, если вышла новая версия зависимого мода.
• Переводы - управляет файлами локализации для всех модов, которые от него зависят.

Настройки и конфиг

Библиотека имеет свой конфиг. Вот основные параметры, которые могут пригодиться:

• enableUpdateChecker (по умолчанию true) - проверка обновлений для зависимых модов.
• transferItemsBetweenReplacedEntities (true) - переносит броню и предметы, если моб был заменен другим модом. Очень полезно, чтобы не терять лут.
• loopsAmountUsedToGetAllEntityDrops (100, от 1 до 500) - количество циклов для получения всех дропов. Снижение этого значения ускоряет загрузку мира, но может сделать дроп менее точным.
• findABlockCheckAroundEntitiesDelayMs (30000, от 0 до 3600000) - задержка проверки блоков вокруг энтити в миллисекундах. Увеличение этого числа может повысить TPS, если сервер начинает лагать.
• downloadNonEnglishTranslations (true) - скачивает переводы, если язык игры не английский.
• pushTranslationResourcePack (false) - на сервере отправляет ресурспак с переводами игрокам, у которых не установлен мод.
• requireTranslationResourcePack (true) - делает ресурспак обязательным, чтобы игрок случайно не отказался от загрузки.
• serverLanguage (en_us) - язык сервера по умолчанию для тех, у кого нет мода.
• itemNameTranslationMode (auto) - определяет, как показываются кастомные названия предметов игрокам без библиотеки.

Серверная часть и переводы

Для админов тут есть полезная фишка - управление переводами. Если игрок заходит на сервер без установленного Collective, мод может автоматически выдать ему ресурспак с нужной локализацией. Это удобно, если вы запускаете сервер на BungeeHost - все кастомные предметы от модов Serilum будут отображаться корректно на языке игрока, и вам не придется переживать за кривую кодировку или отсутствие текста.

Короче, скачать мод Collective нужно каждому, кто планирует использовать проекты Serilum в своей сборке. Это обязательный технический элемент, который берет на себя всю грязную работу и гарантирует, что всё будет работать как надо.