如何修复MCP反编译重编译后启动Minecraft客户端崩溃问题

前提说明 #

反编译./decompile.sh、重编译./recompile.sh全程无报错可排除基础代码编译错误，未修改代码可排除自定义代码逻辑故障，问题集中在运行环境适配、临时缓存损坏、依赖缺失三类场景。

排查修复步骤 #

• 校验Java版本兼容性
  不同版本MCP对应的Minecraft版本对Java版本有严格要求：
  • Minecraft 1.12及更低版本必须使用Java 8，更高版本Java会出现类加载异常、方法签名不匹配错误
  • Minecraft 1.16~1.17版本要求使用Java 11
  • Minecraft 1.18及更高版本要求使用Java 17
    执行java -version确认当前环境Java版本与你使用的MCP适配的MC版本一致，版本不匹配请切换对应Java版本后重试启动。
• 清理缓存重置构建流程
  MCP临时缓存文件损坏会导致编译正常但运行失败，执行以下命令重置状态：

  ./cleanup.sh
  ./decompile.sh
  ./recompile.sh
  ./startclient.sh
  

• 校验原生依赖完整性
  MCP运行客户端依赖对应版本的LWJGL原生动态链接库，文件缺失、架构不匹配会触发运行时崩溃：
  检查jars/bin目录下的依赖文件是否完整，若使用ARM架构设备（苹果M系列芯片、ARM架构Linux设备），需替换为对应ARM架构的LWJGL库文件后再启动。
• 校验启动脚本配置
  确认startclient.sh中的主类配置、JVM参数未被意外修改，默认配置下主类为net.minecraft.client.main.Main，JVM内存分配参数不得超过当前设备可用内存上限。

内容的提问来源于stack exchange，提问作者sbh