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
Mayview (with Cobblemon!) Mayview (with Cobblemon!) More Realistic [FORGE] - 1.21 UPDATE! More Realistic [FORGE] - 1.21 UPDATE! Restless Horizons Restless Horizons More FPS [FABRIC] - SHADERS 1.21.11! More FPS [FABRIC] - SHADERS 1.21.11! Island Adventure - Complete Overhaul | Now with Quests! Island Adventure - Complete Overhaul | Now with Quests! New Age - Welcome To The Medieval Era | MEDIEVAL QUESTS UPDATE! New Age - Welcome To The Medieval Era | MEDIEVAL QUESTS UPDATE! Christmas Holidays - Ideal For Festivities | Christmas Quests Update! Christmas Holidays - Ideal For Festivities | Christmas Quests Update! Planeta Vegetta (Unofficial) Planeta Vegetta (Unofficial) Dontcry (Official) Dontcry (Official) Better Realism MC | Vanilla+ & Realism (Based on RealismCraft) Better Realism MC | Vanilla+ & Realism (Based on RealismCraft) Cobblemon Realms Cobblemon Realms Attack On Titan - Awakening Of The Titans Attack On Titan - Awakening Of The Titans Crafted Crazy (crazy craft updated!) Crafted Crazy (crazy craft updated!) Concatenation Concatenation More Biomes [FORGE] - 1.21 UPDATE! More Biomes [FORGE] - 1.21 UPDATE! Dragoncraft Dragoncraft Cobblemon Cobbletwo X MegaShowdown [1.7.3] (Pokemon Modpack) Cobblemon Cobbletwo X MegaShowdown [1.7.3] (Pokemon Modpack) Project -  Arcane Frontier Project - Arcane Frontier Reimagined Reimagined Verity Pack Verity Pack Roguelike Adventures and Dungeons 3 Roguelike Adventures and Dungeons 3 Speed Of Light FPS Booster (SOL) With Shaders Speed Of Light FPS Booster (SOL) With Shaders Essentials Mods [FABRIC] - 1.21 RELEASE! Essentials Mods [FABRIC] - 1.21 RELEASE! Modded Together Modded Together Beyond Ocean Beyond Ocean Vampires Strike Back Vampires Strike Back From Magic To Tech From Magic To Tech TerraFirma: Rebirth TerraFirma: Rebirth Tactical Survivor Tactical Survivor HORROR - A Quiet Place -  Death Angels HORROR - A Quiet Place - Death Angels Prehistoric World 2 | Unusual Prehistory 2, Dinosaurs, Quests & More Prehistoric World 2 | Unusual Prehistory 2, Dinosaurs, Quests & More HORROR - The silent forest - Siren Head (horror) HORROR - The silent forest - Siren Head (horror) Zombie Apocalypse: Last Days in the Wasteland | Survive Hordes of Zombies Zombie Apocalypse: Last Days in the Wasteland | Survive Hordes of Zombies Mastering Magic | A Magic World with Quests! Mastering Magic | A Magic World with Quests! A Distant Journey A Distant Journey Fabri's Frontiers Fabri's Frontiers Peachy's Pixel Place (Equestrian, Adventure & Farming) Peachy's Pixel Place (Equestrian, Adventure & Farming) More Dungeons [FORGE] - QUALITY UPDATE! More Dungeons [FORGE] - QUALITY UPDATE! Agmundr - Zombie Apocalypse Agmundr - Zombie Apocalypse Frozen Apocalypse | Survive the Ice Age Apocalypse Frozen Apocalypse | Survive the Ice Age Apocalypse More Animals [FABRIC] - 1.21 UPDATE! More Animals [FABRIC] - 1.21 UPDATE! Resurvival Resurvival Jurassic Terror - A horror jurassic experience Jurassic Terror - A horror jurassic experience Sky Greg Sky Greg Conquest of Dragons - A New Dragons Adventure | QUESTS UPDATE! Conquest of Dragons - A New Dragons Adventure | QUESTS UPDATE! Bountiful Farming - (formerly A Farmer's Delight) Bountiful Farming - (formerly A Farmer's Delight) HazardousDaniel's Unlimited 2.0 HazardousDaniel's Unlimited 2.0 Real realistic world (realistic) (realistic world) Real realistic world (realistic) (realistic world) Tanks, Ammo, Planes, and Nukes Tanks, Ammo, Planes, and Nukes Zombie R.E.A.P Plague Against Your World. Zombie R.E.A.P Plague Against Your World. Create: Lost in Space Create: Lost in Space Create Colonies - AERONAUTICS Create Colonies - AERONAUTICS Calamycraft Calamycraft Lucky World Invasion - Hardcore Lucky World Invasion - Hardcore PandAce's World PandAce's World Immersive Pixelmon - A New Pokemon Era (with Distant Horizons, Pixelmon & Quests) Immersive Pixelmon - A New Pokemon Era (with Distant Horizons, Pixelmon & Quests) Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Fantasy RPG - RPG Quests, Bosses & Magic | Fantasy & RPG Exosphere 2 Exosphere 2 Better FPS & Visuals Boost FPS (Forge) Better FPS & Visuals Boost FPS (Forge) Whispers in the Void - A Horror Adventure & Quests | Horror Mobs! Whispers in the Void - A Horror Adventure & Quests | Horror Mobs! Create Evolution - With Create 6.0 and Quests! | +35 Create Addons Create Evolution - With Create 6.0 and Quests! | +35 Create Addons Compression Compression Holycube Revolution Holycube Revolution Mystic's Monstrosity Mystic's Monstrosity Create Live 6 Create Live 6 World Terra World Terra Actions on Java Actions on Java [TaCZ] Guns & Customs - Beta Entry [TaCZ] Guns & Customs - Beta Entry Remain [Zombie + SCP Apocalypse] Remain [Zombie + SCP Apocalypse] Cobblemon Freedom Frontiers Cobblemon Freedom Frontiers Create Aeronautica Create Aeronautica HP - Create World of Gears - Create 6.0.9 HP - Create World of Gears - Create 6.0.9 DEADZONE - Multiplayer Zombie Apocalypse DEADZONE - Multiplayer Zombie Apocalypse MC Vanilla 2.0 - QUALITY UPDATE! MC Vanilla 2.0 - QUALITY UPDATE! Roanoke Cobblemon Roanoke Cobblemon Dinosaur Horror Project Dinosaur Horror Project Infinite Horizons - Modded Superflat Survival Infinite Horizons - Modded Superflat Survival Adventure Life - Legacy Adventure Life - Legacy Creepy [ Horror ] Creepy [ Horror ] Easycraft (Official) Easycraft (Official) A broken world (The broken script) A broken world (The broken script) Cobblemon Apex Cobblemon Apex Create: New Horizon Create: New Horizon Danny's AOT - Titan Chronicles Danny's AOT - Titan Chronicles Create - Forge Frontier Create - Forge Frontier Cobblemon Plus+ The Top Pokemon Adventure in Cobblemon - Cobblemon 1.7.3 - Mega Cobblemon - Pokemon Legendaries - Fully Optimize Cobblemon Plus+ The Top Pokemon Adventure in Cobblemon - Cobblemon 1.7.3 - Mega Cobblemon - Pokemon Legendaries - Fully Optimize More Decorations [FABRIC] - 1.21 UPDATE! More Decorations [FABRIC] - 1.21 UPDATE! The Annoying Villagers Remastered The Annoying Villagers Remastered Desecrated - Flesh and Blood Desecrated - Flesh and Blood Lees Zombie Apocalypse - Fallen Earth Lees Zombie Apocalypse - Fallen Earth Origins Revolution | With Origins & Origins Addons Origins Revolution | With Origins & Origins Addons Rhinocraft Rhinocraft HORROR - The corrupted clan - The Broken Script (dweller) (stalker) HORROR - The corrupted clan - The Broken Script (dweller) (stalker) #1 One Prime Piece #1 One Prime Piece Vintage Wilds Vintage Wilds Rubius cobblemon Rubius cobblemon Create Eternal Journey Create Eternal Journey Cobblemon Ultimate Pokemon RPG - Cobblemon 1.7.3 - Cobblemon with Friends  - Pokemon in Minecraft -  Pokemon RPG & MMO Cobblemon Ultimate Pokemon RPG - Cobblemon 1.7.3 - Cobblemon with Friends - Pokemon in Minecraft - Pokemon RPG & MMO [MODIFIED] Cobblemon: OVERCLOCKED! [MODIFIED] Cobblemon: OVERCLOCKED! Beyond Depth Insanity Beyond Depth Insanity

External Resources