Configuration

Коротко #what

Configuration — библиотека/зависимость: собственного игрового контента почти не добавляет, её используют другие моды. Версия и назначение видны в карточке; если мод не запускается, проверьте эту библиотеку.

Библиотека в сборке #library-presence-20261104

Configuration входит в состав сборки и предоставляет общие возможности использующим её модам. Установленная версия — 3.1.0; её общие классы используются совместно с другими модами.⁠^[3]

Рецепты и применение устройств описаны в статьях соответствующих модов. При переходе к ним выбирайте ту же сборку: её игровые возможности определяются полным составом модов и настройками.

Автоматическая генерация конфигов и синхронизация #shared-overview-20261114

Configuration — компактная техническая библиотека для декларативного описания и хранения настроек модификаций на базе аннотаций в коде.⁠^[2] Она избавляет авторов крупных технических и контент-модов от ручного разбора файлов TOML, JSON и YAML, обеспечивая типобезопасную загрузку всех параметров сразу при старте клиента и сервера.

Важное преимущество библиотеки — автоматическое построение удобного внутриигрового меню настроек на клиенте и корректная синхронизация серверных правил (например, баланса рецептов или параметров мультиблоков) при подключении игрока к выделенному серверу.⁠^[4] Диапазоны допустимых значений, комментарии-подсказки и типы полей проверяются до того, как мод успеет использовать параметр в мире.

В игровом реестре предметов Configuration не появляется: игрок никогда не встретит его в рецептах или вкладках креатива, но вся конфигурационная стабильность крупных технических систем напрямую опирается на его код. Кроме того, библиотека хранит значения по умолчанию и позволяет администратору сбрасывать или валидировать отдельные категории без остановки игры.⁠^[2]