Trying to Convert Mods Since June 9th 2025
ModMorpher is an experimental conversion tool. Because Java and Bedrock use fundamentally different modding systems, manual fixes should be expected after conversion.
javalang, Pillow, etc) the first time you run it.
ModMorpher tries to take a Minecraft Java mod and produce a Bedrock add-on (.mcaddon). It’s not perfect, sometimes it breaks things, but it usually gets you close enough to tweak manually.
-
- It first calls my custom wrapper for Vineflower(ClassDecompiler.jar) to decompile the mod you provide
-
- Extracts textures/models/sounds from the jar into the Resource Pack in the /Bedrock_Pack folder
-
- It cycles through and attempts to convert java logic to its bedrock equivalent
-
- It then packages everything into Bedrock_Pack.mcaddon, ready for bedrock or tweaking. And deletes /src_[mod]
This is made for mods made with Forge / NeoForge.
| Minecraft | loader | how reliable it is |
|---|---|---|
| 1.20.1+ | NeoForge | decent, but expect some manual fixing |
| 1.19.2-1.20.1 | Forge | Best Shot |
| 1.12+ | Forge | Works decently, manual tweaking may be needed. |
| 1.3+ | Forge | experimental |
| 1.20.1+ | Fabric / Quilt | experimental |
- Python 3.10+ on your PATH
- OpenJDK 21+ (needed for the decompiler)
- Put your compiled
.jarin this folder (project root). - Run:
python modmorpher.py
- Use or tweak Bedrock_Pack.mcaddon
- It installs dependecies automatically. If it fails the first time, try running it again.
- Treat the output as a starting point, not a finished pack.
This project is meant to help mod creators & players, not to pirate people’s work. If you’re converting someone else’s ARR or non-permissive mod, make sure you have permission.
ModMorpher does NOT:
- fully convert Java mods into working Bedrock equivalents
- guarantee functional gameplay logic conversion
- support all Forge/Fabric mod features
- handle complex rendering systems perfectly
- handle mixins very well at all