Mod Menu Badges Lib Mod FAQ

It's a library that lets mods display small custom badges next to their entry in the Mod Menu list. On its own it doesn't add any badges — it just gives other mods the tools to create and register them.

You call the library's badge registration API during your mod's initialization and pass it a badge definition, such as an icon or text label. The badge then appears automatically on your mod's Mod Menu entry.

Yes, Mod Menu Badges Lib works alongside Mod Menu, so Mod Menu must be present for badges to render. Without it there's no mod list for the badges to attach to.

The most common causes are registering the badge too late in the load process, a missing or broken icon path, or the badge being attached to the wrong mod ID. Check your registration timing and that the mod ID matches your mod's metadata exactly.

Yes, it's designed to be depended on by other mods. Add it to your build dependencies and declare it in your mod metadata so loaders know your mod requires it.

You supply a texture or icon reference through the library's badge builder and register it against your mod. The library handles drawing it in the Mod Menu list, so you don't need to write rendering code yourself.

Yes, a mod can register multiple badges, and they'll be shown together on its Mod Menu entry. Keep in mind the list row has limited space, so too many badges can crowd the display.

No meaningful impact — badges are only drawn on the Mod Menu screen, not during normal gameplay. It's a lightweight library with no world or tick logic.

It generally works with Mod Menu itself, but mods that heavily restructure or replace the mod list screen may interfere with badge rendering. If badges vanish after adding another UI mod, that mod is the likely culprit.

Only install it if another mod you use requires it as a dependency. It doesn't add badges by itself, so on its own it does nothing visible for a regular player.