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
ComboTech 4 Sky High ComboTech 4 Sky High Bobruisk (OxMODPACK) Bobruisk (OxMODPACK) Family Friendly Pack Family Friendly Pack Magic And Sword Magic And Sword A hellish apocalypse A hellish apocalypse Dragon mine Z - Time Havoc Dragon mine Z - Time Havoc The Lands Between THEO The Lands Between THEO Better than Bundles! - BTB Better than Bundles! - BTB Xomaps RPG Xomaps RPG Dark's Trials of the Unknown Dark's Trials of the Unknown Silent Cities - Zombie Apocalypse Silent Cities - Zombie Apocalypse Prism Drift Prism Drift MCB Create Live MCB Create Live CobblemonOrigins CobblemonOrigins Paleo Project Paleo Project Adventures Together 27 Adventures Together 27 TensuraNewWorld TensuraNewWorld CR Craft REMASTERED CR Craft REMASTERED Vanilla Reinvented Vanilla Reinvented ALCHEMIST RPG ALCHEMIST RPG Dynasty Craft [RPG] Dynasty Craft [RPG] Puffy's One Block Horror Puffy's One Block Horror YAMINABE - Combat YAMINABE - Combat Natures Odyssey Natures Odyssey Create: Whiskers and Wonders Create: Whiskers and Wonders Dark Chocolate Edition Dark Chocolate Edition The Last Province zombie apocalypse The Last Province zombie apocalypse Liminal Spaces - (Backrooms luminal) Liminal Spaces - (Backrooms luminal) Tensura Abyss Tensura Abyss Mystic's Monstrosity - Immersive Edition Mystic's Monstrosity - Immersive Edition Dinosaurs & Trains Dinosaurs & Trains Medieval Sieges and Airship warfare Medieval Sieges and Airship warfare The Adventure of 1000 - Hunters of Evil The Adventure of 1000 - Hunters of Evil GreenBound GreenBound BiteForce Cobblemon BiteForce Cobblemon Minemon -- A cobbleverse spinoff Minemon -- A cobbleverse spinoff Maor The King Of The Light Maor The King Of The Light Wizards and Warriors RPG Wizards and Warriors RPG Create & beyond hardcore industrial survival Create & beyond hardcore industrial survival Gregtech Reverberating Nexus Gregtech Reverberating Nexus RuneCraft(RPG) RuneCraft(RPG) VALE - Folklore Flavor VALE - Folklore Flavor Totheron Totheron Enhanced Terrain Enhanced Terrain DracoNeo - Council of Wyrms DracoNeo - Council of Wyrms Eden Factory Eden Factory Create & Conquer: Last Light Create & Conquer: Last Light mine & slash mine & slash Pebblecraft: Stratum Pebblecraft: Stratum Enchantments Enchantments SC Final Adventure - Machines SC Final Adventure - Machines Cobbled Industries 2 Cobbled Industries 2 Cobblemon Generations SMP Cobblemon Generations SMP Our Way Of Life Our Way Of Life Lord Of Family Lord Of Family Cobblemon Survival with Friends Cobblemon Survival with Friends A Crow's Adventure A Crow's Adventure Sabixonas Sabixonas EldenCraft: A Soulless RPG EldenCraft: A Soulless RPG Cool Client Cool Client Jujutsucraft Ultimate version Jujutsucraft Ultimate version NeoMinecolonies NeoMinecolonies after the virus - parasite apocalypse after the virus - parasite apocalypse Create - Means of Production Create - Means of Production HenryCraft HenryCraft A Christmas Nightmare A Christmas Nightmare Prime Piece Lite Prime Piece Lite G1gaCraft Reloaded V2 G1gaCraft Reloaded V2 Akton's VentureCraft Akton's VentureCraft Jonny's Witherstorm Pack Jonny's Witherstorm Pack BetterCrafted BetterCrafted Create Vine & Wine Create Vine & Wine PsychoWinter PsychoWinter A Colony Survival A Colony Survival ABC Create - Aeronautics ABC Create - Aeronautics Tobinator Stream-Pack Tobinator Stream-Pack Alamaos' Code: AgriTech Alamaos' Code: AgriTech Crops And Cuisine Crops And Cuisine Official Dynastie Community Modpack Official Dynastie Community Modpack All About Alchemy - Magic & Potions All About Alchemy - Magic & Potions Jujutsu Kaisen Heian ERA-Cursed Fate Jujutsu Kaisen Heian ERA-Cursed Fate Wonderland_Tapes.jar Wonderland_Tapes.jar Biophobia Biophobia verity excelent verity excelent Garden Mermaids Garden Mermaids La Bouloumbele La Bouloumbele Royalty Cobblemon Royalty Cobblemon Create Spellbound Create Spellbound Jurassic World Relife Jurassic World Relife The Quest The Quest Cozycraft Adventures Cozycraft Adventures CatzyCraft CatzyCraft The Colony Network S2 The Colony Network S2 Veloria SMP Veloria SMP Farming Bosses Farming Bosses ShapeCraft ShapeCraft Blades of the East Blades of the East InfinityCraftfinal InfinityCraftfinal Hypheria Hypheria Terraero Terraero

External Resources