Mod - Modrinth
Sodium Options API
Config API for adding Sodium options with a better categories menu
Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.
Project overview
 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.
FreeMinecraftMods decision guide
This mod is most relevant to players looking for optimization, utility on fabric, forge, neoforge. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.
The latest stored update signal is Apr 10, 2025. Older projects can still work well, but they deserve extra compatibility testing before being added to a current world or public server.
What to verify before choosing a file
- Confirm that the file is published by the credited creator on the linked official source.
- Match the Minecraft version exactly instead of relying only on a broad category label.
- Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
- Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
- Back up worlds and configuration files before testing the project in a long-term save or public server.
Compatibility at a glance
Minecraft versions in this snapshot: 1.20, 1.20.1, 1.21.1, 1.21.4, 1.21.5
Loaders and platforms: fabric, forge, neoforge
Before you install
Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.
Source, licensing, and corrections
FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.
How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information
This source record is available for discovery, but it does not yet contain enough verified description, classification, image, freshness, or compatibility information to be indexed as a full editorial page. It is therefore marked noindex and is not eligible for advertising.