Sodium Options API

Sodium Options API - это библиотечный мод, который решает одну конкретную проблему: как мододелам добавлять свои настройки в меню оптимизационных модов Sodium и Embeddium без костылей. Если ты когда-нибудь пытался впихнуть свой блок опций в стандартное меню Содиума, ты знаешь, что это та ещё головная боль. Этот API даёт единый набор событий для Fabric, Forge, NeoForge - пишешь один код, а работает везде.

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

Как это работает для разработчиков

Подключаешь зависимость через maven (релизы на Modrinth и CurseForge - сам найдёшь), а потом используешь события из пакета toni.sodiumoptionsapi.api:

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

Пример кода:

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

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

Что в итоге

Sodium Options API - must-have для любого создателя аддонов под Sodium/Embeddium. Если ты собираешь модпак на производительность - рекомендую добавить и его, и Reese's Options, чтобы у игроков был нормальный доступ к настройкам. На слабых ПК это не скажется, а вот на удобстве - ещё как.

Версии: есть под Minecraft 1.20.1 (Fabric/Forge/NeoForge с Sodium 0.5/Embeddium) и 1.21.1 (Fabric/NeoForge с Sodium 0.6). Скачивай, подключай и не парься с совместимостью.