Sodium/Embeddium Options API
Modby Txni
Config API for adding Sodium/Embeddium options with a better categories menu
Type
Mod
CurseForge Downloads
83,264,207
CurseForge ID
Modrinth Downloads
21,324,570
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.
Minecraft Enderman Character Plush
Enderman plush toys, and a reliable gift for a younger player.
Mini PC for Self-Hosting
A low-power box that can sit in a cupboard and run a modded server around the clock.
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
Create and Adventure With Friends
Silver's Cobblemon
Star Wars Galaxy Exploration
Corrupted (The Broken Script)
Potato RPG - Performance Meets Adventure
Sinborn Odyssey 2
BossCraft Milu's Edition
Unseen - (VHS Horror) (Found Footage)
Adventure Wildfront
Project SCP (Discontinued)
Redwolf's Crazy World
Aeronautics Cookie Edition
Oasis Tropic
Lovebirds
Mitte-Erde
All About Factory - Industrial Tech & Automation
SCP Site Roleplay
Farmer's Chill Life
BiteForceMC Cobblemon
CreateMore
Descend In The Madness
FNAF: Reborn
the horror of the dwellers and more
ZenCobblemon
EverWyn Survival
Ride & Reign
Omniverse Heroes
Phantasmagoria
Create Refabricated
Weedie's Industrial Fantasy
EwMedieval Modpack
Create Mod-Attack
Community Horror Pack
Karmalandia Oficial BY KKurotsukii
The Dark Spiral
Gex RPG
BurningCube
Christmas Fantasy
Atlas Project
![Create - Water Worse Than Lava [ALPHA]](https://media.forgecdn.net/avatars/1753/754/639116115448655608.png)
Create - Water Worse Than Lava [ALPHA]
Adventurecraft: Create Editon
Cozymon Adventure
Survival Refined
Comfycraft
Dark Hours
MafiaCraft
All About Aether - Sky Dimension Adventure
Only Create
Daldon's Immersive Survival
Horror Mod (VR Compatible)
Nin's Swem Dream
CrazyPimp Saison 1
KC's Fantasy Kingdom
Government
Cauchemar
AmongFriends
Imperialist - Medieval Ages
ATMIL - All The Mods I Love
Oathbound
The Bedrock Road -
Hero's N Villain's Reborn
THE PARELLEL
Apollyon's Inferno
Untitled Modpack - Hard Survival
Grubbs' Cozy Craft
DittoLand Cobblemon
Faes & Frogs - Fabric
Empires of Steam & Sky
Create Unending
The Homestead Saga
OuiOuiCreate
La Colonie
![GoatCraft BMC++ 4 [Forge]](https://media.forgecdn.net/avatars/1591/243/639029306165950574.jpeg)
GoatCraft BMC++ 4 [Forge]
CobbleQuests
WorkLoad
BODYCAM (Immersive edition)
Valley Chill
Pepperson's RPG
Steamland - SP
Homestead Cobble
Create Even Further Beyond
Riders Race to Berk
PurgatoryMC
TCG SMP - Prologue (Public)
Advent For Adventure
PandaLand Pack
Weather+
Fat dragon adventures
Masters Of Aeronautics
The Suncat Express
RattcoreRevived
Tiganj - Dark Fantasy RPG
Hero To Zero
OverGreg
Aetas
AetherFall - Echos of Vilorian
Lo-RPG Maygk Adventure
Society Sunlit Valley Enhanced
Slimes SMP Forever World
ForTheGoons (BCG +Cobblemon)