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:
65
wiki/README_zh.md
Normal file
65
wiki/README_zh.md
Normal file
@@ -0,0 +1,65 @@
|
||||
## 如何使用导出器
|
||||
|
||||
1. 安装 <a style="font-weight:bold" href="https://github.com/ManlyMarco/KK-HF_Patch">Koikatsu 的 HF 补丁</a>，或 <a style="font-weight:bold" href="https://github.com/ManlyMarco/KKS-HF_Patch">Koikatsu Sunshine 的 HF 补丁</a>。
|
||||
**预修改的重新打包版本将无法工作**，除非你使用重新打包的自动更新程序更新或安装 HF 补丁。
|
||||
[点击这里查看重新打包解决方法 #1。](https://github.com/FlailingFog/KK-Blender-Porter-Pack/issues/465#issuecomment-2602969013)
|
||||
[点击这里查看重新打包解决方法 #2。](https://github.com/FlailingFog/KK-Blender-Porter-Pack/issues/523)
|
||||
[点击这里查看重新打包解决方法 #3。](https://github.com/FlailingFog/KK-Blender-Porter-Pack/issues/560)
|
||||
|
||||
1. 找到你的 Koikatsu 安装目录，并将 <a style="font-weight:bold" href="https://github.com/FlailingFog/KK-Blender-Porter-Pack/releases">KKBP 导出器</a>拖到 /bepinex/plugins/ 文件夹中
|
||||
|
||||
1. 启动 Koikatsu 并打开角色制作器
|
||||
|
||||
1. 启用 KKBP 导出器窗口。
|
||||
|
||||
|
||||
1. 更改你的导出选项。[有关所有导出选项的说明，请参见此页面](export_panel)。
|
||||
|
||||
1. 点击屏幕顶部的"Export Model for KKBP"按钮。这可能需要几分钟，具体取决于你的计算机硬件。
|
||||
|
||||
3. 导出完成后，Koikatsu 安装目录中的一个文件夹将弹出
|
||||
|
||||
## 如何使用导入器
|
||||
1. 打开 Blender 4.2 LTS。**不保证其他版本可以工作。** [如果你没有使用 Blender 4.2，请点击这里](faq)
|
||||
|
||||
1. 在 Blender 中安装 <a style="font-weight:bold" href="https://extensions.blender.org/add-ons/mmd-tools/">mmd_tools</a>
|
||||
|
||||
1. 在 Blender 中安装 <a style="font-weight:bold" href="https://github.com/FlailingFog/KK-Blender-Porter-Pack/releases">KKBP Importer 8.0.0</a>
|
||||
|
||||
1. 安装两个插件后，你可以点击 KKBP 面板中的"Import model"按钮。[所有导入选项的说明可以在这里找到](import_panel)
|
||||
|
||||
|
||||
1. 从导出文件夹中选择 .pmx 文件
|
||||
|
||||
|
||||
1. Blender 控制台将出现并开始导入模型。这可能需要几分钟，具体取决于你的计算机硬件
|
||||
|
||||
|
||||
1. 在脚本选项卡中检查导入期间是否没有错误。成功的导入将以"KKBP import finished in XX minutes"结束
|
||||
|
||||
|
||||
## 在 Blender 中编辑模型
|
||||
1. 如果没有错误，你可以通过激活右上角的材质预览来开始按原样使用模型。如果你的计算机编译所有着色器需要很长时间（超过 60 秒），建议通过点击 KKBP 面板中的按钮来完成材质。如果你完成材质，则着色器将非常快速地编译。完成材质可能需要 5 到 30 分钟，具体取决于你的硬件和模型。
|
||||
|
||||
|
||||
1. 如果没有错误但某些东西看起来不对，请查看 [FAQ](faq) 或[材质分解](material_breakdown)页面以获取有关如何编辑材质的信息。
|
||||
|
||||
1. 如果你在导入期间遇到错误，请查看 [FAQ](faq)，或搜索 [Github 仓库上的问题页面](https://github.com/FlailingFog/KK-Blender-Porter-Pack/issues)以查看是否有其他人遇到与你相同的问题。
|
||||
|
||||
## 从 Blender 导出到 fbx：
|
||||
|
||||
1. 启用 Atlas 选项，然后点击 KKBP 面板中的完成材质按钮
|
||||
|
||||
|
||||
1. 这会做三件事
|
||||
* 将所有材质完成为 png 文件并将它们保存到导出文件夹中的 baked_files 文件夹
|
||||
* 为你的身体/头发/衣服创建一个图集文件并将它们保存到导出文件夹中的 atlas_files 文件夹
|
||||
* 创建一个使用图集的新集合
|
||||
|
||||
1. 在大纲视图中隐藏原始集合并显示新集合
|
||||
|
||||
|
||||
1. 如果你想减少骨骼数量，或为 VRM / VRChat / Unreal Engine 转换模型的骨架，请点击"Prep for target application"按钮。
|
||||
|
||||
1. 点击集合选项卡中的导出按钮，将 fbx 文件导出到导出文件夹中的 atlas_files 文件夹
|
||||
|
||||
Reference in New Issue
Block a user