Minecraft计时器插件加载失败及命令执行异常问题

核心原因 #

NoClassDefFoundError: tv/bebaeb/mcplugion/timer/Timer 表明JVM运行时无法找到Timer类的字节码文件，本质是类编译或打包环节出现遗漏，导致插件Jar包中不存在该类的.class文件。

具体修复步骤 #

1. 检查编译输出 #

• 确认IDE编译输出目录（如target/classes或bin）中，是否存在tv/bebaeb/mcplugion/timer/Timer.class文件。
• 若不存在，重新执行编译操作，确保Timer类代码无语法错误、编译过程无报错。

2. 验证打包配置 #

• 用Maven/Gradle打包时：
  • Maven：检查pom.xml中maven-shade-plugin或maven-jar-plugin配置，确保tv/bebaeb/mcplugion/timer包被包含进最终Jar。
  • Gradle：检查build.gradle的jar任务配置，确认include规则覆盖目标包。
• 手动打包时：确保将所有编译生成的.class文件（含Timer.class）按包结构添加到Jar中。

3. 排查代码依赖引用 #

• 检查TimerCommand类中对Timer类的引用是否正确，避免包名、类名拼写/大小写错误。
• 确认插件主类中Timer相关实例的初始化逻辑，避免类加载阶段因依赖缺失导致启动失败。

4. 服务器端验证 #

• 替换修复后的插件Jar，重启服务器，查看启动日志是否仍有NoClassDefFoundError。
• 测试/timer命令：先执行无参数命令确认提示正常，再执行带参数命令验证功能恢复。

附加排查点 #

• 若使用第三方依赖，确认依赖是否被正确打包进插件Jar（如Maven Shade的relocate配置是否合理，避免类冲突）。
• 检查服务器Java版本与插件编译时的Java版本是否兼容（推荐使用Minecraft服务器对应版本支持的Java版本）。

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