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.
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.
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
Create: Perfect Colonies
Project Eternity A New Vision
cursed chainsaw demon city
Horror from the Zombie Horde
Beta Rising
Ultimate Create Experience
DUTCH LIKES TOES
Techno Vanilla
It's Hero Time (Alien Evo)
Create: Solarpunk
Sky Ground Next Level
Miztopia 2.0
StonksCraft 2 LITE
CrazyMC - A Special Apocalypse | Apocalypse with Quests!
Bon The Rabbit unofficial
Irregulados
Dark Lucky Apocalypse
Liminal Spaces - (Faithful Backrooms)
Metamorphosis
Mutants & Multiverses
CoZY Miners
The Convergence
Cobblemon Eclipse
Age Of Assembly
Everfall - Descent into Disease
NVPack
MMW - Minecraft My Way
Forbidden Engine Of Conquest
Prehistoricraft - The Prehistoric Experience
He Follows
Fennix RPG - Fantasy Horizons
RETURNED!
MineFantasy
Cogs & Cobblemon
Mechanical suffering
Hub-Craft
Yenryong's DinoCraft
Casci's Superheroes
Camp Cobblemon - Lightly Modded Cobblemon + Builder Tools
OneBlock Evolution
Banglaspider-man's Omni-adventures
Crafterria: Genes & Gears
ChillCraft - Play Your Way Chill Your Way (Neoforge)
DonCraft
Eternal of Legends
IRONFALL; Annihilation
Farlands - Origins Of The Olimpus
![AstralSpace [AS]](https://media.forgecdn.net/avatars/1650/747/639053242722186086.png)
AstralSpace [AS]
ChaosCraftZ Apocalypse
DeadZone Brasil - DeceasedCraft
The HORROR TERROR
Fortnite 3: Victory Royale
The Script is Broken
Arkobia 2
RotomWorks
MayemCraft
![[SmittieKing] Saskatchewan](https://media.forgecdn.net/avatars/1203/401/638780892282482431.png)
[SmittieKing] Saskatchewan
Bee Valley Cute Edition
Berezka's SCP
Dinossaur Era
Kryeit Gold
Survival Smp Mod Pack
Mustard Craft
MineColonies: safe and sound
Jujutsu Kaisen A Sorcerer's Path
Goonables
PossessedArmor's Random Starters Cobblemon
Ironvale - Quests, Fantasy, RPG, Medieval
Sitchen Kink
AP Gaming - Empowered Apocalypse
wonderland immersive
Mine Piece Essentials
The One And Only Mania
Jujutsu Kaisen Modern ERA-Cursed Fate
Chunk by Chunk Advanced
All About Cobblemon - Pokemon World ( Catch, Build, Explore )
MENAGERIE - Paradoxical Wilds (Jurassic World based on Marvelous Menagerie)
Shenanigans
Blighted Dreams
Ranchers of Pixel Valley
Meteors Incoming
Death Knights and Guns
Cogcrafter
Kreyc's Waterworld
Ascension of the Archmage
The Broken Script: Shattered Reality
Untagged & Untitled+ (UAU+)
TURKEY SANDWICH CRAFT
Prismatica
Kindle's Aeronautics
Velmont Equestrian
![2Gather [Aeronautics]](https://media.forgecdn.net/avatars/1729/352/639100464334833845.png)
2Gather [Aeronautics]
![Creative Colonies - [Build, Automate, Thrive]](https://media.forgecdn.net/avatars/1522/70/638988436755415573.png)
Creative Colonies - [Build, Automate, Thrive]
VOID-BOX2
Roziaria
Wasteland Winter
CloverCraft (Season 1)
Project Z - Zombie Apocalypse
ERASED - NEW DAWN
Tinkerer Kingdom