Duckov Custom Model Tools

Unity Editor 工具集，用于为 Duckov 游戏构建 Mod DLL 和 AssetBundle。

功能

• Mod DLL 生成工具: 自动生成 Mod DLL 文件，包含必要的配置和元数据
• AssetBundle 打包工具: 将模型预制件打包为 AssetBundle
• 游戏路径设置: 自动查找或手动设置游戏安装路径

安装

通过 Git URL 安装

1. 在 Unity 中打开 Package Manager
2. 点击左上角的 + 按钮
3. 选择 "Add package from git URL"
4. 输入仓库的 Git URL：https://github.com/Duckov-Custom-Model/DuckovCustomModel-SDK.git

通过本地路径安装

1. 将整个文件夹复制到项目的 Packages 目录下
2. Unity 会自动识别并加载 package

使用方法

SDK 默认英文。通过 Duckov Custom Model > Language Settings 或任意 SDK 窗口／组件顶部的 Language 选择语言，所有界面共用并保存选择。新增语言只需在 Editor/Localizations 增加一个包含 id、name、strings 的 JSON；语言列表自动更新，缺失翻译回退英文，配置字段和参数名称不会被翻译。

Prefab 动骨

1. 给模型根物体添加 Duckov Custom Model > Spring Bones，添加头发、裙摆或饰品的骨链。可锁定 Inspector 后选中根骨骼，再点“Add Selected Roots”。无分叉会自动延伸，有分叉时指定末端骨骼。
2. 按链调整回弹刚度、运动阻尼、重力和碰撞半径；末端尾点偏移留零时自动延伸。
3. 在头部或身体骨骼上添加“Spring Bone Collider”，选择球体或胶囊体，再在动骨组件中“Collect Model Colliders”。Scene 中可直接调整碰撞范围。
4. 在场景或 Prefab 编辑模式中“Start Preview”，可选动画与往返移动测试。停止、保存和进入播放模式会还原姿势。
5. 正常打包 AssetBundle，游戏自动运行，不需要挂 VRM 组件。相同骨骼不能交给多个动骨组件重复计算。

设置游戏路径

1. 在 Unity 菜单栏选择 Duckov Custom Model > Game Path Settings
2. 点击"自动查找"按钮（Windows 平台）或"浏览"按钮手动选择游戏安装目录

生成 Mod DLL

1. 在 Unity 菜单栏选择 Duckov Custom Model > Build Mod DLL
2. 填写 DLL 名称（将用作命名空间）
3. 填写 Mod 显示名称和描述（可选）
4. 选择预览图（可选）
5. 勾选"自动复制到游戏文件夹"（需要先设置游戏路径）
6. 点击"生成 Mod DLL"按钮

打包 AssetBundle

1. 在 Unity 菜单栏选择 Duckov Custom Model > Build AssetBundle
2. 输入 Bundle 名称
3. 选择目标平台
4. 添加模型预制件
5. 点击"导出模型 Bundle"按钮

系统要求

• Unity 2020.3 或更高版本
• Windows 平台（Steam 路径自动查找功能仅限 Windows）

许可证

本项目采用 MIT License 许可证。

Copyright (c) 2025 OLC