Sodium Options API - Sodium 选项 API

这个模组添加了跨平台事件，用于集成 Sodium/Embeddium 选项菜单。比如，你可以通过一个事件，在 Forge 上的 Embeddium、1.20.1 上的 Fabric Sodium 0.5，以及 1.21.1 上的 Fabric/NeoForge Sodium 0.6 中添加一个选项页面：

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

如果你是终端用户，并且你还没有因为其他 Sodium 附属模组把这个模组作为库安装，那么你可以将它与 Reese's Options 一起安装，以获得改进后的分类菜单，并支持下拉菜单，从而更方便地导航。即使是那些不使用此 API、而是直接注入 Sodium 选项的模组，这也会生效。

这个模组部分分叉自 Embeddium categories API 和 options events，但为了支持上游 Sodium，进行了大量修改。虽然它确实会对 Reese's Sodium Options 菜单进行修改，但出于兼容性原因是通过 mixin 实现的，所以你需要同时安装这两个模组。

使用 API

首先，你需要把这个模组添加到你的开发环境中，使用 Curseforge 或 Modrinth 的 Maven 发布版本。

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

然后，这个模组在 toni.sodiumoptionsapi.api 中提供了三个事件：

• OptionGUIConstruction.EVENT：在 GUI 构造函数中调用一次，允许添加整个页面。你大概率需要的就是这个。
• OptionPageConstruction.EVENT：为每个 OptionPage 调用一次。如果你想在性能标签页之类的地方添加一组选项开关，请使用这个。
• OptionGroupConstruction.EVENT：为每个选项组调用一次。如果你想把单个选项插入到现有组中，或者修改原版选项，请使用这个。