# Convert-to-MMD

**Repository Path**: uitcis/Convert-to-MMD

## Basic Information

- **Project Name**: Convert-to-MMD
- **Description**: Convert to MMD  in blender
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2025-01-24
- **Last Updated**: 2025-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Convert to MMD Addon for Blender

## 描述
该插件用于将Blender中的其他骨骼结构转换为符合MMD（MikuMikuDance）格式的骨骼名称和结构。插件提供了多种功能，包括骨骼重命名、缺失骨骼补全、预设导出与导入以及IK链的添加。

## 主要功能
1. **骨骼重命名**：将选中的骨骼重命名为MMD格式的名称。
2. **缺失骨骼补全**：自动创建并定位MMD格式中缺失的骨骼。
3. **IK链添加**：通过`添加IK`按钮为角色添加MMD格式的IK链。
4. **创建骨骼集合**：创建并分配骨骼到骨骼集合。
5. **预设导出与导入**：导出当前骨骼配置为预设文件，或从预设文件导入骨骼配置。

## 使用方法
1. **安装插件**：
   - 打开Blender，进入`偏好设置 > 插件`，点击`安装`按钮，选择插件文件进行安装。
   - 安装完成后，确保插件已被启用。

2. **导入导出预设**：
   - 导入预设：点击`导入预设`按钮，选择预设文件。
   - 导出预设：点击`导出预设`按钮，选择保存路径。

3. **选择对应骨骼**：
   - 选择一个骨架对象。
   - 在右侧的`Convert to MMD`面板中，选择需要操作的骨骼。

4. **重命名骨骼**：
   - 在`Convert to MMD`面板中，选择需要重命名的骨骼，点击`1.重命名为MMD`按钮。

5. **缺失骨骼补全**：
   - 点击`Convert to MMD`面板中的`2.补全缺失骨骼`按钮，插件会自动创建并定位缺失的骨骼。

6. **IK链设置**：
   - 点击`Convert to MMD`面板中的`3.添加MMD IK`按钮，插件会为角色添加MMD格式的IK链。

7. **骨骼分组操作**：
   - 使用面板中的`3.添加MMD IK`按钮创建骨骼集合。

## 依赖项说明
1. **mmd_tools插件安装**：
   - 在Blender插件市场搜索"mmd_tools"并安装。
   - 或从[GitHub Release](https://github.com/UuuNyaa/blender_mmd_tools/releases)下载对应版本。
   - 安装后需在`偏好设置 > 插件`中启用"MMD Tools"模块。

## 常见问题解决
❌ 错误：找不到mmd_tools插件  
✅ 解决方案：
1. 在Blender插件市场搜索安装mmd_tools。
2. 确保安装版本≥0.5.0。
3. 重启Blender后启用插件。

❌ 错误：骨骼位置偏移  
✅ 解决方案：
1. 在`物体模式`下选择骨架后按`Ctrl+A`应用全部变换。
2. 检查骨架属性中的轴向设置 左右方向骨骼X轴向前 上下方向骨骼X轴向右。

## 注意事项
- 确保在使用插件前备份您的项目。
- 重命名前请仔细核对骨骼映射关系。
- 如果遇到问题，请参考插件文档或联系开发者。