三步打造专属桌面猫咪：BongoCat自定义模型导入全攻略
项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat 你是否已经厌倦了千篇一律的桌面宠物？想让你的BongoCat与众不同？本文将带你通过简单三步，将任何Live2D模型转化为会对你的键盘和鼠标操作做出反应的专属桌面猫咪。无需编程基础，只需跟着指引操作，5分钟即可完成个性化设置。
一、准备符合规范的模型文件
BongoCat支持标准Live2D Cubism 3/4格式的模型文件，你需要准备以下文件结构：
- 主配置文件（.model3.json）
- 模型数据文件（.moc3）
- 纹理图片文件夹（包含.png格式纹理图）
- 动作文件（.motion3.json，可选）
- 表情文件（.exp3.json，可选）
官方预设模型结构可参考：src-tauri/assets/models/standard/
模型配置文件（.model3.json）是关键，需要正确定义文件引用关系。以下是一个基本的配置示例：
{
"Version": 3,
"FileReferences": {
"Moc": "demomodel.moc3",
"Textures": [
"demomodel.1024/texture_00.png",
"demomodel.1024/texture_01.png"
],
"Motions": {
"CAT_motion": [
{
"File": "live2d_motion1.motion3.json",
"FadeInTime": 0.5
}
]
}
}
}
二、导入模型到BongoCat
-
创建模型文件夹 在项目的模型目录中创建新文件夹：src-tauri/assets/models/ 建议使用有意义的名称（如"my_custom_cat"）作为你的模型标识。
-
复制文件到目录 将准备好的所有模型文件复制到新创建的文件夹中，保持文件结构与官方模型一致。确保所有文件路径在.model3.json中正确引用，相对路径以配置文件所在位置为基准。
-
修改模型存储配置 编辑模型存储文件：src/stores/model.ts 在初始化函数中添加你的模型信息：
nextModels.unshift({
id: "my_custom_cat", // 唯一标识
mode: "standard", // 模型类型：standard/keyboard/gamepad
isPreset: false, // 设为false表示自定义模型
path: join(modelsPath, "my_custom_cat"), // 模型文件夹路径
})
三、配置模型交互行为
BongoCat通过参数映射实现模型对用户输入的响应，你需要配置键盘按键与模型动作的对应关系。
-
编辑模型交互逻辑 打开模型交互逻辑文件：src/composables/useModel.ts
-
设置按键响应 在handlePress函数中添加按键与动作的映射关系：
const handlePress = (key: string) => {
// 自定义按键映射
const keyMappings = {
'KeyA': 'left_paw',
'KeyS': 'right_paw',
'Space': 'jump'
};
const motionPath = modelStore.supportKeys[keyMappings[key]];
if (motionPath) {
live2d.startMotion(motionPath);
}
}
- 调整模型大小与位置 如果导入的模型大小不合适，可以在handleResize函数中调整缩放比例：
catStore.window.scale = round((size.width / width) * 80); // 80为缩放百分比
四、应用与测试
完成上述步骤后，重新启动BongoCat应用，在设置界面的模型选择中就能看到你的自定义模型了。点击应用后，模型会立即加载并对你的键盘操作做出反应。
如果模型无法加载或动作异常，可以检查：
- 模型文件路径是否正确
- .model3.json配置是否有语法错误
- 纹理图片格式是否为PNG且尺寸合适
- 模型文件权限是否正常
现在，你已经成功创建了专属的BongoCat模型！尝试添加更多自定义动作和表情，让你的桌面猫咪更加生动有趣。如有疑问，可以参考项目官方文档或提交issue获取帮助。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
