ThreadMC Decompile Tools

Warning

The code generated by these tools (i.e., decompiled Minecraft sources) is for personal use, analysis, or modding only.
You MUST NOT publish, redistribute, or share the decompiled source code, as it is derived from proprietary Mojang assets.
Respect Mojang's EULA and copyright.

A set of scripts and helpers to automate downloading, mapping, and decompiling Minecraft server jars using official Mojang mappings and open-source tools.

Features

• Downloads the latest versions of decompilation tools (VineFlower, SpecialSource, ASM, Guava, etc.)
• Fetches Minecraft server jars and official mappings for any version
• Applies mappings and decompiles to readable Java source code
• Fully automated and cross-platform (requires Bash, curl, jq, and Java)

Usage

1. Install dependencies:
   Ensure you have bash, curl, jq, and java installed.

2. Download tools:

   ./download.sh all

3. Decompile a Minecraft server jar:

   ./decompile.sh <mc_version> [output_dir]
   # Example:
   ./decompile.sh 1.21.5 ../minecraft-src-1.21.5

   Decompiled sources will be placed in the sources directory inside your output directory.

License

This repository is licensed under the BSD 3-Clause License. See LICENSE for details.

Contributing

Pull requests and issues are welcome! Please ensure your contributions follow the project's code style and include appropriate documentation and tests.

Security

If you discover a security vulnerability, please report it privately.

Acknowledgements

• VineFlower (Decompiler)
• SpecialSource
• ASM
• Guava
• Mojang for official mappings and server jars