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.
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
Lyrran's BattleCraft
Experium - VT
Explorifying
ERMOS
Shattered Crown
Steam Gardens SMP
TPW: Redux
Fir3fr0gPersonalPack
Centuries: Age of Ruins
Flying Delight Modpack
HoM - Cobblemon World
B.O.B.PACK
Iter Mutabilus: The Spread of Creation
Holiday blocks
Shattered Dimensions- Mechanisms and Grimoires
Koala's Silly Lil Community Pack Season 2
WonsatyPack 3
PeninsulaCraft
Better client
Geeks Of Create
Cobbleish
Juniper's Legacy
Friendly Adventures
Voiding of World
fantasy mc
ImmersiCraft
RothCraft
Truly Vanilla
lilyoupro scary modpack
LyzOPTP
Teble's Medieval Immersion
Crazy Phaze
Ethereal Wrath
Frost And Fungus
Better Than Nothing
Better Create
Titanroot Skies
OptimNVC QoL
NEOptimized
Cobblemon Cobalt Edition
MC Sooty Edition
Carefully Created
ZenCobblemon
create simple cool
Create Zerene
EwCreate Modpack
World of Dwarven Caverns
Vanilla Create
CreatingNations
ForgeSMP
Chill, Relax & Craft
Revolution
AdventureCogwheels
Guaropolis Lite
Rebio SMP
Create Me a Home
Great MC
THE WONDERLAND
Cobblemon Rejects
Auralith Server
True Horror
Seecrets of the Dwarves
Cypher