ᴍɪɴᴇᴄʀᴀꜰᴛʀᴇꜱᴏᴜʀᴄᴇꜱ
ModsShadersPluginsResource PacksModpacks
Log inSign up

Sodium Options API

Modrinth

Config API for adding Sodium options with a better categories menu

21.7M downloads513 followersUpdated 1y ago

fabric-1.21.5-1.0.11 · MC 1.21.5 · Fabric

View on Modrinth

Files

  • fabric-1.21.5-1.0.11

    release

    SodiumOptionsAPI Fabric 1.0.11 for 1.21.5

    1.21.5fabric

    2025-04-10 · 105.7K downloads

    sodiumoptionsapi-fabric-1.0.11-1.21.5.jar · 305 KB

  • neoforge-1.21.5-1.0.11

    release

    SodiumOptionsAPI Neoforge 1.0.11 for 1.21.5

    1.21.5neoforge

    2025-04-10 · 5.1K downloads

    sodiumoptionsapi-neoforge-1.0.11-1.21.5.jar · 308 KB

  • neoforge-1.21.4-1.0.10

    release

    SodiumOptionsAPI Neoforge 1.0.10 for 1.21.4

    1.21.4neoforge

    2025-01-18 · 34.5K downloads

    sodiumoptionsapi-neoforge-1.0.10-1.21.4.jar · 302 KB

    1 more file
    • sodiumoptionsapi-neoforge-1.0.10-1.21.4-sources.jar

  • fabric-1.21.4-1.0.10

    release

    SodiumOptionsAPI Fabric 1.0.10 for 1.21.4

    1.21.4fabric

    2025-01-18 · 268.4K downloads

    sodiumoptionsapi-fabric-1.0.10-1.21.4.jar · 897 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.10-1.21.4-sources.jar

  • forge-1.20.1-1.0.10

    release

    SodiumOptionsAPI Forge 1.0.10 for 1.20.1

    1.20.11.20forge

    2025-01-18 · 4.2M downloads

    sodiumoptionsapi-forge-1.0.10-1.20.1.jar · 434 KB

    1 more file
    • sodiumoptionsapi-forge-1.0.10-1.20.1-sources.jar

  • fabric-1.21.1-1.0.10

    release

    SodiumOptionsAPI Fabric 1.0.10 for 1.21.1

    1.21.1fabric

    2025-01-18 · 9.2M downloads

    sodiumoptionsapi-fabric-1.0.10-1.21.1.jar · 882 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.10-1.21.1-sources.jar

  • neoforge-1.21.1-1.0.10

    release

    SodiumOptionsAPI Neoforge 1.0.10 for 1.21.1

    1.21.1neoforge

    2025-01-18 · 2M downloads

    sodiumoptionsapi-neoforge-1.0.10-1.21.1.jar · 302 KB

    1 more file
    • sodiumoptionsapi-neoforge-1.0.10-1.21.1-sources.jar

  • fabric-1.20.1-1.0.10

    release

    SodiumOptionsAPI Fabric 1.0.10 for 1.20.1

    1.20.11.20fabric

    2025-01-18 · 3M downloads

    sodiumoptionsapi-fabric-1.0.10-1.20.1.jar · 642 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.10-1.20.1-sources.jar

  • forge-1.20.1-1.0.9

    release

    SodiumOptionsAPI Forge 1.0.9 for 1.20.1

    1.20.11.20forge

    2025-01-01 · 136.7K downloads

    sodiumoptionsapi-forge-1.0.9-1.20.1.jar · 434 KB

    1 more file
    • sodiumoptionsapi-forge-1.0.9-1.20.1-sources.jar

  • neoforge-1.21.4-1.0.9

    release

    SodiumOptionsAPI Neoforge 1.0.9 for 1.21.4

    1.21.4neoforge

    2025-01-01 · 1.4K downloads

    sodiumoptionsapi-neoforge-1.0.9-1.21.4.jar · 302 KB

    1 more file
    • sodiumoptionsapi-neoforge-1.0.9-1.21.4-sources.jar

  • fabric-1.21.4-1.0.9

    release

    SodiumOptionsAPI Fabric 1.0.9 for 1.21.4

    1.21.4fabric

    2025-01-01 · 14.7K downloads

    sodiumoptionsapi-fabric-1.0.9-1.21.4.jar · 897 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.9-1.21.4-sources.jar

  • fabric-1.21.1-1.0.9

    release

    SodiumOptionsAPI Fabric 1.0.9 for 1.21.1

    1.21.1fabric

    2025-01-01 · 43.3K downloads

    sodiumoptionsapi-fabric-1.0.9-1.21.1.jar · 883 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.9-1.21.1-sources.jar

  • fabric-1.20.1-1.0.9

    release

    SodiumOptionsAPI Fabric 1.0.9 for 1.20.1

    1.20.11.20fabric

    2025-01-01 · 14.2K downloads

    sodiumoptionsapi-fabric-1.0.9-1.20.1.jar · 643 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.9-1.20.1-sources.jar

  • neoforge-1.21.1-1.0.9

    release

    SodiumOptionsAPI Neoforge 1.0.9 for 1.21.1

    1.21.1neoforge

    2025-01-01 · 11.9K downloads

    sodiumoptionsapi-neoforge-1.0.9-1.21.1.jar · 302 KB

    1 more file
    • sodiumoptionsapi-neoforge-1.0.9-1.21.1-sources.jar

  • 1.0.8

    release

    SodiumOptionsAPI Neoforge 1.0.8 for 1.21.1

    1.21.1neoforge

    2024-11-23 · 24.5K downloads

    sodiumoptionsapi-neoforge-1.0.8-1.21.1.jar · 302 KB

    1 more file
    • sodiumoptionsapi-neoforge-1.0.8-1.21.1-sources.jar

  • 1.0.8

    release

    SodiumOptionsAPI Fabric 1.0.8 for 1.20.1

    1.20.11.20fabric

    2024-11-23 · 1.4M downloads

    sodiumoptionsapi-fabric-1.0.8-1.20.1.jar · 299 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.8-1.20.1-sources.jar

  • 1.0.8

    release

    SodiumOptionsAPI Fabric 1.0.8 for 1.21.1

    1.21.1fabric

    2024-11-23 · 175.7K downloads

    sodiumoptionsapi-fabric-1.0.8-1.21.1.jar · 299 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.8-1.21.1-sources.jar

  • 1.0.8

    release

    SodiumOptionsAPI Forge 1.0.8 for 1.20.1

    1.20.11.20forge

    2024-11-23 · 663.7K downloads

    sodiumoptionsapi-forge-1.0.8-1.20.1.jar · 434 KB

    1 more file
    • sodiumoptionsapi-forge-1.0.8-1.20.1-sources.jar

  • 1.0.6

    release

    SodiumOptionsAPI Fabric 1.0.6 for 1.20.1

    1.20.11.20fabric

    2024-11-18 · 2.4K downloads

    sodiumoptionsapi-fabric-1.0.6-1.20.1.jar · 298 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.6-1.20.1-sources.jar

  • 1.0.6

    release

    SodiumOptionsAPI Fabric 1.0.6 for 1.21.1

    1.21.1fabric

    2024-11-18 · 5K downloads

    sodiumoptionsapi-fabric-1.0.6-1.21.1.jar · 298 KB

    1 more file
    • sodiumoptionsapi-fabric-1.0.6-1.21.1-sources.jar

Show more files (22 more)

Files are delivered unmodified from Modrinth's servers and verified against the SHA-512 hash published by the project. The project's license applies to every file; check it before redistributing.

Gallery

Better Options Menu

About

banner

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.

demo

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.