Colors
Modrinth
Mod
Sodium Options API
Config API for adding Sodium options with a better categories menu
Minecraft product info
Important product information
Compatibility, Minecraft versions, loaders, and external source data.
Type
Mod
Access
Free
Latest version
fabric-1.21.5-1.0.11
Downloads
19 745 726
Loaders / Platforms
fabric
forge
neoforge
Minecraft versions
1.20 – 1.20.1
1.21.1
1.21.4 – 1.21.5
Categories
optimization
utility
Description
Detailed information
This mod adds cross-platform events for adding Sodium/Embeddium options menu integration. For example, you can add an option page to Embeddium on Forge, Fabric Sodium 0.5 on 1.20.1, and Fabric/NeoForge Sodium 0.6 on 1.21.1 with one event:
```
OptionGUIConstruction.EVENT.register((pages) -> pages.add(new TestOptionPage()));
```
If you're an end user, and you don't have this mod installed already as a library for another Sodium addon, you can install it alongside Reese's Options to get improved category menu, with drop-down support so that it's easier to navigate. This will take effect even for mods that don't use this API and inject into Sodium options directly.
This mod is partially a fork of the Embeddium categories API and options events, with heavy changes to support upstream Sodium. While it makes changes to the Reese's Sodium Options menu, it does so via mixin for compatibility reasons, so you will need to install both.
## Using the API
First, you will need to add this mod to your dev environment, using the Maven release for Curseforge or Modrinth.
```
modImplementation("maven.modrinth:sodium-options-api:version")
```
Then, this mod provides three events in `toni.sodiumoptionsapi.api`:
- `OptionGUIConstruction.EVENT`, called once in the GUI constructor, allows adding entire pages. This is probably the one you want.
- `OptionPageConstruction.EVENT`, called for each OptionPage. Use this if you want to add a group of toggles to the performance tab or something.
- `OptionGroupConstruction.EVENT`, called for each group of options. Use this if you want to insert a single option into an existing group, or modify the vanilla ones.
Product gallery
Project images
Screenshots and images from the original Modrinth page.
Better Options Menu
Change log
Project versions
Published versions and original Modrinth files.
fabric-1.21.5-1.0.11
Current
Release
10.04.2025
SodiumOptionsAPI Fabric 1.0.11 for 1.21.5
Supported Minecraft versions
1.21.5
Loaders / Platforms
fabric
Show changes
Port to 1.21.5
Sign in
0.3 MB
neoforge-1.21.5-1.0.11
Release
10.04.2025
SodiumOptionsAPI Neoforge 1.0.11 for 1.21.5
Supported Minecraft versions
1.21.5
Loaders / Platforms
neoforge
Show changes
Port to 1.21.5
Sign in
0.3 MB
neoforge-1.21.4-1.0.10
Release
18.01.2025
SodiumOptionsAPI Neoforge 1.0.10 for 1.21.4
Supported Minecraft versions
1.21.4
Loaders / Platforms
neoforge
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.29 MB
fabric-1.21.4-1.0.10
Release
18.01.2025
SodiumOptionsAPI Fabric 1.0.10 for 1.21.4
Supported Minecraft versions
1.21.4
Loaders / Platforms
fabric
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.88 MB
forge-1.20.1-1.0.10
Release
18.01.2025
SodiumOptionsAPI Forge 1.0.10 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.42 MB
fabric-1.21.1-1.0.10
Release
18.01.2025
SodiumOptionsAPI Fabric 1.0.10 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.86 MB
neoforge-1.21.1-1.0.10
Release
18.01.2025
SodiumOptionsAPI Neoforge 1.0.10 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.29 MB
fabric-1.20.1-1.0.10
Release
18.01.2025
SodiumOptionsAPI Fabric 1.0.10 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Fixed compat with latest Reese's Options
Added blacklist for Flashback, Axiom, and Dynamic FPS showing up incorrectly in the Options menu
Sign in
0.63 MB
forge-1.20.1-1.0.9
Release
01.01.2025
SodiumOptionsAPI Forge 1.0.9 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.42 MB
neoforge-1.21.4-1.0.9
Release
01.01.2025
SodiumOptionsAPI Neoforge 1.0.9 for 1.21.4
Supported Minecraft versions
1.21.4
Loaders / Platforms
neoforge
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.29 MB
fabric-1.21.4-1.0.9
Release
01.01.2025
SodiumOptionsAPI Fabric 1.0.9 for 1.21.4
Supported Minecraft versions
1.21.4
Loaders / Platforms
fabric
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.88 MB
fabric-1.21.1-1.0.9
Release
01.01.2025
SodiumOptionsAPI Fabric 1.0.9 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.86 MB
fabric-1.20.1-1.0.9
Release
01.01.2025
SodiumOptionsAPI Fabric 1.0.9 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.63 MB
neoforge-1.21.1-1.0.9
Release
01.01.2025
SodiumOptionsAPI Neoforge 1.0.9 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.29 MB
1.0.8
Release
23.11.2024
SodiumOptionsAPI Neoforge 1.0.8 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.29 MB
1.0.8
Release
23.11.2024
SodiumOptionsAPI Fabric 1.0.8 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.29 MB
1.0.8
Release
23.11.2024
SodiumOptionsAPI Fabric 1.0.8 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.29 MB
1.0.8
Release
23.11.2024
SodiumOptionsAPI Forge 1.0.8 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Add some extension methods for manually overriding category IDs
Sign in
0.42 MB
1.0.6
Release
18.11.2024
SodiumOptionsAPI Fabric 1.0.6 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Updated to Sodium 0.6 release
Sign in
0.29 MB
1.0.6
Release
18.11.2024
SodiumOptionsAPI Fabric 1.0.6 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Updated to Sodium 0.6 release
Sign in
0.29 MB
1.0.6
Release
18.11.2024
SodiumOptionsAPI Neoforge 1.0.6 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Updated to Sodium 0.6 release
Sign in
0.29 MB
1.0.6
Release
18.11.2024
SodiumOptionsAPI Forge 1.0.6 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Updated to Sodium 0.6 release
Sign in
0.42 MB
1.0.5
Release
29.10.2024
SodiumOptionsAPI Fabric 1.0.5 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Fix Reese's options not being found on Fabric
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.5
Release
29.10.2024
SodiumOptionsAPI Neoforge 1.0.5 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Fix Reese's options not being found on Fabric
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.5
Release
29.10.2024
SodiumOptionsAPI Fabric 1.0.5 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Fix Reese's options not being found on Fabric
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.5
Release
29.10.2024
SodiumOptionsAPI Forge 1.0.5 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Fix Reese's options not being found on Fabric
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.42 MB
1.0.4
Release
29.10.2024
SodiumOptionsAPI Neoforge 1.0.4 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.4
Release
29.10.2024
SodiumOptionsAPI Fabric 1.0.4 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.4
Release
29.10.2024
SodiumOptionsAPI Forge 1.0.4 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.42 MB
1.0.4
Release
29.10.2024
SodiumOptionsAPI Fabric 1.0.4 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Fix crash with MoreCulling on Neo
Update dependency config to error when Reese's options doesn't get installed even though i specifically set it as a dependency (thank you Modrinth launcher)
Sign in
0.29 MB
1.0.3
Release
13.10.2024
SodiumOptionsAPI Neoforge 1.0.3 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
Fix crash on dedicated servers
Sign in
0.29 MB
1.0.3
Release
13.10.2024
SodiumOptionsAPI Fabric 1.0.3 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
Fix crash on dedicated servers
Sign in
0.29 MB
1.0.3
Release
13.10.2024
SodiumOptionsAPI Fabric 1.0.3 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
Fix crash on dedicated servers
Sign in
0.29 MB
1.0.3
Release
13.10.2024
SodiumOptionsAPI Forge 1.0.3 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
Fix crash on dedicated servers
Sign in
0.42 MB
1.0.2
Release
16.09.2024
SodiumOptionsAPI Fabric 1.0.2 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
## Changelog
- Update for Sodium beta 2
Sign in
0.29 MB
1.0.2
Release
16.09.2024
SodiumOptionsAPI Fabric 1.0.2 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
## Changelog
- Update for Sodium beta 2
Sign in
0.29 MB
1.0.2
Release
16.09.2024
SodiumOptionsAPI Neoforge 1.0.2 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
## Changelog
- Update for Sodium beta 2
Sign in
0.29 MB
1.0.2
Release
16.09.2024
SodiumOptionsAPI Forge 1.0.2 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
## Changelog
- Update for Sodium beta 2
Sign in
0.42 MB
1.0.0
Release
15.09.2024
SodiumOptionsAPI Neoforge 1.0.0 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
neoforge
Show changes
## Changelog
- Initial release
Sign in
0.29 MB
1.0.0
Release
15.09.2024
SodiumOptionsAPI Fabric 1.0.0 for 1.21.1
Supported Minecraft versions
1.21.1
Loaders / Platforms
fabric
Show changes
## Changelog
- Initial release
Sign in
0.29 MB
1.0.0
Release
15.09.2024
SodiumOptionsAPI Fabric 1.0.0 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
fabric
Show changes
## Changelog
- Initial release
Sign in
0.29 MB
1.0.0
Release
15.09.2024
SodiumOptionsAPI Forge 1.0.0 for 1.20.1
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
## Changelog
- Initial release
Sign in
0.42 MB