Sodium Options API

Если вы играете с пачкой аддонов на Содиум (Sodium) для Майнкрафт, то наверняка замечали, что их настройки часто раскиданы по всему меню или криво отображаются. Sodium Options API - это клиентская библиотека, которая наводит порядок в этом хаосе. По сути, это прослойка для других модов, которая дает разработчикам единый инструмент для интеграции своих опций в меню Sodium и Embeddium.

Зачем это нужно обычным игрокам

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

Тут есть важный нюанс - авторы встроили блэклист для Flashback, Axiom и Dynamic FPS. Это значит, что их настройки больше не будут ломать меню Содиума или отображаться там, где не надо. Они просто там не появятся, что избавляет от багов интерфейса.

Для разработчиков аддонов

Для тех, кто пишет свои моды, Sodium Options API - это настоящий мастхэв. Больше не нужно писать отдельный код под Fabric Sodium 0.5 на Minecraft 1.20.1, а потом переделывать его под NeoForge Sodium 0.6 на 1.21.1. Достаточно зарегистрировать страницу через одно событие:

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

Библиотека предоставляет три основных события в пакете toni.sodiumoptionsapi.api:

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

Совместимость и технические нюансы

Проект поддерживает широкий спектр версий: от Minecraft 1.20.1 до свежих 1.21.4-1.21.5. Работает на всех популярных загрузчиках - Fabric, Forge и NeoForge. Для NeoForge на версии 1.21.1 актуален билд 1.0.10, где пофикшены баги совместимости с Reese's Options.

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

Если вы собираете большую сборку модов с упором на оптимизацию FPS, Sodium Options API поможет избежать конфликтов в настройках. Скачайте Sodium Options API и забудьте про кривые вкладки в меню опций.