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,187,740

CurseForge ID

1103431

Modrinth Downloads

21,309,413

Modrinth ID

Es5v4eyq

Last Updated

Nov 6, 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,062)

Show fewer
Better MC [FORGE] - BMC4 Better MC [FORGE] - BMC4 Cobblemon Official Modpack [Fabric] Cobblemon Official Modpack [Fabric] All the Mods 9 - ATM9 All the Mods 9 - ATM9 Prominence™ II: Hasturian Era Prominence™ II: Hasturian Era DeceasedCraft - Urban Zombie Apocalypse DeceasedCraft - Urban Zombie Apocalypse COBBLEVERSE - Pokemon Adventure [Cobblemon] COBBLEVERSE - Pokemon Adventure [Cobblemon] Better MC [FABRIC] BMC2 Better MC [FABRIC] BMC2 Beyond Depth Beyond Depth Better MC [NEOFORGE] BMC5 Better MC [NEOFORGE] BMC5 SteamPunk [LPS] SteamPunk [LPS] Fear Nightfall: Remains of Chaos Fear Nightfall: Remains of Chaos Homestead - A Cozy Survival Experience Homestead - A Cozy Survival Experience BigChadGuys Plus (w/ Cobblemon!) BigChadGuys Plus (w/ Cobblemon!) Lucky World Invasion Lucky World Invasion Prominence™ II: Hasturian Era Prominence™ II: Hasturian Era Zeefski Jujutsu Kaisen Craft Zeefski Jujutsu Kaisen Craft MC Eternal 2 MC Eternal 2 Kimetsu no Yaiba (Demon-Slayer) ModPack Kimetsu no Yaiba (Demon-Slayer) ModPack Better MC [FABRIC] BMC3 Better MC [FABRIC] BMC3 All of Create All of Create TerraFirmaGreg-Modern TerraFirmaGreg-Modern Society: Sunlit Valley Society: Sunlit Valley Cobblemon Official Modpack [NeoForge] Cobblemon Official Modpack [NeoForge] Linggango Linggango VerityCraft - A Realistic Horror Experience VerityCraft - A Realistic Horror Experience Soulrend - Dark Fantasy RPG Soulslike Soulrend - Dark Fantasy RPG Soulslike Legendary Edition Legendary Edition ArdaCraft ArdaCraft Prehistoric World - Dinosaurs, Adventure & Quests | NEW PREHISTORY UPDATE! Prehistoric World - Dinosaurs, Adventure & Quests | NEW PREHISTORY UPDATE! Otherworld [Dungeons & Dragons] Otherworld [Dungeons & Dragons] Medieval MC [FORGE] MMC4 Medieval MC [FORGE] MMC4 Biohazard: Project Genesis - The Ultimate Apocalypse Biohazard: Project Genesis - The Ultimate Apocalypse New Game - An Improved Experience | 1.21 UPDATE! New Game - An Improved Experience | 1.21 UPDATE! Cisco's Fantasy Medieval RPG [Dragonfyre] Cisco's Fantasy Medieval RPG [Dragonfyre] All of Create - Aeronautics All of Create - Aeronautics Create Chronicles: The Endventure Create Chronicles: The Endventure Keo optimized Keo optimized Homestead Homestead Ascendra Ascendra From the Fog Reimagined From the Fog Reimagined Lost World - The Broken Script Lost World - The Broken Script Beyond Ascension Beyond Ascension Just Create SMP Just Create SMP Age of Fate Age of Fate More FPS [FORGE] - Increase FPS & Shaders (1.21 UPDATE) More FPS [FORGE] - Increase FPS & Shaders (1.21 UPDATE) Essentials Mods [FORGE] - 1.21 RELEASE! Essentials Mods [FORGE] - 1.21 RELEASE! Cute Craft Cute Craft Omnicraft: Ben 10 [Alien Evo] Omnicraft: Ben 10 [Alien Evo] Beyond Cosmo Beyond Cosmo SUPERIOR - RPG SUPERIOR - RPG Mystic Horizons​ Mystic Horizons​ Techopolis 3 Techopolis 3 Verity virtual assistant (horror) Verity virtual assistant (horror) New Simple Mods - Easy to Understand | 1.21 UPDATE! New Simple Mods - Easy to Understand | 1.21 UPDATE! Prehistoric World Prehistoric World Monumental Experience Monumental Experience Prodigium Reforged (Terraria Pack) Prodigium Reforged (Terraria Pack) More Animals [FORGE] - 1.21 UPDATE! More Animals [FORGE] - 1.21 UPDATE! The Fungal Infection | Co-Op Base Defense The Fungal Infection | Co-Op Base Defense The Cobblemon SMP - Pokemon in Minecraft The Cobblemon SMP - Pokemon in Minecraft Medieval MC [FABRIC] MMC3 Medieval MC [FABRIC] MMC3 命运齿轮FOM【Fate's Machinery】 命运齿轮FOM【Fate's Machinery】 Ultimate Lucky Oneblock Ultimate Lucky Oneblock MineField Mods MineField Mods New Game 2 - Enjoy An Adventure Without Limits New Game 2 - Enjoy An Adventure Without Limits The Ancient Dawn - Prehistoric Journey The Ancient Dawn - Prehistoric Journey Create: Perfect World 2 Create: Perfect World 2 Pixelmon Plus+ The Top Pokemon Experience in Pixelmon - Fully Optimized - Best Pixelmon Server - All Pokemon Pixelmon Plus+ The Top Pokemon Experience in Pixelmon - Fully Optimized - Best Pixelmon Server - All Pokemon Ages Of War (Nukes,Bombs and Guns!!) Ages Of War (Nukes,Bombs and Guns!!) TNP Limitless 8 - LL8 TNP Limitless 8 - LL8 KEO RPG optimized KEO RPG optimized Medieval MC [NEOFORGE] MMC5 Medieval MC [NEOFORGE] MMC5 Create: Stranded at Sea Create: Stranded at Sea More Decorations [FORGE] - 1.21 UPDATE! More Decorations [FORGE] - 1.21 UPDATE! Farmopolis Farmopolis Cozy Zen Cozy Zen [MODIFIED] Cobblemon: PLUS [MODIFIED] Cobblemon: PLUS The Last War - Guns And Adventure (Survivor's World with Guns) | QUESTS UPDATE! The Last War - Guns And Adventure (Survivor's World with Guns) | QUESTS UPDATE! A Shattered Prophecy (The Broken Script) A Shattered Prophecy (The Broken Script) Alaskan Wilderness Reimagined - ForgeLabs Recreation [AWR] Alaskan Wilderness Reimagined - ForgeLabs Recreation [AWR] Ocean Depths - Quests & Ocean Mods Ocean Depths - Quests & Ocean Mods Create 2 Mekanism: Sky Edition 2 Create 2 Mekanism: Sky Edition 2 DARK FANTASYCRAFT DARK FANTASYCRAFT ZS Pack (Tensura) ZS Pack (Tensura) Create on a Potato PC: Ultimate Create on a Potato PC: Ultimate Better MC Skyblock [BMCS] Better MC Skyblock [BMCS] ChaosZProject - A Modern Zombie Apocalypse [VR for WIP v.3.0.0] ChaosZProject - A Modern Zombie Apocalypse [VR for WIP v.3.0.0] Medieval MC [FABRIC] MMC2 Medieval MC [FABRIC] MMC2 Society: Sunlit Cobblemon Society: Sunlit Cobblemon All The Mods - Gravitas² All The Mods - Gravitas² Speed Of Light FPS Booster (SOL) Speed Of Light FPS Booster (SOL) MYTHCRAFT 5 MYTHCRAFT 5 BETTER FANTASY - Overture BETTER FANTASY - Overture Vampirism.co Vampirism.co Horrorland 2 - Psychological and Classic Horror Modpack (with Horror Quests) Horrorland 2 - Psychological and Classic Horror Modpack (with Horror Quests) All the Magic - Arcana All the Magic - Arcana Confluence: Journey's Start (Terraria ModPack) Confluence: Journey's Start (Terraria ModPack) All Of Farmer's Delight : Farming Agriculture & Cooking  All Of Farmer's Delight : Farming Agriculture & Cooking Contained Opolis (A Space Adventure) Contained Opolis (A Space Adventure) Cobblemon Eternal: The Minecraft Pokémon Experience Cobblemon Eternal: The Minecraft Pokémon Experience

External Resources