Sodium/Embeddium Options API

Общее меню для графических дополнений

Sodium/Embeddium Options API представляет собой клиентскую библиотеку для авторов модов, которым нужно аккуратно встроить свои параметры в экран настроек производительности. Вместо отдельных патчей под каждую реализацию разработчик получает общий набор событий, а пользователь видит новые функции там, где ожидает их найти: рядом с параметрами Sodium или Embeddium.

Проект учитывает различия между несколькими средами. Одна и та же схема интеграции может работать с Embeddium на Forge, с Sodium 0.5 на Fabric для Minecraft 1.20.1 и с Sodium 0.6 на Fabric или NeoForge для Minecraft 1.21.1. Это упрощает перенос клиентских дополнений и помогает сохранять похожую структуру меню в сборках на разных загрузчиках.

Три уровня расширения

API предоставляет три основных события. OptionGUIConstruction добавляет целую страницу параметров, OptionPageConstruction встраивает группу переключателей в существующую страницу, а OptionGroupConstruction позволяет поместить отдельную настройку в готовую группу или изменить стандартный элемент. Автор дополнения выбирает уровень вмешательства по масштабу своей функции, не перестраивая весь экран.

Библиотека частично опирается на идеи Embeddium Categories API и Options Events, но значительно переработана для поддержки основного Sodium. Сама по себе она обычно не добавляет новый игровой контент и нужна как зависимость другим клиентским модам. Поэтому удалять её из готовой сборки только из-за отсутствия заметных предметов или блоков не следует.

Польза для обычного игрока

Если Sodium/Embeddium Options API уже указан зависимостью, достаточно установить подходящий файл для своей версии Minecraft и загрузчика. Дополнительно проект можно сочетать с Reese's Sodium Options: такое сочетание улучшает навигацию по категориям и добавляет выпадающие списки, в том числе для расширений, которые напрямую внедряют параметры в Sodium.

Перед запуском стоит сверить четыре компонента: версию игры, Fabric, Forge или NeoForge, используемый вариант Sodium либо Embeddium и версию мода, который требует API. Библиотека работает на стороне клиента, поэтому её назначение связано с интерфейсом настроек, а не с логикой мира на сервере. При несовпадении веток меню может не открыться или дополнение не зарегистрирует свои переключатели.

Sodium/Embeddium Options API особенно полезен в производительных клиентских сборках с несколькими графическими расширениями. Он не ускоряет рендеринг самостоятельно, зато создаёт согласованный способ управления возможностями таких модов и избавляет пользователя от поиска разрозненных экранов конфигурации.