当前位置：首页 > news >正文

DecompilerMC核心原理：Mojang映射文件转换与反编译流程

news 2026/7/22 20:36:10

DecompilerMC核心原理：Mojang映射文件转换与反编译流程

【免费下载链接】DecompilerMCThis repository allows you to decompile any minecraft version that was published after 19w36a without any 3rd party mappings, you just need to execute the script or the executable (see releases)! Thanks mojang to have published proguard mappings. Archived since unobfuscated jar are now released!项目地址: https://gitcode.com/gh_mirrors/de/DecompilerMC

DecompilerMC是一款强大的Minecraft反编译工具，它能自动将特定版本的Minecraft客户端或服务器代码进行反编译和重映射，无需第三方映射文件。本文将深入解析其核心工作原理，包括Mojang映射文件的转换流程和完整的反编译步骤，帮助开发者理解如何将混淆的游戏代码转化为可读的Java源码。

反编译流程概览：从混淆代码到可读源码

DecompilerMC的工作流程主要分为五个关键阶段，每个阶段环环相扣，最终实现从混淆Jar包到可执行Java代码的转换。整个过程利用了Mojang官方发布的ProGuard映射文件，结合SpecialSource和CFR/Fernflower等工具完成代码还原。

核心工作流程图解

Minecraft Jar包 → [下载映射文件] → [转换映射格式] → [重映射Jar] → [删除依赖] → [反编译] → 可读Java代码

输入：Minecraft官方混淆Jar包（客户端或服务器）
输出：位于/src/<版本号>/<客户端/服务器>目录下的可读Java源码

关键步骤解析：Mojang映射文件的处理与应用

1. 映射文件下载：获取Mojang官方ProGuard映射

DecompilerMC首先从Mojang服务器获取指定版本的官方映射文件。这些映射文件记录了混淆后的类名、方法名与原始名称的对应关系，是反编译的基础。

在main.py中，get_mappings()函数负责这一过程：

从版本清单（version.json）中提取映射文件URL
将映射文件下载到/mappings/<版本号>/<客户端/服务器>.txt路径
支持断点续传，已存在的文件不会重复下载

2. 映射格式转换：ProGuard到TSRG格式的转换

Mojang提供的映射文件采用ProGuard格式，而SpecialSource工具需要TSRG格式的映射文件。DecompilerMC通过convert_mappings()函数完成这一关键转换：

核心转换逻辑：
- 解析ProGuard格式的类、方法和字段映射
- 将类名从.分隔转换为/分隔的内部形式（如net.minecraft.client→net/minecraft/client）
- 处理数组类型和泛型签名，确保类型信息完整
- 生成TSRG格式文件保存到/mappings/<版本号>/<客户端/服务器>.tsrg

关键代码实现：

# 映射文件转换核心代码片段 def convert_mappings(version: str, side: SideType, quiet) -> None: version_side_path = (PATH_TO_ROOT_DIR / "mappings" / version / f"{side}.txt") with open(version_side_path, 'r') as inputFile, open(PATH_TO_ROOT_DIR / "mappings" / version / f"{side}.tsrg", 'w+') as outputFile: for line in inputFile.readlines(): if line.startswith('#'): # 跳过注释行 continue deobf_name, obf_name = line.split(' -> ') # 类映射处理 if not line.startswith(' '): outputFile.write(remap_file_path(obf_name)[1:-1] + " " + remap_file_path(deobf_name)[1:-1] + "\n") # 方法和字段映射处理 else: # 解析方法签名和参数类型 # ... outputFile.write(f'\t{obf_name} ({variables}){method_type} {function_name}\n')

3. Jar包重映射：使用SpecialSource还原类名

获取并转换映射文件后，DecompilerMC使用SpecialSource工具对原始Jar包进行重映射，将混淆的类名、方法名替换为有意义的名称：

执行流程：
1. 验证/lib/SpecialSource-1.11.4.jar是否存在
2. 调用Java命令执行SpecialSource：
```
java -jar SpecialSource-1.11.4.jar --in-jar <原始Jar> --out-jar <重映射Jar> --srg-in <TSRG映射文件> --kill-lvt
```
3. 生成临时重映射Jar包到/src/<版本号>-<客户端/服务器>-temp.jar
关键参数：
- --kill-lvt：移除局部变量表信息，减少反编译后代码的冗余