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,259,933

CurseForge ID

1103431

Modrinth Downloads

21,323,618

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
Urban Conquest Urban Conquest the walten files the walten files LitW II - Life in the Wilds 2 LitW II - Life in the Wilds 2 Project AZOTH Cobblemon Modpack Project AZOTH Cobblemon Modpack Miguelito Disasters (MDisasters) - Natural Disasters and More Miguelito Disasters (MDisasters) - Natural Disasters and More Rizmotopia Rizmotopia Taproot Taproot All The Loot! [REMASTERED] All The Loot! [REMASTERED] Trash Panda Twist Trash Panda Twist Remarkably Forged Remarkably Forged Paralyzed: The Boiled One Paralyzed: The Boiled One UnBound World UnBound World Village & Pillage: Ultimate Village & Pillage: Ultimate  DayCraft REVAMPED DayCraft REVAMPED HardRock Apocalypse - Plagueborn (HRAP) HardRock Apocalypse - Plagueborn (HRAP) Call of Block Call of Block PhoenixTech: Reloaded PhoenixTech: Reloaded Harder Than Copper Age Harder Than Copper Age Finally a Good Tensura Server Finally a Good Tensura Server Nostalgia core (the broken script) Nostalgia core (the broken script) Arcane Dragons [NEOFORGE] Arcane Dragons [NEOFORGE] Create: New Age Create: New Age TeamImura's DMZ (Dragon Mine Z Server) TeamImura's DMZ (Dragon Mine Z Server) Jaffa Factory 2 - Futura Edition Jaffa Factory 2 - Futura Edition Skybound SMP Skybound SMP Crafted Create Crafted Create RageCraft Revived RageCraft Revived Sonic Block FF Sonic Block FF The Deadliest Winter The Deadliest Winter Noroi Noroi MineColonies-Caos e Ordem [Unnoficial] MineColonies-Caos e Ordem [Unnoficial] Kingdom Come - Reckoning [RPG] Kingdom Come - Reckoning [RPG] NO STRINGS ATTACHED A Survival Horror Pack NO STRINGS ATTACHED A Survival Horror Pack Trials of Terra Trials of Terra RiftRealm UNLIMITED RiftRealm UNLIMITED Horror on the Block! Horror on the Block! Modustrie Modustrie Sky Industrialization Sky Industrialization Lets Just Say CRAFT - [Christmas] (LJSC) Lets Just Say CRAFT - [Christmas] (LJSC) Bottom of The Barrel Bottom of The Barrel ArcaneAxis - ARS ArcaneAxis - ARS Ascension QoL Ascension QoL Simple Automation 2.0 | Beginner-Friendly Tech & Automation Simple Automation 2.0 | Beginner-Friendly Tech & Automation [ITV1] Zombie-apocalipse MapMods [ITV1] Zombie-apocalipse MapMods Integrated MineColonies Integrated MineColonies The Moon Is Gone - No_moon.jar The Moon Is Gone - No_moon.jar Wither Storm: Dawn of Legends Wither Storm: Dawn of Legends Kameritverse ( Alien Evolution ) Kameritverse ( Alien Evolution ) Liminal Spaces [M.B.M] - (Meulti's Backrooms) Liminal Spaces [M.B.M] - (Meulti's Backrooms) Mystic's Monstrosity - Avaricious Edition Mystic's Monstrosity - Avaricious Edition RePalmon RePalmon Objectively Better MC Objectively Better MC The Broken Script Origines The Broken Script Origines Beyong Depth (Ru translate) Beyong Depth (Ru translate) HallowScream 4 HallowScream 4 PROJECT: Geometra PROJECT: Geometra Twisted Towns Twisted Towns MSMP Oficial MSMP Oficial Harvest Valley Farming 2 Harvest Valley Farming 2 Velox Resurrected Velox Resurrected Best Forge Optimizations Best Forge Optimizations Skybound Origins Skybound Origins Is That A B-2 Stealh Bomber!?- Is That A B-2 Stealh Bomber!?- One Day To Death One Day To Death Twixxel's stalkers (Made By Sh4rky) Twixxel's stalkers (Made By Sh4rky) StormForge Pack StormForge Pack Dyonizel Modpack Dyonizel Modpack AdvoTech ValkyrienSkies (abandoned) AdvoTech ValkyrienSkies (abandoned) Nomurras Terror Nomurras Terror Createmon: Cidade Mêcanica Createmon: Cidade Mêcanica Modern Apocalypse: Spore Edition Modern Apocalypse: Spore Edition Minecolonies - Order and Chaos Minecolonies - Order and Chaos kawaii adventures kawaii adventures ES CRAFT ES CRAFT OneBlock - Nightmare Horror OneBlock - Nightmare Horror HiveCraft HiveCraft We Create SMP We Create SMP MY FNAF Management Wanted Custom Pack MY FNAF Management Wanted Custom Pack Tech-Craft Tech-Craft Create: Aloft Create: Aloft Farwater: Create Basics Farwater: Create Basics Ultimate Heroes Ultimate Heroes Another Danger, The Ultimate Horror Modpack Another Danger, The Ultimate Horror Modpack Planes Trains and Cobblemon Planes Trains and Cobblemon CobbleCafe Oficial CobbleCafe Oficial Cana's Cruel Catalyst Cana's Cruel Catalyst ManePear the Spearmaster RPG ManePear the Spearmaster RPG Cherryrar : Dragões II Cherryrar : Dragões II ImuraPiece a (TruePrimePiece Server) server W.I.P ImuraPiece a (TruePrimePiece Server) server W.I.P TFC - Simply Fantastic (TFCSF) TFC - Simply Fantastic (TFCSF) Cook in Skyland Recaked Cook in Skyland Recaked Shapeshifter's Adventures Shapeshifter's Adventures Naturalist+ Naturalist+ More mobs More mobs Eclipse Eclipse Better Fresh Start (BFS) Better Fresh Start (BFS) OmniCraft Evolved OmniCraft Evolved Lookout`s Horse Experience. Lookout`s Horse Experience. GATE Guns & Magic GATE Guns & Magic Sleepymon [COBBLEMON] Sleepymon [COBBLEMON]

External Resources