Sodium Options API предоставляет общий интерфейс для расширения меню настроек Sodium и Embeddium на разных загрузчиках. Разработчики аддонов могут добавлять страницы, группы и отдельные параметры через события API.
Возможности для игрока
Библиотека нужна модам, которые используют её API. В сочетании с Reese's Sodium Options она также позволяет получить меню категорий с раскрывающимися списками. Для этого варианта нужны оба мода; одной библиотеки недостаточно.
Совместимость и установка
Автор приводит примеры поддержки Embeddium на Forge, Sodium 0.5 на Fabric для Minecraft 1.20.1 и Sodium 0.6 на Fabric или NeoForge для Minecraft 1.21.1. Это примеры конкретных веток, а не гарантия совместимости любого файла со всеми платформами. Выберите подходящий выпуск во вкладке «Версии» и установите его вместе с указанными зависимостями в папку mods.
API для разработчиков
Артефакт Modrinth можно добавить в зависимости среды разработки, указав нужную версию вместо version:
modImplementation("maven.modrinth:sodium-options-api:version")
В пространстве имён toni.sodiumoptionsapi.api доступны три события:
OptionGUIConstruction.EVENT— вызывается один раз при создании интерфейса и позволяет добавлять целые страницы.OptionPageConstruction.EVENT— вызывается для каждой страницы; подходит для добавления группы параметров.OptionGroupConstruction.EVENT— вызывается для каждой группы и позволяет добавлять отдельный параметр или изменять существующий.
Пример добавления страницы:
OptionGUIConstruction.EVENT.register((pages) -> pages.add(new TestOptionPage()));