ShaneBeeStudios / McDeob

Re-mapping and deobfuscation tool for Minecraft
Apache License 2.0
178 stars 16 forks source link

McDeob

Java CI with Maven GitHub release (latest by date including pre-releases) GitHub All Releases GitHub issues GitHub closed issues GitHub pull requests GitHub

McDeob is a re-mapping and deobfuscation tool for Minecraft server/client jars.
This tool will download the appropriate Minecraft server/client jar along with the mappings for that version, then it will proceed to remap the jar and optionally decompile it. Simply unzip that file to find all your remapped/decompiled Minecraft code.

Requirements:

Running:

Details for installing and running McDeob can be found on the WIKI

Note:

The remapping process takes around 6 seconds (give or take). Currently there is no progress in the app, so just wait til the app says it's completed.
The decompiling process takes about 30 seconds (give or take).
(These numbers are based on a test run on my Mac (MacbookPro with M1 chip), times may vary on other machines.)

SUPER IMPORTANT NOTE:

The files output by this app are for your own personal use only.
The mappings used to de-obfuscate are provided by Mojang, but come with a hefty copyright from Microsoft.
You can use these files personally however you see fit, but you are not permitted to distribute them, since they do contain proprietery Minecraft code.
That said, you may NOT upload the resulting files to something like GitHub.

Mappings:

1.14.4+:

Preview:

Screenshot 2024-09-29 at 2 16 19 PM

Building/Compiling:

If you wish to compile the jar yourself, simply clone the repo and run:
mvn clean package
If you want the macOS APP and DMG file run:
mvn clean package -P macos
Super Simple!!!

Tools:

This application uses 2 different tools for the processing of the jar files 1) SpecialSource by md-5 = This tool remaps the Minecraft jar using Mojang's mappings. 2) FernFlower = This tool is used to decompile the jar file (class files) into usable .java files.

License

This tool shades in both SpecialSource and FernFlower, please see their repos for the appropriate licenses.