Skip to content

Latest commit

 

History

History
83 lines (62 loc) · 4.54 KB

README.md

File metadata and controls

83 lines (62 loc) · 4.54 KB

Github All Releases

MDG (Mods Decompiler Gui):

⚠️ WARNING ⚠️: Check license of all mods from mods folder or usage of this tool can be eligible and cause license infringement.

History and description:

The program is designed to simplify and make deobfuscation and decompilation of mods a one-click solution for everyone interested. In almost all English-speaking modding communities, the topic of decompilation is prohibited. If someone tries to discuss decompilation and deobfuscation, ARR hamsters will immediately stop it. Since someone will be able to decompile their paid mods and disrupt their profits. Although the majority (95%) those who are interested in this really need to see how something works, find a bug, they are not going to decompile their paid mods in order to break the protection. More over decompilation of whole mod is not the best solution in such case because you will need to fix very many decompilation artifacts to recompile the mod. In case of modifying 1-3 files and recompiling the mod, Recaf is the best option for you. So it is almost impossible for a novice modder, and even more so for a modpack maker, to learn how to do what this program does. I want to overcome this and make sure that mods decompilation and deobfuscation can be used by any person, who needs it, even those who only came to modding. A super intuitive one-click solution. You don't know how things work? Just one click and you got your decompiled code! This tool could save us hundreds of hours when developing modpacks or fixing conflicts in mods. For example, it has already saved me around 30 hours. Instead of binary searching in mods, which takes a couple of hours, this program allows us to find conflicts/problematic mod within 5 minutes. If you don't know whether you need a specific option, use the builtin documentation. Every option is documented. If you just want the code of your modpack to see how things work, simply don't modify the settings. The program will already do what you need with default settings. Feel free to experiment with the settings, the GUI will not allow you to create an incorrect configuration. Program works by this algorithm; if some option is disabled, it will be skipped: deobfuscate -> decompile -> merge to mdk

Usage cases:

  • If you need to deobfuscate and/or decompile mod(s).
  • If you want to get source code of whole your modpack with correct IDE indexing. Including source code mods, Minecraft and MinecraftForge.
    • Find which mod adds/breaks something/chat message.
    • See how things are implemented, understand their logic.

Advantages:

  • GUI. It's not console tool. It is easy and pleasant to use.
  • It's all in one one-click complex solution.
  • Builtin documentation. You can just press '?' and get help about any option.
  • Despite other decompiler/deobf tools this is independent from apis. It uses mdk to deobf mods. So it won't break after mappings api changes like most of other deobf tools.
  • Caching. If you use this tool regularly for same modpack. You don't need to wait while all mods will be decompiled and deobfuscated. Tool will decompile/deobfuscate only changed mods. Other will be taken from cache.
  • Jar in jar support. MDG will analyse mods for jar in jar with super effective algorithm and process them with other mods. So you will be able to see jar in jar code too. (configurable)

Instruction:

  1. Download the latest release of program from https://github.com/KostromDan/Mods-Decompiler-GUI/releases
  2. Unzip archive
  3. Run MDG.exe
  4. Select mods folder and mdk.
  5. Press start.
  6. Done!

Answers:

  • Fabric compatibility?
    • Maybe(if I will see many people need it). But tool already can be used for fabric mods. Forge mdk can deobfucate fabric mods, since mappings are same. The only thing you will miss is you can't see Fabric source code in merged mdk.
  • Version range?
    • Decompilation: Any version.
    • Deobfuscation: 1.7.10+

Screenshots:

Main window:

image

Help(documentation) window:

image

Progress window:

image

Result window:

image