前言
如果你还不了解 BongoCat 是什么，可以先阅读这篇介绍文章：BongoCat 桌宠焕新升级！开源 × 跨平台，快来撸猫！。
本文将带你了解如何制作一个适用于BongoCat的模型，并将其导入使用。
模型制作
BongoCat 的模型参数与 BongoCatMver 完全一致，保持高度兼容性。同时，BongoCat 还额外支持 Live2D Cubism 5 模型格式。
由于我本人不擅长模型制作，这里强烈推荐一位老师@wtyyyyyy的教学视频，新手朋友们可以参考学习：
如果你暂时还不会制作模型也没关系，可以先看看我整理的一些免费模型资源，先玩起来也不错：
目录结构
├── *.model3.json # 模型主配置文件（必须，定义模型结构及资源引用）
├── *.moc3 # 模型核心文件（必须，包含网格与变形信息）
├── *.cdi3.json # 模型显示信息配置文件（必须，用于编辑器中的显示设置）
├── *.exp3.json # 表情配置文件（可选，用于定义不同表情效果）
├── *.motion3.json # 动作配置文件（可选，用于定义动画序列）
└── resources/
├── background.png
├── cover.png
├── left-keys/
│ └── ...
└── right-keys/
└── ...
模型文件结构不再过多赘述，重点说明 resources 目录内容：
-
background.png：模型的背景图（可选）。
-
cover.png：模型预览封面图，显示于模型管理界面中。
-
left-keys：左侧键盘按键图像目录，包含所有左手按键的图片资源。
-
right-keys：右侧键盘按键图像目录，包含所有右手按键的图片资源。
模型参数
通用模型参数
| 参数 ID | 范围 | 默认值 | 说明 |
|---|---|---|---|
| ParamAngleX | [-30, 30] | 0 | 控制模型头部与身体的水平位置（-30 = 最左，30 = 最右） |
| ParamAngleY | [-30, 30] | 0 | 控制模型头部与身体的垂直位置（-30 = 最上，30 = 最下） |
| CatParamLeftHandDown | [0, 1] | 0 | 控制模型左手按下状态（0 = 抬起，1 = 按下） |
标准模式模型参数
| 参数 ID | 范围 | 默认值 | 说明 |
|---|---|---|---|
| ParamMouseX | [-30, 30] | 0 | 控制模型鼠标交互与右手的水平位置（-30 = 最左，30 = 最右） |
| ParamMouseY | [-30, 30] | 0 | 控制模型鼠标交互与右手的垂直位置（-30 = 最上，30 = 最下） |
| ParamMouseLeftDown | [0, 1] | 0 | 控制模型鼠标左键按下状态（0 = 抬起，1 = 按下） |
| ParamMouseRightDown | [0, 1] | 0 | 控制模型鼠标右键按下状态（0 = 抬起，1 = 按下） |
键盘模式模型参数
| 参数 ID | 范围 | 默认值 | 说明 |
|---|---|---|---|
| CatParamRightHandDown | [0, 1] | 0 | 控制模型右手按下状态（0 = 抬起，1 = 按下） |
手柄模式模型参数
| 参数 ID | 范围 | 默认值 | 说明 |
|---|---|---|---|
| CatParamRightHandDown | [0, 1] | 0 | 控制模型右手按下状态（0 = 抬起，1 = 按下） |
| CatParamStickLeftDown | [0, 1] | 0 | 控制模型左摇杆按下状态（0 = 抬起，1 = 按下） |
| CatParamStickRightDown | [0, 1] | 0 | 控制模型右摇杆按下状态（0 = 抬起，1 = 按下） |
| CatParamStickShowLeftHand | [0, 1] | 0 | 控制模型左摇杆手部的显示状态（0 = 隐藏，1 = 显示） |
| CatParamStickShowRightHand | [0, 1] | 0 | 控制模型右摇杆手部的显示状态（0 = 隐藏，1 = 显示） |
| CatParamStickLX | [-30, 30] | 0 | 控制模型左摇杆水平位置（-30 = 最左，30 = 最右） |
| CatParamStickLY | [-30, 30] | 0 | 控制模型左摇杆垂直位置（-30 = 最上，30 = 最下） |
| CatParamStickRX | [-30, 30] | 0 | 控制模型右摇杆水平位置（-30 = 最左，30 = 最右） |
| CatParamStickRY | [-30, 30] | 0 | 控制模型右摇杆垂直位置（-30 = 最上，30 = 最下） |
键位映射
键盘
如果
F1~F12只有一张图片，但希望按下任意一个功能键都能触发，那就直接命名为Fn。如果
Shift*、Control*、Alt*、Meta*只有一张图片，但希望左右两边按下都能触发对应效果，那就直接命名为Shift、Control、Alt、Meta。
手柄
敬请期待
导入模型
将下载好的 ZIP 模型解压后，按照下图的指示将整个文件夹导入即可。
