McDeob 2.1.34

A simple tool to deobfuscate and decompile vanilla Minecraft

  1. ShaneBee
    Tested Minecraft Versions:
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    https://github.com/ShaneBeeStudios/McDeob
    [​IMG]

    McDeob
    is a simple tool to de-obfuscate and decompile vanilla Minecraft code.

    You may be asking yourself "But Shane, aren't there already tools that do this?" .... well yes there are. But this one is different. Most de-obfuscators are run from console. Generally they're fairly simple to use, but some people find these tasks a little convoluted. McDeob takes the guess work out for you and provides a simple to use GUI. Simply download, run, click a couple buttons and you are good to go.

    How it works:
    Theres a few steps:
    1) Download:
    The download step downloads the jar (client or server) as well as the corresponding mappings

    2) De-obfuscate:
    We use a tool called "Reconstruct" by LxGaming, a ProGuard de-obfuscator. It runs thru the download jar and mappings to remap the project. This process takes around 5 minutes.

    3) Decompile (optional):
    We use a tool called "FernFlower" (originally created by JetBrains I believe) which takes the jar file, and decompiles it into usable java code.
    This process can take upwards of about 15 minutes (usually 10-15 minutes during my testing)

    How to install:
    It's simple, click the download link. If you are on Windows/Linux use the jar option and if you are on macOS use the macOS dmg file.
    Put the file wherever you'd like and run it.
    The output files will be placed in your user's home directory under a new directory called "McDeob"

    How to use:
    Simply open the app, choose either server or client, choose your version and choose whether or not to decompile.
    Click start.
    Wait!

    Visual Example:
    Here is a little example of how the program looks
    [​IMG]

    DISCLAIMER:
    The output files are strictly for your use only. Do NOT upload the decompiled code to anywhere like GitHub, as this is still propriety Minecraft code. The mappings hold a Microsoft copyright stating this is for person use only.
    As of August 14th, 2020, the mappings include a new copyright. This copyright states you are allowed to use the mappings to deobfuscate Minecraft code for your project.
    Mojang/Microsoft copyrights still stand as normal with the actually jar files. These mapping updates do not allow you to deobfuscated then upload/post Mojang code anywhere.
    Please ensure you are reading the copyright notice of the mappings you are using, and adhere to the guidelines of said copyright.

    SPECIAL NOTE:
    The output files from this program will be missing a bunch of classes, that is because classes that are not obfuscated will be skipped, this is to keep the runtime of this app down. With that said, the decompiler breaks a lot of the code, so between that and the missing classes, you won't be able to rebuilt the Minecraft jar with this output. It is strictly for your enjoyment only, so you can see how the code is written.

    Versions:
    This app will only show Minecraft versions for 1.14.4+
    I have only included the latest major releases as well as a few of the latest snapshots and the latest combat test.
    In case you didn't already know this, Mojang started releasing mappings for 1.14.4, so therefore are only available on 1.14.4+.
    Expect regular releases of this app as I add/remove versions based on what Mojang is pumping out.

    "Why no 1.8.8?" ... Since I'm most likely going to be asked this a lot, read above. No mappings are available for older versions. Mojang refuses to release them (maybe they don't have them?!?!) which I agree with.

    Source Code:
    This app is open source. Please feel free to contribute if you feel up to it :)
    You can find the source code on GitHub

    Support:
    If you have any issues or suggestions, please pop them up on the GitHub Issue Tracker. If you simply have a question please use the discussion tab.

    Feel free to donate if you would like :) Any support helps out
    [​IMG]


    Reviews:
    While I do appreciate all reviews, please do not use the review section to request new features or tell me about bugs. Use the appropriate channels for that.

Recent Updates

  1. Small Fix [2.1.34]
  2. Small Changes [2.1.33]
  3. Small Changes [2.1.32]

