Files
KKBP_Importer/wiki/material_breakdown_zh.md
小煜 5d9e09e9c3 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
2025-12-06 15:26:19 +08:00

145 lines
8.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# KKBP 材质分解
本页将完整分解 KKBP 8.0 的"KK General"材质着色器的材质节点逻辑。KK General 材质中的简单节点逻辑在整个项目中使用,因此阅读和理解本页应该能让你学会如何修复或调试你遇到的任何 KKBP 材质。
## 开始之前...
在 KKBP 8.0 的开发过程中,随机选择了大量卡片进行测试。
在 133 张卡片中...
* 104 张78%)开箱即用
* 22 张17%)有奇怪的材质问题,需要 5 分钟修复
* 5 张4%)导出但未导入
* 1 张0.5%)有奇怪的材质问题,可能需要一段时间才能弄清楚
* 1 张0.5%)未导出并导致游戏崩溃
这意味着如果你遇到问题,**有 94.5% 的机会**阅读下面的"基本选项"部分将帮助你修复模型的外观。这也意味着**有 0.5% 的机会**你必须挖掘整个内容才能找出材质为什么看起来不对。
在你浪费时间之前,**请确保你在导入过程中没有收到错误**,如首页所述!
**如果你的模型导入时出现错误,本页将无法帮助你!**
# 基础着色器分解
## 简介
此分解将首先使用默认 Koikatsu 模型 Chika 上的服装。让我们首先在 Blender 中打开着色选项卡。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/89c3ec7cfffb6a560eceb901ed75b1f531c56b22.png)
这是每个材质中使用的材质设置。导出文件夹中的纹理文件加载到左侧的绿色组中。颜色在中间的蓝色组中生成,然后馈送到红色组中的输出节点。
每个材质都有浅色和深色。现在显示的是浅色。你可以使用右上角的视口着色按钮在浅色和深色之间切换。这是深色的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/6b413f2411f3809004ea6efb72f87a0666083c8e.png)
本文档的其余部分将仅使用浅色。你可以通过点击材质面板中的箭头来展开模型浅色的选项
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/77cb1be3f9741658df1313fbfcd60f11485f0cfb.png)
## 细节颜色
让我们逐个了解每个选项。第一个选项是覆盖细节颜色。KKBP 会自动为你生成细节颜色,但如果你想覆盖它给你的颜色,可以启用此滑块并将细节颜色设置为你想要的任何颜色。这是设置为黄色时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/963adabb6ca07aded0b943c7bec1b6646b62d22e.png)
这是设置为红色时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/8d2ac0c1d5c8e5995bcf5f5a217f440408a8999c.png)
## 细节强度
下一个选项是绿色细节强度。绿色细节强度通常控制衣服上的柔和细节。这是夹克在默认 0.8 强度下的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/8765798548a8a561d9ae0fe1a4ae56b383b29700.png)
这是夹克设置为 5 绿色强度时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/cd98a37c2f3f15aecb77fb921c7743a4c7f62803.png)
这是细节设置为 10 绿色强度时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/812f55ebe55a5c7c1c3431433133515bf6916a64.png)
蓝色细节强度通常控制衣服上的硬线细节。这是夹克设置为默认 0.1 时的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/71ff40ea839d748f15843b6f4c9137941eb04882.png)
这是设置为 1 时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/55383a783060447fb43f8515417046d6c029e321.png)
这是设置为 5 时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/69fd3ff65df304471db69473333d0bf0585c021e.png)
## 光泽
一些衣服还具有可调节的光泽度。默认的乐福鞋具有可调节的光泽。可以更改光泽的颜色。这是乐福鞋带有白色光泽的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/92e10b991094734f51b0849bcc6925ef920c9950.png)
这是它们带有绿色光泽的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/63adc021bbd605cea522b3b1f3c38ff59388d7bb.png)
光泽的强度也可以调整。这是乐福鞋在默认光泽强度为 1 时的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/ab5828b1216b29812e265610482908b70e5cae8a.png)
这是乐福鞋光泽强度设置为零时的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/4b0c6fd05f004e196b9c3a72115cdddc5d2cb232.png)
## 主纹理 HSV
大多数衣服都有所谓的主纹理或简称 maintex。可以使用 maintex 滑块轻松调整主纹理的色调、饱和度和值。这是鞋子调整其 HSV 值后的样子
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/80774dd31c98982b2a55e5dd99ea3804f1b225a5.png)
## 颜色蒙版颜色
如果一件衣服有主纹理,它也会有所谓的纯主纹理。主纹理和纯主纹理之间的区别将在稍后解释。现在,你只需要知道每件衣服上的每种颜色都可以更改,就像在游戏中一样。为此,必须启用纯主纹理。启用纯主纹理的滑块在下图中设置为 1。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/d433ff287e3589cfe8ae9debbd238d1abf031346.png)
启用滑块后,你可以使用颜色蒙版颜色输入更改衣服的颜色。下面更改了鞋子的颜色蒙版颜色。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/66d706cc284f2a1ef008ee23fa815ba2724a666f.png)
你可以随时通过将颜色蒙版颜色重置为其原始值来返回原始颜色。或者通过再次禁用纯主纹理滑块(因此,将再次使用常规主纹理)。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/43263be8f9743e3f9ccf596453bf1f2c3484aee8.png)
## 图案颜色
一些衣服(如默认裙子)具有可调整的图案颜色。为了调整图案颜色,你需要使用纯主纹理。下图显示了为裙子启用的纯主纹理滑块。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/d48cc90aff12458545e4bed0166e10a5f922f1b6.png)
默认裙子只有一种可以调整的图案颜色。这是图案颜色设置为蓝色时的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/d0636d3c6294398178d70e56a9da832a95fa6d38.png)
如果这件衣服有更多图案,它们的颜色将使用图案颜色绿色和图案颜色蓝色颜色输入进行调整
## 可见性滑块
一些衣服有所谓的 alpha 蒙版。alpha 蒙版隐藏衣服的某些部分以防止它穿过其他衣服。默认内衬衬衫是具有 alpha 蒙版的衣服的示例
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/5fcdffbb5e0d54c5780dd136b163f7e1b1c9a06c.png)
此衣服的部分被隐藏以防止它穿过夹克。如果你想让衣服可见,即使它不应该可见,你可以启用强制可见性滑块。这是启用滑块后衬衫的样子。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/ebb94af4e7cfc44e95c4e0342cf91111c20512e4.png)
这是衬衫完全可见时衬衫和夹克的样子。请注意,某些部分在不应该穿过夹克时穿过了夹克。这就是为什么默认启用 alpha 蒙版的原因。
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/e08533fb229046285c72147d685b1ff55fe90f61.png)
![](https://raw.githubusercontent.com/kkbpwiki/kkbpwiki.github.io/master/assets/shader_media/cffd898b850e771d1193dbbaae23d0f2e79cb5c9.png)
# 深入着色器分解
这就是所有基本服装选项的结论。
如果你是 0.5% 的一部分,并且这些都没有帮助修复你遇到问题的材质,你可以查看[深入着色器分解页面](material_breakdown_advanced)以获取有关 KKBP"KK General"着色器的更多信息。