SRP Animation Capture Mod

MC 1.12.2 Forge mod for capturing SRP entity animations at runtime.

安装

1. 安装 Minecraft 1.12.2 + Forge 14.23.5.2860
2. 安装 SRP 1.10.7
3. 将 srpcapture-1.0.0.jar 放入 .minecraft/mods/

使用

快速开始

1. 进入游戏，生成目标生物
2. 准星对准生物
3. 输入 /capture start 10
4. 按屏幕提示操作：
   • 阶段 1 (Idle): 站着不动 10 秒
   • 阶段 2 (Walk): 走动引诱生物 10 秒
   • 阶段 3 (Attack): 攻击生物 10 秒
5. 自动保存到 .minecraft/captures/ 目录

命令

命令	说明
/capture start [秒]	开始录制（准星对准生物）
/capture start <名称> [秒]	指定生物名开始录制
/capture stop	停止并保存
/capture cancel	取消不保存
/capture skip	跳过当前阶段
/capture status	查看状态

输出文件

.minecraft/captures/venkrol_20260721_153000.jsonl

每行一个 JSON 对象，包含：

• 运行时变量（getBODY, getAttackTimer, limbSwing 等）
• 所有骨骼的旋转值（rotateAngleX/Y/Z, offsetX/Y/Z, isHidden）

交给转换器

将 .jsonl 文件提供给 SubspaceParasite 转换器：

from engine.runtime_sampler import RuntimeSampler
sampler = RuntimeSampler("captures/venkrol_20260721_153000.jsonl")
# 转换器会使用真实运行时变量值生成完美还原的 .bbmodel

构建

./gradlew build
# 输出: build/libs/srpcapture-1.0.0.jar

模组冲突

需要 Mixin 加载器（MixinBootstrap 或 Rimuru's Mod Menu 等）。