Sodium/Embeddium Options API
Modby Txni
Config API for adding Sodium/Embeddium options with a better categories menu
Type
Mod
CurseForge Downloads
83,259,933
CurseForge ID
Modrinth Downloads
21,323,618
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.
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.
LEGO Minecraft Set
Official sets that translate the building side of the game off-screen.
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
Stormdal Cobblemon journey's 2
AestheticCraft - Cozy Adventure | MC Cozy 1.21.1
BEST Vanilla+
worldz Project Aeterna Biotec
Cave Horror Project Origins
Chronost Incorporated
Goniel's DMZ Realistic Transformations
Valiant RPG
Steam and Stardust
Create City 4 "The New Journey"
Da Boys Craft - Create Edition
BRSK Omega Protocol
Mostly Just Cobblemon
Weenie Hut NEO
Omni-Apocalypse
Pokengineers – Create to Catch
Create Continuity
The Forgotten Script (TBS) (Horror)
Dead Of Night | Horror Survival
Cobblemon: Unbound
Easy Infinite Item Duplication
Actual Mobs (smarter and stronger mobs)
Rebirth - The Dead World
Camputron Chronicles
CreateMons - COBBLEMON PACK
Eldarval Drehmal
Vampiric Realms
TACZ DreadOverhaul the horror modpack
Sword Last Onlne: The Night fall (war of underworld)
Lite Aeronautics
Prehistoric horizons - dinosaur world
Mega ors/eat
Better Third Person (BTP)
From The Caves Is Scary
CraftToMuck: Sky
V-Cube
ImprovedCraft
Civilization, Industry, and Architecture
SL Quantum Factory
The Freezing Horror
DaD-Dinosaurios y Dragones
The Last Bastion – RPG, Medieval, Dark Fantasy Survival
Farlands - Rising
Drakoria RPG - Low Profile
Grinding and industrialization GANDI 1
Cobblemon Irisian Edition
JurassicPark, Survival
WarCraft (warfare)
Casualties Unknown
Arcane or Alloy
Cryptic Dragon
Classic Evolved
Gregtech Voyager
Var's Just Create+ SMP
CogWorks SMP
Terralish - An Ultimate Boss Fight Experience
Architectoribus Datum
Recuria
Steel Block Run 1890 (Jojo, JJBA)
Gänseteich
Factory in space, a Create expedition
TerraFirma Through The Ages (TFTTA)
Generic Wasteland
Harcore 3 lives!
The Poke Isles Official Modpack
ApocalyptiCraft
The Real One On Jah II
Cuisine Craft: Restaurant Wars
Knights of the Eve
whispers in the dark_
![[OUTDATED] Cobbleland+ (Unofficial)](https://media.forgecdn.net/avatars/1275/82/638829465291251508.png)
[OUTDATED] Cobbleland+ (Unofficial)
The Convergence I
Stalkers & More
Cozy LevelZ
Leer Dungeons: Distant Horizon
RUBIUS - Cozy & magic
Magic of Create
Dungeons & Dungeoneers!
gone but not forgotten
![More FPS [Optimization]](https://media.forgecdn.net/avatars/1150/143/638717594044964899.png)
More FPS [Optimization]
Skyblock Reforged
This World Is Yours: The Roaring Hells
Heroverse SMP - Official Server
Backrooms and two balls
its in the dark.jar (horror)
The fast fredbear experience
![[ARCHIVED] Minecraft Alpha Edition](https://media.forgecdn.net/avatars/1584/271/639025451592136973.jpg)
[ARCHIVED] Minecraft Alpha Edition
ReFactory: Expert
Gooners Go Beyond
Origins ++ Magic & Friendship
The Harpy Express: Viridis
Endless Sky 2
HarvestCraftia
Karma's Cobblemon Mechanical Magic
Prisms Create
Terraria not MC
Castle and Farm
Beyond Shenanigans
Mythara+
MessCraft: Explore The World