ModsFinder

Sodium Options API

by Txni

Sodium Options API gives mod authors three events for adding pages, option groups and single options to the Sodium and Embeddium settings screens across loaders.

FabricForgeNeoForgeClient-side onlyGNU Lesser General Public License v3.0 onlyOpen source1.20 – 1.21.5

What it does

Authors register their settings through events in the toni.sodiumoptionsapi.api package. One event runs once when the options GUI is constructed and can add whole pages. A second runs for each option page, which suits adding a group of toggles to an existing tab such as performance. A third runs for each option group, and a developer can use it to place one option inside a group that already exists or to alter the vanilla groups. The same event code is meant to work on Forge with Embeddium, on Fabric with Sodium 0.5 for 1.20.1, and on Fabric and NeoForge with Sodium 0.6 for 1.21.1.

The project descends from the Embeddium category system and its options events, but most of the code was rewritten to target upstream Sodium. For players it replaces the category menu of Reese's Sodium Options with one that has drop-down support. That change is applied through a mixin, so Reese's Sodium Options must be installed alongside it. Mods that do not use the API but edit Sodium options directly also show the new menu. Embeddium, Fabric API and Sodium are required dependencies.

Key features

  1. Whole-page events

    A single event runs when the options GUI is built, letting an addon add an entire settings page.

  2. Per-page events

    A second event runs for each option page, so toggles can be added to an existing tab such as performance.

  3. Per-group events

    A third event runs for each option group, to insert one option into a group or modify the vanilla ones.

  4. Improved category menu

    With Reese's Sodium Options installed, the category menu gains drop-down support that makes navigation easier.

Compatibility

Latest build for each game version and loader.

1.21.5fabric-1.21.5-1.0.11Not availableneoforge-1.21.5-1.0.11
1.21.4fabric-1.21.4-1.0.10Not availableneoforge-1.21.4-1.0.10
1.21.1fabric-1.21.1-1.0.10Not availableneoforge-1.21.1-1.0.10
1.20.1fabric-1.20.1-1.0.10forge-1.20.1-1.0.10Not available
1.20fabric-1.20.1-1.0.10forge-1.20.1-1.0.10Not available
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 2

SodiumA high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.
Required
Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Required by 3 mods

Sodium Dynamic Lights1.20 – 1.21.5Sodium Extras1.20 – 1.21.5Sodium Options Mod Compat1.20 – 1.21.4

Use cases

Addon development

Developers of Sodium addons can register settings pages through one event instead of writing a separate integration for each loader.

Who it’s for: Mod developers who add settings to Sodium or Embeddium. Players can install the mod for the improved category menu of Reese's Sodium Options.

How it compares

Full comparison

Sodium Low Fire Shield is a Fabric-only client mod for 1.21.1, under the GNU Lesser General Public License v3.0 only. Podium is client-side only, open source under the MIT License, and published for Fabric and NeoForge across 1.20.1 – 26.3. Better Biome Reblend is open source under the GNU Lesser General Public License v3.0 only, client-side only, and covers Fabric, Forge, NeoForge and Quilt across 1.20 – 1.21.11.

ModLoadersGame versionsEnvironmentUpdated
Sodium Options APIFabric, Forge and NeoForge1.20 – 1.21.5Client-side only2025-04-10
Sodium Low Fire ShieldFabric1.21.1Client-side only2026-02-13
PodiumFabric and NeoForge1.20.1 – 26.3Client-side only2026-07-19
Better Biome ReblendFabric, Forge, NeoForge and Quilt1.20 – 1.21.11Client-side only2026-01-10

Questions

Does Sodium Options API need Sodium installed?

Yes. Embeddium, Fabric API and Sodium are all required dependencies, so each must be present alongside the mod.

Do players need this mod to use the improved category menu?

Players also need Reese's Sodium Options, because the menu change is applied through a mixin into that mod and both must be installed.

Which loaders and versions does the mod support?

Fabric, Forge and NeoForge builds cover 1.20 – 1.21.5, with files for 1.20, 1.20.1, 1.21.1, 1.21.4 and 1.21.5.

In the catalog

Sodium Options API is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 15,307 mods support Minecraft 1.21.5.

Optimization mods3,545Fabric modsMods for 1.21.515,307

More from Txni

All projects
Sodium Dynamic Lights1.20 – 1.21.5TxniLib1.20 – 1.21.5Sodium Extras1.20 – 1.21.5Sodium Leaf Culling1.21.1Sodium Options Mod Compat1.20 – 1.21.4Redirected1.20 – 1.21.1

Similar mods

Sodium1.16.3 – 26.3Iris Shaders1.16.5 – 26.3Entity Cullingb1.7.3 – 26.3FerriteCore1.16.5 – 26.3ImmediatelyFast1.18.2 – 26.3Sodium Extra1.16.2 – 26.3

What the author says

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…
Txni, on the Modrinth page

Official listing

Owner
Txni
Published
2024-09-15
Updated on Modrinth
2025-04-10
Facts verified
2026-10-15

Tags

OptimizationUtility
Open on ModrinthCompare