Recent Reviews

  1. rOGContent
    rOGContent
    5/5,
    Version: 2.1.28
    its very good for programmers who are trying to write plugins in 1.17 since you could actually view stuff and add it to your 1.17 plugin
    1. ShaneBee
      Author's Response
      Thank you for the kind review :)
  2. frap
    frap
    5/5,
    Version: 2.1.27
    Really great and useful resource! Really well-made and user-friendly as well. Extremely convenient for trying to look into some parts of the MC code, especially as an anti-cheat developer. <3

    I feel bad for you losing stars cause of people not being able to read haha, keep up the good work <3
    1. ShaneBee
      Author's Response
      Thank you very much, I appreciate it.

      I also appreciate your understanding of what is describe in the resource description!!!
      Wish everyone could read ;)
  3. leguernic
    leguernic
    5/5,
    Version: 2.1.27
    This is awesome! Unfortunately it does not support Minecraft 1.4.6 but I am probably the only admin who uses that anyway today.
    1. ShaneBee
      Author's Response
      Thank you.
      I'm not sure if you read the description or not, but this app cannot support 1.14.3 and below, due to Mojang not releasing the obfuscation mappings for those versions.
      (Mojang started releasing obfuscation mappings for all versions starting with 1.14.4)
  4. realEntity303
    realEntity303
    4/5,
    Version: 2.1.17
    Seems to be very good, but I don't really understand the decompile feature?
    It still gives me a normal jar file...
    1. ShaneBee
      Author's Response
      Thank you for the review. For future reference, please do not use reviews for support. If you require assistance, please scroll up and see the "Support" section.
      The output jar is just a zip file, unzip it and you will see everything there.
  5. peppepascale
    peppepascale
    4/5,
    Version: 2.1.17
    Really a good resource, and a really good decompile but please add versions under 1.14.4 and ignore the snapshots, because doesn't change much.
    1. ShaneBee
      Author's Response
      Thank you.
      As explained in the version section:
      ""
      This app will only show Minecraft versions for 1.14.4+
      I have only included the latest major releases as well as a few of the latest snapshots and the latest combat test.
      In case you didn't already know this, Mojang started releasing mappings for 1.14.4, so therefore are only available on 1.14.4+.
      Expect regular releases of this app as I add/remove versions based on what Mojang is pumping out.

      "Why no 1.8.8?" ... Since I'm most likely going to be asked this a lot, read above. No mappings are available for older versions. Mojang refuses to release them (maybe they don't have them?!?!) which I agree with.
      ""
  6. Oppyusa
    Oppyusa
    5/5,
    Version: 2.1.3
    A TON better than before. I love how you added so much more to this. Great piece of code.
    1. ShaneBee
      Author's Response
      Thank you very much for the kind review. I did have some help so I can't take all the credit.
      I removed some older snapshots as they're probably not needed but if you need a specific version, please do not hesitate to let me know, and I can add them.
      I may add a command line option to specifically add whatever version you may want.
  7. Nucker
    Nucker
    5/5,
    Version: 2.0.4
    pretty epic ngl







    (maybe add support for at leat 1.12 but it would be nice to have 1.8 support)
    1. ShaneBee
      Author's Response
      Thank you for the review.
      I guess you didn't read the version information, Mojang started releasing mappings since 1.14.4, therefor there are no mappings for versions below that to de-obfuscate the jar file.
  8. BoostSK
    BoostSK
    5/5,
    Version: 2.0.2
    The idea of using a GUI is simply amazing. It's a very good resource, I might find a good way to use it.
    1. ShaneBee
      Author's Response
      Thank you. I really felt the GUI would help make things easier for people.
      While this app is fairly basic, it gets the job done :)
  9. nfell2009
    nfell2009
    5/5,
    Version: 2.0.2
    Perfect tool for what I needed. Very handy to have and will really help with my projects.

    hi im baefell
    1. ShaneBee
      Author's Response
      Thanks :)
      Glad I can help make your projects easier
  10. Itunarlis
    Itunarlis
    5/5,
    Version: 2.0.2
    I love the idea of implementing a GUI in order to simplify things. It's excellent and will find an use.
    1. ShaneBee
      Author's Response
      Thank you for the review. I thought the GUI would make the process simple, especially for the people who get easily confused with console commands.