序章：把环境搭起来

打开命令行：

javac -version
java -version

两条都要是 17 或更高。提示「不是内部或外部命令」说明 JDK 没装或没进 PATH，先解决这个再往下走。

把 mods-template.zip 解压到任意目录（路径不要带空格和中文，部分工具链对空格敏感）：

my-mod/
├── mod-api-3.2.jar      ← 编译期 API（模板已带）
├── gson-2.10.1.jar      ← 编译期依赖（模板已带）
├── build.bat            ← 一键构建脚本
├── pom.xml              ← Maven 路线（与 build.bat 二选一）
├── README.md
└── src/main/
    ├── java/com/example/mymod/ExampleMod.java
    └── resources/assets/example_mod/

src/main/java 放代码，src/main/resources 放资源；资源在 jar 里的路径就是 assets/...。

用记事本打开 build.bat，找到顶部这几行改成你自己的：

set "MOD_ID=hello_mod"
set "MOD_NAME=Hello Mod"
set "MOD_VERSION=0.1.0"
set "MOD_CLASS=com.example.hellomod.HelloMod"
set "API_VERSION=3.2"

四条注意：

• MOD_ID 只能用小写字母、数字、_、.、-；它同时是资源命名空间和数据目录名；
• MOD_CLASS 必须是入口类的全限定名，要和 package + 类名完全一致；
• API_VERSION 写 3.2；
• 改完把示例的包名/类名一起改成 com.example.hellomod.HelloMod，或者反过来把 MOD_CLASS 指向示例类。

双击 build.bat，或在命令行执行：

build.bat

成功时产物在 target\hello_mod-0.1.0.jar。脚本实际做了四件事：javac 编译 → 复制资源 → 写入 manifest（入口类、模组 id、版本、API 版本等）→ jar 打包。

把 jar 复制到游戏根目录的 mods\：

<游戏目录>/
├── mods/
│   └── hello_mod-0.1.0.jar
└── (游戏本体文件…)

重启游戏，打开模组列表找到你的模组。状态必须是 ACTIVE。

在游戏日志里搜模组 id（日志行前缀是 [<模组id>]，logger 名为 seecmd.mod.<模组id>）。能看到入口类打印的初始化日志，就说明代码真的跑起来了。