Sodium Options API

Кросс-платформенная совместимость настроек

Эта библиотека предоставляет унифицированные события для интеграции с меню настроек Sodium и Embeddium на разных платформах. Например, одним вызовом вы можете добавить страницу настроек для Embeddium на Forge, 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 Sodium Options. Это обеспечит улучшенное меню категорий с выпадающими списками, что значительно упрощает навигацию. Эти улучшения работают даже для модов, которые напрямую внедряются в настройки Sodium без использования данного API.

Совместимость и интеграция

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

Работа с API

Для начала подключите библиотеку в свою среду разработки через Maven:

modImplementation("maven.modrinth:sodium-options-api:версия")
// комментарий: Замените "версия" на актуальный номер версии

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

• OptionGUIConstruction.EVENT – вызывается один раз при создании интерфейса настроек, позволяет добавлять целые страницы (скорее всего, это именно то, что нужно) AtOptionPageConstruction.EVENT– вызывается для каждой страницы настроек, полезно для добавления группы переключателей на вкладку производительности @OptionGroupConstruction.EVENT – вызывается для каждой группы опций, можно использовать для вставки отдельной настройки в существующую группу