Sodium Options API Mod pour Minecraft 1.20.1

Ce mod ajoute des événements multiplateformes pour permettre l'intégration du menu d'options de Sodium/Embeddium. Par exemple, vous pouvez ajouter une page d'options à Embeddium sur Forge, à Fabric Sodium 0.5 sur 1.20.1, et à Fabric/NeoForge Sodium 0.6 sur 1.21.1 avec un seul événement :

OptionGUIConstruction.EVENT.register((pages) -> pages.add(new TestOptionPage()));

Si vous êtes un utilisateur final et que vous n'avez pas déjà ce mod installé comme bibliothèque pour un autre addon Sodium, vous pouvez l'installer avec Reese's Options pour bénéficier d'un menu de catégories amélioré, avec prise en charge des listes déroulantes afin de faciliter la navigation. Cela prendra effet même pour les mods qui n'utilisent pas cette API et qui s'injectent directement dans les options de Sodium.

Ce mod est en partie un fork de l'API de catégories et des événements d'options d'Embeddium, avec de nombreuses modifications pour prendre en charge Sodium en amont. Bien qu'il modifie le menu de Reese's Sodium Options, il le fait via mixin pour des raisons de compatibilité, vous devrez donc installer les deux.

Utiliser l'API

Tout d'abord, vous devrez ajouter ce mod à votre environnement de développement, en utilisant la version Maven pour Curseforge ou Modrinth.

modImplementation("maven.modrinth:sodium-options-api:version")

Ensuite, ce mod fournit trois événements dans toni.sodiumoptionsapi.api :

• OptionGUIConstruction.EVENT, appelé une fois dans le constructeur de l'interface graphique, permet d'ajouter des pages entières. C'est probablement celui que vous voulez.
• OptionPageConstruction.EVENT, appelé pour chaque OptionPage. Utilisez-le si vous voulez ajouter un groupe de bascules à l'onglet performance ou autre.
• OptionGroupConstruction.EVENT, appelé pour chaque groupe d'options. Utilisez-le si vous voulez insérer une seule option dans un groupe existant, ou modifier celles de vanilla.