Collective

Collective представляет собой общую библиотеку с базовым кодом, используемым во всех модах автора Serilum.

Обзор

Этот мод служит центральным хранилищем данных и функций, что облегчает поддержку версий модов на Fabric, Forge и NeoForge. Использование единой библиотеки упрощает добавление новых функций и обновление уже существующих проектов — достаточно внести изменения в одном месте, чтобы они применились ко всем зависимым модам.

Возможности

• Управление конфигурационными файлами и меню настроек для всех модов, зависящих от библиотеки.¹
• Переменные, повышающие совместимость с другими проектами.
• Набор функций для предотвращения дублирования кода.²
• Событие для замены и пополнения сущностей в игре.
• Возможность включать и отключать функциональность встроенных модов.³
• Использование трансформеров доступа для работы с приватными полями Minecraft.⁴
• Сетевой код для отправки пакетов через общий исходный набор.
• Централизованная обратная совместимость при крупных изменениях версий.
• Опциональная асинхронная проверка обновлений зависимых модов с выводом в консоль.
• Управление файлами переводов для всех зависимых модов.
• И многое другое.⁵

Настройки

В Collective доступны следующие параметры конфигурации:

• enableUpdateChecker (по умолчанию true) — отображать ли в консоли сообщение о доступном обновлении для зависимых модов (асинхронно).
• transferItemsBetweenReplacedEntities (true) — переносить ли предметы и броню с заменяемых сущностей.
• loopsAmountUsedToGetAllEntityDrops (по умолчанию 100, от 1 до 500) — количество итераций для процедурного получения всех дропов мобов; снижение значения может уменьшить точность, но ускорить загрузку мира.
• findABlockCheckAroundEntitiesDelayMs (30000 мс, от 0 до 3600000) — задержка проверки наличия блока вокруг сущностей, влияет на производительность.
• enablePatronPets (true) — включение питомцев для патронов (будет добавлено в будущем обновлении).
• downloadNonEnglishTranslations (true) — попытка загрузки переводов при использовании языка клиента, отличного от английского.
• pushTranslationResourcePack (false) — на сервере отправлять ресурс-пак игрокам без Collective для отображения названий предметов на их языке.
• requireTranslationResourcePack (true) — делать ресурс-пак обязательным, при отказе игрока он будет отключен и запрошен снова при следующем подключении.
• serverLanguage (en_us) — язык отображения текста модов для игроков без Collective и без ресурс-пака.
• itemNameTranslationMode (auto) — режим отображения названий предметов у игроков без Collective при отключённом ресурс-паке: auto — копировать язык первого игрока; server — использовать язык сервера; client — язык клиента (но без Collective будут видны ключи).

Описание

1. Collective реализует собственный модуль конфигурации, добавляющий в игру меню настроек и сохраняющий файлы в папке .minecraft/config/. Это необходимо из-за использования мультизагрузочного шаблона, который не поддерживает встроенную конфигурацию Common-кода.
2. Библиотека содержит множество полезных функций, позволяющих избежать повторения кода в зависимых модах, что значительно упрощает их обновление и сопровождение.
3. Collective позволяет собирать пакеты модов с возможностью включения и отключения отдельных компонентов через удобный код.
4. В моде используются трансформеры доступа для работы с приватными полями Minecraft, что обеспечивает организованное и централизованное управление такими изменениями.

Использование и совместимость

• Collective можно свободно использовать в любых сборках модов при условии, что загрузка осуществляется через официальные платформы CurseForge или Modrinth.
• Поддерживается работа с модами на Fabric, Forge и NeoForge.

Поддержка и обратная связь

Комментарии к моду отключены. Для сообщений об ошибках, предложениях или идеях рекомендуется использовать официальный трекер на GitHub.