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,255,564

CurseForge ID

1103431

Modrinth Downloads

21,321,846

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
Mysticlouds - Cuteness and Chaos Mysticlouds - Cuteness and Chaos Sci-Fi Multiverse Sci-Fi Multiverse THE DISTURBED THE DISTURBED SKYMON - Cobblemon SKYMON - Cobblemon Sin's create Sin's create Zombie World - Resurrecting Civilization Zombie World - Resurrecting Civilization Farming Overloaded Farming Overloaded Fantastic Frontier Fantastic Frontier Poppy Playtime Kult Craft Poppy Playtime Kult Craft CraftRooms (A backrooms experience) CraftRooms (A backrooms experience) Enchanted Genesis Enchanted Genesis FairyTALES FairyTALES Evil Hunter And Twixxel Stalker Modpack Evil Hunter And Twixxel Stalker Modpack Exploring the Universe - An Adventure between Planets (With Ad Astra & Quests) Exploring the Universe - An Adventure between Planets (With Ad Astra & Quests) FWF LuckyBlocks FWF LuckyBlocks The last of MC (The last of us recreation) The last of MC (The last of us recreation) Kawaii Craftia Kawaii Craftia Dontcry ( Official ) Dontcry ( Official ) Project Spacee Project Spacee Takeover: Modern Warfare Modpack Takeover: Modern Warfare Modpack Create Overlord Aeronautics Update Create Overlord Aeronautics Update Stargate20 Stargate20 OptiMobile (Forge) OptiMobile (Forge) SMP | Somake Server SMP | Somake Server The Corrupted Aftermath The Corrupted Aftermath ArcanumLand ArcanumLand Prehistoric Emergence Prehistoric Emergence [ Alone on a Raft ] Ocean survival world with vast islands, dangerous, sea creatures, boat [ Alone on a Raft ] Ocean survival world with vast islands, dangerous, sea creatures, boat Verity [ Horror ] Verity [ Horror ] Cobbelmon (CKnight) Cobbelmon (CKnight) Thormen 1.21.1 - Mekanism -  Spaceships -  ICBMs -  Force Fields -  Nuclear Science  -  Voltz successor - Modpack server running Thormen 1.21.1 - Mekanism - Spaceships - ICBMs - Force Fields - Nuclear Science - Voltz successor - Modpack server running Apocalypse Begins [Zombie Apocalypse] Apocalypse Begins [Zombie Apocalypse] One Piece Grand Blue - (Mine Piece) One Piece Grand Blue - (Mine Piece) The Forest - The Ultimate Survival Horror Pack The Forest - The Ultimate Survival Horror Pack Factorio: Nuclear (OxMODPACK) Factorio: Nuclear (OxMODPACK) Danny's Aot with FTB quests (Fan made) Danny's Aot with FTB quests (Fan made) no_moon.jar with 000.jar no_moon.jar with 000.jar Keo Create Optimized Keo Create Optimized CRETANIA CRETANIA Just Forever Just Forever JJK Extra Cursed Fate JJK Extra Cursed Fate Alex's Caves: Adventures Plus Alex's Caves: Adventures Plus The Clash of Epochs The Clash of Epochs everything is random everything is random Steller: The Rise of the Kingdom Steller: The Rise of the Kingdom MC Dungeons - Reforged MC Dungeons - Reforged Crashed Crashed Beyond Crazycraft Beyond Crazycraft The Iron Lung Experience The Iron Lung Experience Ocean Depths Ocean Depths GregTech:New Beginnings GregTech:New Beginnings Cozy Experience - with Cute & Cozy Items! Cozy Experience - with Cute & Cozy Items! CobblemonOneBlock CobblemonOneBlock Keo Create Optimized Keo Create Optimized CobbleVerse + (For servers with friends) CobbleVerse + (For servers with friends) Night Terrors - VR Horror Night Terrors - VR Horror Arphex Experience Arphex Experience [MODIFIED] Cobblemon: Essentials [MODIFIED] Cobblemon: Essentials Servidor Magnatas Servidor Magnatas SharpSharp RPG SharpSharp RPG World Destroying - Apocalipse Zombie World Destroying - Apocalipse Zombie Cursed Project - Zombie Apocalypse Cursed Project - Zombie Apocalypse Z Apocalypse - A Modern Zombie Apocalypse Z Apocalypse - A Modern Zombie Apocalypse TACZ+ Add-Ons | +15 TACZ+ Add-Ons TACZ+ Add-Ons | +15 TACZ+ Add-Ons Fresh & Cozy Fresh & Cozy Unique-Social Build Your City 2 Unique-Social Build Your City 2 Project Minecolonies United Project Minecolonies United Create: Basically Everything Create: Basically Everything Real Analog Horror (Horror) (Analog) Real Analog Horror (Horror) (Analog) Fantasy Vs. Science Quarks & Magic Fantasy Vs. Science Quarks & Magic no_moon.jar - Corpse of the Broken Moon no_moon.jar - Corpse of the Broken Moon Farmystique: Farming & Magic Farmystique: Farming & Magic Dazzle Craft II Dazzle Craft II FPS FLAME [FABRIC] Performance Fps Boost and more FPS FLAME [FABRIC] Performance Fps Boost and more the twixxel stalker (horror) the twixxel stalker (horror) Digimon Two World Conspiracy Digimon Two World Conspiracy Invincible: Overdrive Invincible: Overdrive Dungeons and Bosses [1.20.1] Dungeons and Bosses [1.20.1] The Christmas Chronicles The Christmas Chronicles Train Yard Train Yard Beyond Zombie Beyond Zombie Bodycam VHS Bodycam VHS HyCraft - Fantasy and RPG (Inspired by Hytale) | Hytale in Minecraft with Quests HyCraft - Fantasy and RPG (Inspired by Hytale) | Hytale in Minecraft with Quests CuteCraft [FABRIC] CuteCraft [FABRIC] Better VR Better VR Egged Up Egged Up Pix Android Boost Pix Android Boost Legends Reborn: Medieval (LRM) Legends Reborn: Medieval (LRM) Eternal Masquerade [Vampirism, Origins, Create, MCA] Eternal Masquerade [Vampirism, Origins, Create, MCA] Builder's Toolbox | Best Building Experience Builder's Toolbox | Best Building Experience Poppy Playtime Pack Poppy Playtime Pack OneBlock OneLife OneBlock OneLife Cozy Meadows Cozy Meadows Comes Alive & The Autumn Days Comes Alive & The Autumn Days Path of Truth Path of Truth GregTech New Frontier GregTech New Frontier UMA New World UMA New World Origins Zombie Apocalypse Origins Zombie Apocalypse [DD&D] Dungeons Dragons & Dimensions [DD&D] Dungeons Dragons & Dimensions DEMISE.ZIP DEMISE.ZIP

External Resources