Sodium Options API

Единый API для настроек Sodium и Embeddium

Этот мод открывает кросс-платформенные события, которые позволяют разработчикам добавлять собственные страницы и опции в меню настроек Sodium или Embeddium. Главная фишка — один и тот же код работает сразу на нескольких связках: Forge с Embeddium, Fabric Sodium 0.5 на версии 1.20.1 и Fabric/NeoForge Sodium 0.6 на 1.21.1. Достаточно одного события, чтобы зарегистрировать новую страницу:

OptionGUIConstruction.EVENT.register((pages) -> pages.add(new TestOptionPage()));

Улучшенная навигация для обычных игроков

Если ты не разработчик, а просто пользователь, и у тебя нет этого мода как зависимости от другого аддона для Sodium — его можно поставить самостоятельно. В паре с Reese's Options он даст более удобное меню категорий с поддержкой выпадающих списков. Навигация станет заметно проще, и это сработает даже для тех модов, которые не используют этот API, а внедряют свои опции напрямую в настройки Sodium.

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

Проект частично форкнут из API категорий и событий опций Embeddium, но с серьёзными доработками под оригинальный Sodium. Изменения в меню Reese's Sodium Options вносятся через миксины — это сделано ради совместимости, поэтому оба мода должны стоять вместе.

Работа с API

Чтобы начать использовать API, подключи мод в окружение разработки через Maven-релиз с Curseforge или Modrinth:

modImplementation("maven.modrinth:sodium-options-api:version")

В пакете toni.sodiumoptionsapi.api доступны три события:

• OptionGUIConstruction.EVENT — вызывается один раз в конструкторе GUI, позволяет добавлять целые страницы. Скорее всего, тебе нужно именно оно.
• OptionPageConstruction.EVENT — срабатывает для каждой страницы опций. Подходит, если хочешь добавить группу переключателей, например, во вкладку производительности.
• OptionGroupConstruction.EVENT — вызывается для каждой группы опций. Используй его, чтобы вставить один параметр в существующую группу или изменить стандартные настройки.