Oxygen-FSMM Compat
If you have ever tried to run the Fex's Small Money Mod (FSMM) alongside the OxygenCore framework in modern Minecraft, you have likely hit a wall. The original currency provider that linked these two systems together was abandoned, and it simply does not work with the latest FSMM releases. That is exactly where Oxygen-FSMM Compat steps in. This add-on was built from scratch to replace the outdated provider, giving you a stable and reliable bridge between OxygenCore's economy hooks and FSMM's money mechanics.
Why You Need This Add-On
The core problem is straightforward: the old Oxygen Currency Provider was left behind during FSMM's updates. Trying to force it to work with newer versions results in crashes, missing transactions, or a complete failure to initialize your server's economy. Oxygen-FSMM Compat for Minecraft solves this by being developed specifically against the current FSMM and OxygenCore APIs. It is not a patch or a hack; it is a full replacement, written from the ground up to handle the same tasks the original did, but without the legacy baggage.
Key Features and Dependencies
To get the most out of this add-on, you need to ensure you have the right foundation installed. The mod acts as a middle layer, so it relies on a few other pieces to function correctly:
- FCL (Fexcraft Common Library): This is the base library that many Fexcraft mods share. It provides common code and utilities.
- FSMM (Fex's Small Money Mod): This is the actual currency mod that adds money, accounts, and transactions to your game.
- Oxygen Core: This is the framework that provides the API hooks, allowing other mods to interact with its systems.
Once you have those three installed, dropping in Oxygen-FSMM Compat will seamlessly connect FSMM's wallet data to OxygenCore's event system. This means things like shop purchases, quest rewards, or any other OxygenCore-driven feature can now correctly read and write your FSMM balance.
How to Install Oxygen-FSMM Compat
Installing this add-on is a simple process, but it requires a bit of attention to detail. First, ensure you are running a compatible version of Minecraft. The mod is actively updated to support recent releases, so check the official documentation for the exact version list. The loader of choice is Fabric, which is the primary environment for these Fexcraft tools.
Here is a quick step-by-step guide on how to install:
- Download the required dependency mods (FCL, FSMM, Oxygen Core) and place them in your
modsfolder. - Download the Oxygen-FSMM Compat jar file from the official source (CurseForge or the Fexcraft Discord).
- Place the downloaded jar into the same
modsfolder. - Launch the game with the Fabric loader profile.
That is it. The mod will automatically detect the other components and hook them together. If you run into any issues, double-check that you do not have the old Oxygen Currency Provider still installed, as having both will cause a conflict.
Version Compatibility and Updates
Keeping track of version numbers can be a chore, but this add-on makes it easier. Since it is built for the latest FSMM, you can usually update FSMM without worrying about breaking the connection, as long as the Compat mod is also updated. The developer is active on the Discord server for FSMM and Fexcraft mods, so you can always find the latest build there. When you are ready to get the newest version, simply search for download Oxygen-FSMM Compat on your preferred mod portal to find the most recent release.
For players who prefer a more streamlined approach to mod management, using the foxygame.net launcher can simplify things significantly. This launcher offers a curated catalog of add-ons, and you can find Oxygen-FSMM Compat listed there for a one-click install, which automatically handles the dependency checks for you. This is particularly useful if you are setting up a server for friends and want to avoid manually tracking down each library.
Troubleshooting Common Issues
Even with a well-made mod, things can occasionally go wrong. The most common issue is a mismatch between the FSMM version and the Compat version. If you see an error mentioning "missing provider" or "incompatible API," your versions are likely out of sync. Another frequent problem is forgetting to update FCL, which can cause silent failures.
If you are using a launcher that supports auto-updates, like the one mentioned earlier, you can enable that feature to ensure all your mods, including Oxygen-FSMM Compat, stay current without manual intervention. This helps prevent those version mismatch headaches before they start.
Final Thoughts
In the world of Minecraft modding, maintaining a cohesive ecosystem is vital. Oxygen-FSMM Compat is an essential tool for anyone who relies on FSMM for their economy but wants to leverage the power of OxygenCore. It is a clean, purpose-built solution that fills a gap left by an abandoned project. Whether you are running a small survival server or a large RPG-style world, this add-on ensures your currency flows smoothly between systems. Give it a try, and you will wonder how you managed without it.