feat: Add KoikatsuBlenderPipeline addon with import/export functionality

- Add core addon files (__init__.py, KKPanel.py, preferences.py, common.py)
- Add import pipeline with armature, mesh, and material modification modules
- Add export pipeline with material baking and FBX preparation utilities
- Add material combiner tool for texture atlas generation and optimization
- Add extras utilities for animation, rigging, and asset management
- Add bone orientation data from better_fbx for accurate skeletal structure
- Add comprehensive documentation and wiki with multi-language support (EN, JP, ZH)
- Add animation library retargeting lists for ARP and Rokoko motion capture
- Add Rigify integration scripts for advanced rigging workflows
- Add shader file (KK Shader V8.0.blend) for material rendering
- Add manifest and license files for addon distribution
- Add changelog documenting version history and improvements
- Initialize complete Blender addon project for Koikatsu character import/export
This commit is contained in:
2025-12-06 15:26:19 +08:00
commit 5d9e09e9c3
122 changed files with 22683 additions and 0 deletions

67
wiki/armature_zh.md Normal file
View File

@@ -0,0 +1,67 @@
---
layout: default
---
# 骨架
## KKBP 骨架
如果你**计划导出模型**KKBP 骨架是最佳选择。
KKBP 骨架具有以下特性:
* 眼睛控制器骨骼
* 手部和腿部 IK
* 脚跟 IK
* 可以一次移动所有骨骼的中心骨骼
## Rigify 骨架
如果你**计划在 Blender 中使用模型**Rigify 骨架是最佳选择。
必须启用 Rigify 插件才能使此骨架正常工作。
Rigify 骨架包含许多不同的功能:
* 眼睛控制器骨骼
* 手部和腿部 IK
* 脚跟 IK
* 可以一次移动所有骨骼的中心骨骼
* IK 到 FK 滑块
* IK 到 FK 过渡辅助器
* IK 肢体拉伸
* 用于肢体变形的微调骨骼
* 易于使用的手指骨骼
* 手指 IK
* 手掌骨骼
* 脚部旋转骨骼
* 眼睛注视目标
* 独立眼睛骨骼
* FK 眼睛骨骼
* 舌头 IK
* 头部和颈部跟随滑块
* 头部注视目标
查看[此视频系列以了解 Rigify 插件是什么以及如何一般使用它](https://www.youtube.com/watch?v=-JSFcSxsaTs&list=PLdcL5aF8ZcJv68SSdwxip33M7snakl6Dx)。
查看[此页面以获取有关 KKBP Rigify 骨架的特定信息](https://github.com/FlailingFog/KK-Blender-Porter-Pack/issues/78)。
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm4.gif)
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm5.gif)
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm6.png)
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm7.png)
## Koikatsu 骨架
Koikatsu 骨架是一个试图匹配游戏内骨架结构的骨架。此骨架不带 IK仅支持 FK。
## PMX 骨架
PMX 骨架是直接从 KKBP 导出器导出的骨架。此骨架不带 IK仅支持 FK。
## 骨骼集合
KKBP 骨架默认隐藏一些骨骼集合,以使视图不那么杂乱。这些骨骼可以在每个集合中找到。
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm1.png)
可以通过选择骨架并在数据选项卡中查找来找到骨骼集合面板。你可以点击集合旁边的眼睛图标来隐藏/显示它。
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm2.png)
## 关节修正
KKBP 和 Rigify 骨架使用辅助骨骼来使网格在变形时看起来更好。这些辅助骨骼可以在 KKBP 骨架的骨骼集合 2 和 3 中找到。一些关节修正是通过给辅助骨骼添加骨骼约束来实现的其他修正则是通过给辅助骨骼添加驱动器来实现的当特定骨骼旋转时自动设置它们的位置和旋转。下面显示了一个关节修正骨骼的示例。在默认位置cf_s_elboback_L 骨骼保持在原位。当手臂弯曲时cf_s_elboback_L 的位置驱动器会使骨骼向外移动并正确变形手臂。第三张图片是没有启用位置驱动器时手臂的样子。**导出模型时不会保留关节修正,因此除非在目标程序中重新实现驱动器,否则可能会遇到这样的奇怪弯曲。** 所有辅助骨骼的列表可以在 [modifyarmature.py](https://github.com/FlailingFog/KK-Blender-Porter-Pack/blob/master/importing/modifyarmature.py) 的 create_joint_drivers 函数中找到。
![image](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/images/arm3.png)