Live2D MC —— 把 Live2D 模型放进 Minecraft（1.20.1 Forge）

一句话简介

纯客户端模组：把你的 Live2D 模型变成常驻桌面的游戏挂件 —— 眨眼、呼吸、动作、表情叠加、跟随鼠标、拖动摆位，配一套自绘的圆角设置界面（深/浅主题，无贴图无着色器）。

简介

Live2D MC 是一个 纯客户端 的 Minecraft 1.20.1 Forge 模组，把 Live2D（Cubism 3/4/5，.moc3）模型带进游戏：

• 既可以是常驻屏幕角落的桌面挂件（HUD），显示在所有界面之上；
• 也可以在设置界面里当预览画布，像桌面宠物一样摆弄。 模型由你自己提供，放进 config/live2dmc/live2d/ 即可，mod 不附带任何模型。

功能

• 模型扫描与切换：自动扫描模型目录（*.model3.json），支持多个模型轮换，一键重扫/打开目录。
• 预览即拖拽：在预览画布上按住鼠标就能移动模型，双击回正；缩放、不透明度实时生效。
• 桌面挂件 HUD：整屏地图直接拖动定位，独立缩放，显示在物品栏、聊天、设置等所有界面之上。
• 动作 / 表情：播放下一个动作；表情多选叠加、勾选立即生效、取消立刻还原（参数级恢复，不用重进游戏）。 模型没写 Expressions 时会自动扫描目录下的 *.exp3.json。
• 参数面板：按 cdi3.json 列全部参数（含分组），滑条直接覆盖模型参数，盖过眨眼/跟随/动作； 支持"只看已改"、一键还原，修改会持久化。
• 部件开关：隐藏/显示模型部件（用合成表情实现），状态持久化。
• 跟随鼠标 / 眨眼 / 自动动作 均可单独开关。
• 深色 / 浅色主题：右上角一键切换，会记住选择。
• 设置界面：5 个页签（模型 / HUD / 参数 / 部件 / 表情），全部自绘控件（圆角 + 抗锯齿，零贴图、零着色器），中英双语。
• 附属 Mod 接口（v1）：Live2DMcApi（模型/表情/参数/部件/HUD/渲染）、Live2DMcUiApi（往设置界面加页签）、Live2DMcEvents（状态监听）。

安装与使用

1. 安装 Minecraft 1.20.1 + Forge 47.4.10 或更高（需 Java 17）。
2. 把 live2dmc-1.0.0.jar 放进 mods/。
3. 首次启动后，把模型目录放进 config/live2dmc/live2d/<模型名>/，目录里要有 *.model3.json （建议同时带 *.cdi3.json，参数/部件页才有完整列表）。
4. 进游戏按 L 打开设置界面（可在「选项 → 控制 → 按键绑定」里改键）。

注意事项

• 仅支持 Windows x64（内置原生库只打包了 windows-x64），macOS / Linux 暂不可用。
• 纯客户端：服务器不需要安装；请遵守所玩服务器的客户端 mod 规则。
• 不附带模型：模型版权归原作者，请自行确认授权（Live2D 官方示例模型也有各自的许可条款）。
• 部件开关有局限：只有当模型的 drawable 确实挂在部件下时才看得出效果，部分导出工具不按部件组织 drawable。
• 内含 Live2D Cubism Core，使用与再分发需遵守 Live2D 的许可条款；许可文件保留在 jar 的 META-INF/licenses/（NOTICE-Live2D.txt、LICENSE-Live2D-JavaBinding.txt）。
• 未与 OptiFine / 光影 / 其他 GUI 大改 mod 做兼容性测试。