如何在调试模式下运行gradlew runClient？Minecraft模组调试问题

有两种可靠的方式可以让你在调试模式下运行runClient任务，让IntelliJ的断点正常工作：

方法一：命令行启动调试模式 + IDE远程连接 #

• 打开终端，在模组项目根目录执行：

  gradlew runClient --debug-jvm
  

  这个命令会启动JVM并暂停，等待调试器连接，默认监听端口为5005。
• 在IntelliJ中配置远程调试：
  1. 点击顶部菜单栏的Run > Edit Configurations
  2. 点击左上角的+号，选择Remote JVM Debug
  3. 给配置起个名字（比如MC Mod Debug），默认的localhost和5005端口保持不变，点击Apply保存
  4. 点击Debug按钮启动调试器，此时Minecraft客户端会继续启动，你的断点就能正常触发了

方法二：直接在IntelliJ中配置Gradle调试任务 #

• 打开Run > Edit Configurations
• 点击+号，选择Gradle
• 配置项填写：
  • Name：自定义名称（比如Run Client with Debug）
  • Tasks：输入runClient
• 切换到Arguments标签页，在VM options中添加调试参数：

  -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=*:5005
  

• 保存配置后，点击Debug按钮启动任务，客户端会等待调试器连接，启动完成后断点即可生效

注意事项 #

• 确保调试前你的代码已经最新编译，可以先执行gradlew build或者在IntelliJ中执行Build > Build Project
• 断点要打在你自己编写的模组代码上，如果需要调试Minecraft原生代码，先执行gradlew genSources下载完整源码，否则断点可能无法识别
• 如果5005端口被占用，可修改参数中的address=*:5005为其他端口（比如:5006），同时IDE远程调试配置中的端口也要对应修改

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