BongoCat自定义模型快速上手指南

BongoCat自定义模型快速上手指南

【免费下载链接】BongoCat让呆萌可爱的 Bongo Cat 陪伴你的键盘敲击与鼠标操作，每一次输入都充满趣味与活力！项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat

想要让桌面上的BongoCat变得与众不同吗？本文将通过简单三步，帮助你将任何Live2D模型转化为能够响应键盘鼠标操作的个性化桌面宠物。无需编程经验，只需跟随指引，10分钟即可完成专属设置。

准备标准模型文件

BongoCat支持Live2D Cubism 3/4格式的模型文件，你需要准备以下核心文件：

• 主配置文件（.model3.json）
• 模型数据文件（.moc3）
• 纹理图片文件夹（包含PNG格式纹理图）
• 动作文件（.motion3.json，可选）
• 表情文件（.exp3.json，可选）

官方预设模型结构可参考：src-tauri/assets/models/standard/

模型配置文件是成功导入的关键，需要正确定义文件之间的引用关系。以下是一个标准配置示例：

{ "Version": 3, "FileReferences": { "Moc": "demomodel.moc3", "Textures": [ "demomodel.1024/texture_00.png", "demomodel.1024/texture_01.png", "demomodel.1024/texture_02.png" ], "DisplayInfo": "demomodel.cdi3.json", "Expressions": [ { "Name": "live2d_expression0.exp3.json", "File": "live2d_expression0.exp3.json" }, { "Name": "live2d_expression1.exp3.json", "File": "live2d_expression1.exp3.json" } ], "Motions": { "CAT_motion": [ { "File": "live2d_motion1.motion3.json", "Sound": "live2d_motion1.flac", "FadeInTime": 0, "FadeOutTime": 0 } ] } } }

快速导入模型步骤

第一步：创建专属模型文件夹在项目的模型目录中创建新文件夹：src-tauri/assets/models/ 建议使用有意义的名称作为模型标识，如"my_personal_cat"。

第二步：复制模型文件将准备好的所有模型文件复制到新建的文件夹中，确保文件结构与官方模型保持一致。特别注意所有文件路径在.model3.json中是否正确引用，相对路径以配置文件所在位置为基准。

第三步：配置模型信息编辑模型存储文件：src/stores/model.ts 在初始化函数中添加你的模型配置信息：

nextModels.unshift({ id: "my_personal_cat", mode: "standard", isPreset: false, path: join(modelsPath, "my_personal_cat") })

配置交互行为设置

设置按键响应映射编辑交互逻辑文件：src/composables/useModel.ts 配置个性化的按键映射关系：

const keyMappings = { 'KeyA': 'left_action', 'KeyD': 'right_action', 'Space': 'special_effect' }

调整显示效果如果导入的模型尺寸不合适，可以在相关函数中调整缩放比例：

catStore.window.scale = round((size.width / width) * 75);

应用测试与问题排查

完成上述所有配置后，重新启动BongoCat应用，在设置界面的模型选择中就能看到你的自定义模型了。点击应用后，模型会立即加载并对你的键盘操作做出响应。

如果遇到模型无法加载或动作异常的情况，请检查以下方面：

• 模型文件路径是否正确
• .model3.json配置文件是否有语法错误
• 纹理图片格式是否为PNG且尺寸合适
• 模型文件权限是否正常

现在，你已经成功创建了专属的BongoCat桌面宠物！可以继续探索添加更多自定义动作和特效，让你的桌面伙伴更加生动有趣。

【免费下载链接】BongoCat让呆萌可爱的 Bongo Cat 陪伴你的键盘敲击与鼠标操作，每一次输入都充满趣味与活力！项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat