Mine Tags API
If you have ever moved a modpack from Forge to Fabric, or tried to run a mixed setup, you know the pain of tag mismatches. Recipes break, ore dictionary lookups fail, and machines refuse to accept the items they should. Mine Tags API is a lightweight bridge mod that solves this problem by exposing the familiar Forge tag structure on both Forge and Fabric, so the same tag references work regardless of which loader you are running.
What Mine Tags API Actually Does
At its core, Mine Tags API is a cross-platform API that makes the handy Forge tags available on both loaders. On Forge, the tags under the PlatformTags class are mapped to the existing Forge tags, such as #forge:glass/colorless. On Fabric, those same references are assigned to a new tag using the fabric namespace, like #fabric:glass/colorless. The result is a consistent tagging layer that mod developers and pack makers can rely on.
This matters most for mod authors who want a single codebase to behave identically across loaders. Instead of writing separate tag logic for each platform, you reference PlatformTags and let the API handle the translation behind the scenes. For players, that translates into fewer broken recipes and smoother modpack assembly.
Supported Minecraft Versions and Loaders
Mine Tags API is built for modern Minecraft releases and targets both major modding loaders, Forge and Fabric. Because tag systems have shifted between Minecraft versions, always confirm that the build you grab matches your game version and loader before adding it to a pack. Running a mismatched build is the most common reason players see tag errors after an update.
Dependency: Architectury API
This mod requires Architectury API to function. Architectury provides the cross-platform abstraction layer that Mine Tags API builds on, so the dependency is not optional. If you install Mine Tags API without it, the game will fail to load the mod or throw errors during startup. Add both files to your mods folder together.
How to Install Mine Tags API
Installation follows the standard modding routine, but the dependency order matters. Here is the straightforward process:
- Confirm your Minecraft version and whether you run Forge or Fabric.
- Download Architectury API for that exact version and loader.
- Download Mine Tags API for Minecraft from a trusted mod repository, matching the same version and loader.
- Place both JAR files into your
modsfolder. - Launch the game through your loader profile and check the log for successful initialization.
If you manage several instances, keeping the two files paired avoids the classic "works in one pack, breaks in another" scenario. For players who prefer a hands-off approach, the foxygame.net launcher simplifies things considerably: it bundles Mine Tags API with its required dependency and handles version matching automatically, so you can jump into a modpack without hunting for compatible builds.
A Quick Note for Developers
Using the API is intentionally familiar. The usage pattern mirrors Forge tags, except you reference the PlatformTags class instead of Forge's Tags class. A typical conversion looks like this: Tags.Blocks.GLASS becomes PlatformTags.Blocks.GLASS. From there, the API routes your reference to the correct namespace for the loader in use.
This design keeps migration costs low. If you already maintain a Forge mod and want Fabric support, you can swap tag references without rewriting your data generation or recipe logic. Just remember that the underlying tag files still need to exist for your target loader, and testing on both platforms is always wise before publishing.
Why Pack Makers Benefit Too
Even if you never write a line of Java, cross-platform tags reduce friction when assembling modpacks. Recipes that depend on common tags like glass, ingots, or planks behave more predictably, and you spend less time patching broken outputs with datapacks. It is a small mod with an outsized effect on pack stability.
Final Thoughts
Mine Tags API fills a real gap in the Minecraft modding ecosystem by unifying tag behavior across Forge and Fabric. Whether you are a developer tired of maintaining duplicate tag code or a player who just wants recipes to work, this mod delivers a clean, dependable solution. Pair it with Architectury API, match your versions carefully, and your modpack will thank you.