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
FastThingsBoosterPack 1.21.5 SUPPORT!! FastThingsBoosterPack 1.21.5 SUPPORT!! Vanilla+ (w Cobblemon) Vanilla+ (w Cobblemon) thesomewhatyou's Old School Computer Revival project thesomewhatyou's Old School Computer Revival project Beyond Journey's End Beyond Journey's End Runethal Runethal WolfiesCozyPlace WolfiesCozyPlace Socky's Create Modpack Socky's Create Modpack Karmunism-Refugee Karmunism-Refugee TacApoth TacApoth Cobblemon Champions Cobblemon Champions Worlds Unbound Worlds Unbound Nomad Medival Nomad Medival Create Aeronautics Survival Create Aeronautics Survival Morphica RP Morphica RP The Genesis - Origins The Genesis - Origins medieval smp S4 medieval smp S4 Create Continents Create Continents HearthBound Homestead HearthBound Homestead Project Solaris Modpack Project Solaris Modpack Concatenation Lumineth Concatenation Lumineth  Technology Evolution  TE Technology Evolution TE The lads on tour The lads on tour MC2010  -  A Nostalgic Horror Pack MC2010 - A Nostalgic Horror Pack Cobble Lemon Cobble Lemon Eevee Isles Eevee Isles Age of Scales & Bones Age of Scales & Bones CAC Cobblemon Ars Create CAC Cobblemon Ars Create Ashen - A Medieval Life Project Ashen - A Medieval Life Project They are bigger than the mountains... They are bigger than the mountains... GearboundSMP S2 - Create Multiplayer GearboundSMP S2 - Create Multiplayer TerraFirmaCivilization Season 2 TerraFirmaCivilization Season 2 Chiapas Middle-Earth Chiapas Middle-Earth Stands and Arrows Stands and Arrows Thatmobs Stalker (horror) Thatmobs Stalker (horror) Siren Head 100 days Siren Head 100 days Honkerton Honkerton The Obfuscation (THE BROKEN SCRIPT) The Obfuscation (THE BROKEN SCRIPT) MysteriaSMP MysteriaSMP Gears and Legends Gears and Legends Frozen Horrors Frozen Horrors ROLO Edition ROLO Edition Stalker_txt.scary Stalker_txt.scary Glowstone Galaxy Create Edition Glowstone Galaxy Create Edition Mana and Metal 2.0 Mana and Metal 2.0 Optimised Refined Experience (ORE) Optimised Refined Experience (ORE) All The Heros All The Heros Alex's Pack 1.21.1 Alex's Pack 1.21.1 SO7 Modpack SO7 Modpack Warriors of Cats Warriors of Cats Havoc & Haven - Blossoms and Banners Havoc & Haven - Blossoms and Banners one block horror   (mkcdmc) one block horror (mkcdmc) Random House - Interestelar Random House - Interestelar A Song Of Fire And Ash A Song Of Fire And Ash XAVIER Personal Pack XAVIER Personal Pack Aeternis Aeternis Size Matters Size Matters Egregious Industrialization Egregious Industrialization Aphelyon Aphelyon MewmiCraft MewmiCraft MayraLand MayraLand Outerworlds Outerworlds Become  A Hero V2 Become A Hero V2 World of Drakora Medieval edition World of Drakora Medieval edition Ashen Realms Ashen Realms All You Need 2 - AYN 2 All You Need 2 - AYN 2 Create: Above the Clouds Create: Above the Clouds Aussie Create 6 Aussie Create 6 Aeronautic Colonies Aeronautic Colonies Cobblemon aBunchaMods Cobblemon aBunchaMods More Magika! More Magika! Multiversal Multiversal Christmas Modpack (yeah) Christmas Modpack (yeah) Kainel Kainel TCC - Skyzone TCC - Skyzone Sovereign Colonization Sovereign Colonization The Herobrine: Forgotten Realms The Herobrine: Forgotten Realms Vibrant Performance Vibrant Performance A Crazy Adventure: Science & Survival A Crazy Adventure: Science & Survival Peace of Mind 21.1 Peace of Mind 21.1 Cataclysmic Ascension Cataclysmic Ascension Cups & Wine Cups & Wine The Broken World (New) The Broken World (New) Createrington Nomads Createrington Nomads Fancy's Last Stand Fancy's Last Stand CobbleQuestBMC CobbleQuestBMC Bosses World-All The Bosses Bosses World-All The Bosses FROST: Wakes The Storm FROST: Wakes The Storm Fantasy-Reimagined Fantasy-Reimagined Pingwin Pack (Tech/Survival) Pingwin Pack (Tech/Survival) Arise SMP Arise SMP Wheel of Mods 3 Wheel of Mods 3 Whittled & Wistful Whittled & Wistful It's Hunting Me in The Country Road... [HORROR] It's Hunting Me in The Country Road... [HORROR] BSMP - BRUTALSMP BSMP - BRUTALSMP Nightmare Rising Nightmare Rising Limbones Server Modpack Limbones Server Modpack Cobblemon Reign Cobblemon Reign Freesia's Christmas Pack! Freesia's Christmas Pack! CanarioLand 2 CanarioLand 2 Create End Survival Create End Survival

External Resources