教程
教程目录
按任务挑一篇跟着做：每篇都有完整代码、运行检查点与常见坑
以下教程按「做一个能跑起来的功能」组织，每篇都是独立任务，可以从任意一篇开始。
01序章：把环境搭起来一个能编译、能进游戏、在模组列表里显示
ACTIVE 的空模组工程。之后所有教程都从这份工程继续。
02第一个模组一个会「说话」的模组——启动时依次打印三段日志、在模组自己的数据目录里存一个计数、并在游戏右下角弹出一次提示。
03自定义 HUD把原版右上角的连击数藏掉，改成屏幕中央一行自己的大字连击，并在底部画一条简易进度条。
04自定义打击特效把默认的判定文字换成自己的一套命中特效（先文字、再图片动画），并能按判定等级区分、在运行时改时长或取消。
05添加判定等级在 PERFECT 之上新增一个只在 30ms 内触发的 ULTRA 等级，让 HUD 连击、日志、结算统计和判定文字都认这一档。
06添加新音符类型一种只在谱面里写 "type": "burst" 才出现的双击音符——第一次点击把它点亮，260ms 内再点一次判 PERFECT；只点一次则在自己的二击窗口到期后判 MISS。整个实现只依赖 mod-api，不改内核。
07添加游戏模式一个叫「镜像」的游戏模式——谱面左右翻转，按键判定跟着翻转；它会出现在选曲界面的模式列表里，可以和内置模式一样被选中，并在游玩画面上打一个水印。
08订阅游玩事件一个模组，在音符判定、连击中断、每帧和按键时打日志，并能真的吞掉某一条轨道的按键。
09贴图与译文模组自带一张 PNG 与中英文语言文件，在游玩画面的左下角画出这张图，旁边的文案随游戏语言在「徽章 / Badge」之间切换。
10设置项与快捷键一个模组，在原生设置里多出自己的一页，页里有一个开关和一个数值行；再注册一个全局快捷键，按下后切换演示状态。改过的设置和改过的键位，重启后都还在。
11自定义场景一个模组，按快捷键（默认，玩家可在设置里改）打开一块自绘的「练习面板」——标题、提示、一个真正能打字的输入框；按 ESC 或再按一次快捷键，回到打开前的界面。
12打包与发布一个能被游戏加载、能分享给别人的模组 jar，含版本与依赖声明。