udx/AIGame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add AIServer, character art pipeline, and Art package boot integration.

Browse Source 
Bring in MaleExplorer assets/shaders, model tooling and Hunyuan updates, plus boot/YooAsset Art package support.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
udx
2026-09-21 17:06:59 +08:00
co-authored by Cursor
parent b7a0bbcb89
commit 6550b8df4b
121 changed files with 313260 additions and 113 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Tools/model_tools/README.md
+36 -28
View File
@@ -1,48 +1,56 @@
# 高模减面与贴图烘焙
# 高模减面与贴图烘焙 + XPbr 打包
复刻自 `ClientTrunk/Tools/ModelTools`（`model_decimate` + `model_bake`）。
复刻自 ClientTrunk ModelTools，并接入 AIC#Project ModelTranslator 的 **XPbr** 收尾。
```text
高模（FBX / GLB / glTF）
-> model_decimate.py：合并 Mesh、清理、三角化、减面、重展 UV
-> <名称>_low.fbx
-> model_bake.py：Cycles selected-to-active 烘焙
-> 低模 FBX + color / normal / ao / metallic / roughness PNG
-> model_decimate：减面 + 重展 UV -> <名>_low.fbx
-> model_bake：Cycles 烘焙 -> 五通道 PNG + 低模 FBX
-> model_translator：打包为 XPbr 两张图 + .mat/.meta
_base.png RGB=Albedo A=AO/透明
_mix.png RG=球面法线 B=Metallic A=Roughness
```
## 环境
- 安装 Blender（推荐 5.0），并满足其一：
- `blender` 在 PATH
- 环境变量 `BLENDER_EXE` 或 `BLENDER_PATH`
- 运行时 `--blender "D:\tools\Blender\blender-5.0.0-windows-x64\blender.exe"`
- 本机默认路径已写在 `mt_run.py`：`D:\tools\Blender\blender-5.0.0-windows-x64\blender.exe`
- UV 观察图需要 Pillow：`pip install Pillow`
- UVPackmaster 4 可选（已装则自动用于 UV 排布）
- Blender 5.0：默认 `D:\tools\Blender\blender-5.0.0-windows-x64\blender.exe`
- 或 `BLENDER_EXE` / `BLENDER_PATH` / `--blender`
- Pillow（UV 观察图）：`pip install Pillow`
- UVPackmaster 4 可选
## 分步命令
## 一键（推荐）
```powershell
python Tools/model_tools/model_decimate.py D:\Assets\house.glb --tris 5000 -o D:\Assets\house_low
python Tools/model_tools/model_bake.py D:\Assets\house.glb D:\Assets\house_low\house_low.fbx -o D:\Assets\house_bake --size 2048
python Tools/model_tools/model_lowpoly_bake.py prop.glb -o Tools/output/prop_game --tris 5000 --size 2048
# 默认会继续生成 Tools/output/prop_game/prop_xpbr/（base+mix+.mat）
# 跳过 XPbr：加 --no-xpbr
```
## 一键流水线（推荐 Agent 使用）
## 分步
```powershell
python Tools/model_tools/model_lowpoly_bake.py D:\Assets\house.glb -o Tools/output/house --tris 5000 --size 2048
python Tools/model_tools/model_decimate.py prop.glb --tris 5000 -o Tools/output/prop_low
python Tools/model_tools/model_bake.py prop.glb Tools/output/prop_low/prop_low.fbx -o Tools/output/prop_bake --size 2048
python Tools/model_tools/model_translator.py Tools/output/prop_bake/prop/prop.fbx -o Tools/output/prop_xpbr
```
输出示例：
## 装入 Unity + 预设
```text
Tools/output/house/house/
house.fbx
house_color.png
house_normal.png
house_ao.png
house_metallic.png
house_roughness.png
```powershell
python Tools/install_character_bundles.py -a MaleExplorer -b Tools/output/prop_game/prop_xpbr -c ref.png
# Unity 菜单：AIGame/M3/Setup Character Prefab + Art Collector
# 会挂 Test/XPbr，生成 Characters/MaleExplorer/MaleExplorer.prefab
```
生成完成后请在 `Doc/ResDesc_Model.md` 登记资源。
## 与 AIC#Project/ModelTranslator 减面烘焙对比
| 能力 | 本仓库 `Tools/model_tools`（现） | AIC#Project ModelTranslator |
| --- | --- | --- |
| 高模格式 | FBX/GLB/glTF | 主路径偏 FBX（减面 CLI 文案） |
| 减面后端 | Decimate collapse | **默认 Quad Remesher**，失败回退 collapse |
| UV 质量门 | 翻转/重叠 + **最大单岛占比**（已对齐） | 翻转/重叠/最大单岛 + 更深 seam 扫描 |
| 烘焙射线 | **自适应分离距离**（已对齐） | 自适应分离距离 |
| 收尾 | **XPbr base/mix + .mat**（已接入） | 同左（源头） |
| QR 引擎 | 未捆绑（无 xremesh 依赖） | 需本机 Quad Remesher 引擎 |
**结论**：AIC#Project 在「有机角色拓扑」上更优（Quad Remesher + 更深 UV 门）；本仓库已并入其自适应射线、大岛门限与 XPbr 打包，并保留 GLB 输入。若本机已装 QR 引擎，可再把 `qr_bridge` / `--reducer quad` 完整迁入作为可选增强。