Modscraper Modscraper Minecraft
Sodium/Embeddium Options API logo

Sodium/Embeddium Options API

Mod

by Txni

Config API for adding Sodium/Embeddium options with a better categories menu

Type

Mod

CurseForge Downloads

83,264,207

CurseForge ID

1103431

Modrinth Downloads

21,324,570

Modrinth ID

Es5v4eyq

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.

description_81b22102-8cb4-4adc-843f-5a033bb00637.png

  !<a href= !<a href= !<a href=

description_7d2b55fa-b9e2-4316-9e65-5b76a7178843.png

 

description_3231908d-3908-4d39-80c5-d0d498161ca2.png

 

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

Neoforge

Game Versions

1.21.5

Recommended Gear

Affiliate

Hardware and extras that pair well with this mod.

As an Amazon Associate I earn from qualifying purchases.

Screenshots

Similar Mods

Included in Modpacks (2,063)

Show fewer
Craft 4 Dead Craft 4 Dead Farm and Friends Farm and Friends Tinker's Create [Fabric] Tinker's Create [Fabric] Yumema SMP Yumema SMP The Mainding - SaluoMT - Rutboy12 The Mainding - SaluoMT - Rutboy12 Warium Dead War Modern vs Medieval Warium Dead War Modern vs Medieval Zylla's MineColonie: Medieval Crafting & Creation Zylla's MineColonie: Medieval Crafting & Creation Fishing With The Boys Fishing With The Boys Cave Factory --Reimagined-- Cave Factory --Reimagined-- Terraclysm Terraclysm Infetion Z: TACZ x Parasite Infection Infetion Z: TACZ x Parasite Infection Wyrmfell Wyrmfell Snorland Cobblemon Snorland Cobblemon Create & Conquer Create & Conquer Tinkers Construct Pack TCP Tinkers Construct Pack TCP Powers And Mayhem Powers And Mayhem World Slasher World Slasher EggsWithChips JJK EggsWithChips JJK Shader Support Shader Support Crafted Chaos Crafted Chaos Celeste Create Hell: REFORGED Celeste Create Hell: REFORGED The TVA The TVA [SmittieKing] Antarctica [SmittieKing] Antarctica Zoo and Adventures Forge Edition Zoo and Adventures Forge Edition Seasons of Survival Seasons of Survival Cobblemon - The Temporia Region Cobblemon - The Temporia Region Tanjiro Craft Tanjiro Craft The Ancient Hell The Ancient Hell Satisfactory in Minecraft Satisfactory in Minecraft Cobblemon Trailblazers Cobblemon Trailblazers Two Tails Craft Two Tails Craft Create Sandwich Madness Create Sandwich Madness LINDENFELD - Via Gastronomica LINDENFELD - Via Gastronomica ZonaCero Apocalypse Enhanced ZonaCero Apocalypse Enhanced All in One (SCP universe+) All in One (SCP universe+) Dreamy Hollow - A Wonderful Cozy Experience Dreamy Hollow - A Wonderful Cozy Experience Gruelling Survival [FORGE] Gruelling Survival [FORGE] Medieval Survival X - OLD Medieval Survival X - OLD Memories  -Analog Horror- Memories -Analog Horror- Motors & Rotors Motors & Rotors The Builder's Paradise The Builder's Paradise Late Long Nights Late Long Nights Create - Tamed Frontiers Create - Tamed Frontiers Let's Create - The First Edition Let's Create - The First Edition Faga's Cobblemon & Create Faga's Cobblemon & Create Vanilla Deluxe Edition Vanilla Deluxe Edition The Maze Runner - A Fully Immersive Experience The Maze Runner - A Fully Immersive Experience Create Areo Naughts Create Areo Naughts THE VAULT BRUTAL FACTIONS THE VAULT BRUTAL FACTIONS New World Awakened New World Awakened V's Fantasy Modpack V's Fantasy Modpack Winter Leveling Winter Leveling Professional Weaponry Professional Weaponry GHyst Distant Horizons GHyst Distant Horizons SharkSquad Modpacks SharkSquad Modpacks CrazyCrafters 3.0 CrazyCrafters 3.0 MakeShift MakeShift Technia GTe Technia GTe Isekai DX Isekai DX Sneykor's Cobblemon online Sneykor's Cobblemon online Create Next to the Sky Create Next to the Sky Artemiscraft: Awakening of the Elements Artemiscraft: Awakening of the Elements I Heard it Too (UNOFFICAL) I Heard it Too (UNOFFICAL) Create & Electrics Create & Electrics Myths & Ruins (RPG) Myths & Ruins (RPG) Slightly Realistic Survival Slightly Realistic Survival Requiem Black Dawn Requiem Black Dawn Super Enhanced Visuals Super Enhanced Visuals  A Parallel Universe A Parallel Universe RISAKU project RISAKU project TLT - The Lost Tape TLT - The Lost Tape Silent Watcher (Horror) (Stalker) (Twixxel) (Scary) Silent Watcher (Horror) (Stalker) (Twixxel) (Scary) Jimmu's Factory 2 Jimmu's Factory 2 Ice, Fire, & Gunpowder Ice, Fire, & Gunpowder More Than Mining 2- More Mining More Than Mining 2- More Mining Slop Shooter 3000 Slop Shooter 3000 The Collective, The Aeronautical Edition The Collective, The Aeronautical Edition From the Stone Age to the Stars From the Stone Age to the Stars Prehistoric Nature Prehistoric Nature Eight Seas Eight Seas Hide Or Hunt [TACZ] Hide Or Hunt [TACZ] Leyendas de Teagarden Pyroven Leyendas de Teagarden Pyroven Dimensions Expanded Dimensions Expanded Sky Greg Fork Sky Greg Fork Realms of Simia Realms of Simia Dragon Mine Z - Astral Dragon Mine Z - Astral ExtremeCraftz ExtremeCraftz MCBR Cobblemon - Mobile MCBR Cobblemon - Mobile Beboucraft Beboucraft Mechs & Mysteries Mechs & Mysteries LONELY PLACE [ANALOG HORROR EXPERIENCE] LONELY PLACE [ANALOG HORROR EXPERIENCE] -DCX- [A Flesh Paradise] -DCX- [A Flesh Paradise] PARANOID - Beyond Sanity PARANOID - Beyond Sanity Kingdom HeartCraft Kingdom HeartCraft Dragon Mine Z Galaxy Dragon Mine Z Galaxy Aetherium Forge Aetherium Forge Feudal Fantasy Feudal Fantasy Create Waves Create Waves Soft Gun and Thin Rain Soft Gun and Thin Rain Jurassic Block World Jurassic Block World

External Resources