Sodium/Embeddium Options API
Modby Txni
Config API for adding Sodium/Embeddium options with a better categories menu
Type
Mod
CurseForge Downloads
83,267,986
CurseForge ID
Modrinth Downloads
21,325,499
Modrinth ID
Last Updated
Nov 7, 2026
Description

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.
Compatibility
Mod Loaders
Game Versions
Recommended Gear
AffiliateHardware and extras that pair well with this mod.
LEGO Minecraft Set
Official sets that translate the building side of the game off-screen.
Mini PC for Self-Hosting
A low-power box that can sit in a cupboard and run a modded server around the clock.
Minecraft Enderman Character Plush
Enderman plush toys, and a reliable gift for a younger player.
As an Amazon Associate I earn from qualifying purchases.
Screenshots
Similar Mods
Just Enough Items (JEI)
View Items and Recipes
Cloth Config API (Fabric/Forge/NeoForge)
Config Screen API for Minecraft
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
Fabric API
Core API library for the Fabric toolchain
AppleSkin
Adds some useful information about food/hunger to the HUD
GeckoLib
A 3D animation library for entities, blocks, items, armor, and more!
Included in Modpacks (2,063)
Show fewer
Blad Pack
Artilide
Forever Building
Era do Panado II
DBA'S ModPack
GeekMon Modpack
Mine & blade
Create: Kryp
OptiMizaPion
Psychosis
Cosmus Cobblemon [Oficial]
A Minecraft server Modpack
Creators Wilds
HiLand Optimization
CobbleHelx Modpack (Cobblemon)
Game Changing Modpack
Create Vanilla Mechanics
DarkMetaKnight's Adventure Pack
43rd Flying Modpack Reborn
HighTide
RC Cobblemon
AshTech
Goober_cave_modpack
MC: They Watch
SupernovaSMP
Create Aeronautics++
Cogwheels and Wires
Age of Asbestos, Copper and Muskets.
Bad No Cookie
Worlds O' Plenty II
EwServer
Stardivers
Create: Interstellar
CreateAbility