
RetroConvert
Converts Babric mods to Ornithe mods in an ornithe environment (or as a java agent)
About this Mod
RetroConvert
Drop your Babric mods into an Ornithe instance RetroConvert converts them automatically at launch.
Babric and Ornithe both run Fabric Loader on Minecraft Beta 1.7.3, but they use different intermediary mappings, so their mods aren't compatible with each other. RetroConvert fixes that: at launch it rewrites Babric mods' bytecode in place to Ornithe's Calamus gen2 mappings token for token, with no recompilation, no sources, and no internet required.
Features
- Fully automatic just put Babric
.jarfiles in yourmodsfolder alongside RetroConvert and launch. Converted mods appear as<name>-ornithe.jar; originals are safely archived inconfig/retroconvert/originals/. - Deep conversion rewrites class bytecode, mixin annotations (including refmap-less string targets), refmap JSONs, access wideners,
fabric.mod.json, string constants used for reflection, and nested jar-in-jar mods, recursively. - No visible restart after converting, Fabric Loader is relaunched inside the same JVM over the converted mods folder. The game just starts.
- Smart detection already-ported Ornithe mods are left untouched, and umbrella mods with nested jars (like StationAPI) are handled per-jar.
- Official-build replacements a few mods (StationAPI, GlassConfigAPI) changed too much for a bytecode rewrite; for those, the official Ornithe build is downloaded instead, with bytecode conversion as the offline fallback.
- Cached jars are keyed by SHA-256, so only new files are scanned on later launches.
Usage
- Install RetroConvert into an Ornithe b1.7.3 instance's
modsfolder. - Add your Babric mods to the same folder.
- Launch. That's it.
Optional: Java agent mode (zero-restart, even on first launch)
Add this to your JVM arguments (Prism Launcher: instance → Settings → Java → JVM arguments):
-javaagent:mods/retroconvert-1.0.1+mcb1.7.3.jar
This converts mods before Fabric Loader scans the folder no relaunch logic needed at all. The same line works for every instance on Prism, MultiMC, and the vanilla launcher.
Headless usage
Convert any mods folder without launching the game:
./gradlew runConverter --args="/path/to/.minecraft/mods"
Limitations
- Only b1.7.3 is supported by design, since Babric only targets b1.7.3.
- A Babric mod that fails dependency resolution crashes before RetroConvert can run; remove that jar manually.
- Don't restore an archived original next to its converted output the loader will see two mods with the same id.
License & Source
Source code, issue tracker, and full technical details are available on GitHub.
Available Versions
How to Install RetroConvert on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set ornithe Loader
In the panel under "Egg", select the ornithe loader and matching Minecraft version (b1.7.3).
Install Mod
Open the mod browser in the dashboard and search for "RetroConvert". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
b1.7.3
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
RetroConvert server crashes on startup – what to do?
Most common cause: wrong ornithe version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (b1.7.3). You can switch loaders with one click in the panel.
Is RetroConvert compatible with ornithe?
RetroConvert officially supports ornithe for Minecraft b1.7.3. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with RetroConvert – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if RetroConvert consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install RetroConvert with just one click on your server.