Fk Xaero's Registries
If you run a heavily modded Minecraft setup, you have likely encountered the silent chaos of registry conflicts. Two mods try to write the same entry to the game's status-effect registry, and suddenly your potion icons are wrong, your HUD is glitching, or your server kicks you with a cryptic error. Enter Fk Xaero's Registries, a focused Fabric compatibility mod that surgically prevents Xaero's Minimap and Xaero's World Map from registering status effects in the first place. It is not a flashy content mod; it is a quiet stabilizer that keeps your pack running smoothly.
Why Registry Conflicts Happen
Minecraft's vanilla status-effect registry is a finite, ordered list. When Xaero's Minimap or World Map loads, they attempt to add their own entries to this list. In a modpack, another mod may have already claimed that registry slot, causing a hard crash or a silent data corruption. The original description for Fk Xaero's Registries explains that this mod cancels the registration process before either Xaero mod writes entries to the vanilla registry. This is a preventive measure, not a reactive patch. It stops the problem at the source, ensuring that other mods can use the registry without interference.
Who Needs This Mod?
This is a niche but essential tool for:
- Modpack developers who want to avoid client-side crashes during world loading.
- Server administrators running custom plugins that manipulate status effects.
- Players who use both Xaero's Minimap and Xaero's World Map alongside other utility mods.
If you have ever seen a "Registry entry already present" error in your logs, this mod is your solution. It applies entirely on the client side, where Xaero's mods load their code. This means it does not affect server-side logic or require server installation.
Requirements and Compatibility
Before you download Fk Xaero's Registries, ensure your environment meets the specific version requirements. This mod is built for Minecraft 26.2 and requires Fabric Loader 0.19.3 or later. You will also need Fabric API 0.158.0+26.2 as a base library. The mod targets Xaero's Minimap 26.4.2 or later and Xaero's World Map 1.44.2 or later. Finally, you must run Java 25 to support the latest class file format. This is not a mod for older versions; it is designed specifically for the 26.2 ecosystem.
For players using the foxygame.net launcher, the process is even simpler. That launcher includes a curated add-on catalog where you can locate Fk Xaero's Registries and install it with a single click, bypassing manual file management entirely.
How to Install
Learning how to install this mod is straightforward, but you must follow the order of operations carefully. First, install Fabric Loader for Minecraft 26.2. Second, drop the Fabric API jar into your mods folder. Third, add both Xaero's Minimap and Xaero's World Map. Finally, place the Fk Xaero's Registries jar into the same folder. The mod does not require a configuration file; it works automatically upon launch. If you are using a launcher like foxygame.net, the auto-update feature will keep Fk Xaero's Registries in sync with your other mods, preventing version mismatch headaches.
Under the Hood: How It Works
The mod uses a mixin to intercept the status-effect registration call from Xaero's mods. Instead of allowing the write operation, it cancels it and returns a dummy value. This is a clean, non-invasive approach that does not modify the Xaero jar files themselves. Because the cancellation happens before the registry write, there is no leftover data or orphaned references. The code is licensed under LGPL-3.0, meaning you can inspect it, modify it, and even include it in your own projects with proper attribution.
Performance Impact
There is essentially none. The mixin runs once during the mod initialization phase, and it does not add any tick-based logic. Your frame rate, memory usage, and world-loading times remain unaffected. This is a set-and-forget mod that only acts when the conflict would otherwise occur.
Building from Source
If you prefer to compile the mod yourself, the process is standard for Fabric projects. Clone the repository and run ./gradlew build. The build artifacts are written to build/libs/. You can then take the resulting jar and place it in your mods folder. This is useful for developers who want to verify the code or contribute improvements.
Final Thoughts
Fk Xaero's Registries for Minecraft is a tiny mod with a huge job. It eliminates a specific class of registry conflicts that can otherwise make your modpack unplayable. If you rely on Xaero's maps and have encountered status-effect errors, this is the definitive fix. It is not a replacement for proper modpack testing, but it is a reliable safety net. For the best experience, pair it with a launcher that handles version compatibility automatically, ensuring your Fabric Loader and API versions match the requirements. Download the mod, install it alongside your Xaero dependencies, and let it quietly do its job in the background.