在 Godot 4 里更换 3D 模型材质：覆盖槽、GDScript 替换与共享资源的坑
从编辑器里的 Surface Material Override 到运行时的 GDScript 替换，再到会让同款模型集体变色的共享资源问题，顺带把 PBR 取值与贴图导入设置讲清楚。
在 Cry of Fear 里换 Simon 的模型，本质上只需要先回答一个问题：你是想换成游戏本身已经带了的另一套衣服，还是想换成一个完全不同的角色。前者是在秘密房间里点几下衣柜，后者则是替换 Cry of Fear 目录下 Half-Life 格式的模型文件，并且接受以后每次游戏更新都可能把成果冲掉。
Cry of Fear 跑在 GoldSrc 引擎上，也就是 Half-Life 1 的那套代码，因此角色都是 .mdl 文件：骨架很小，蒙皮是每个顶点只绑一根骨骼的刚性蒙皮，贴图是索引色位图。正是这个老格式让两条路都可行，也正是它让两条路都很脆——在查看器里看着正常的模型，进了游戏照样可能出问题，只要序列、判定盒或贴图格式和引擎的预期对不上。
这篇教程按读者提问的顺序展开：该走哪条路，Cry of Fear 的角色文件里有什么，怎么做出一个能编译通过的替换模型，十二套服装各自怎么解锁，Sick Simon 与 Former Simon 这类包怎么装怎么卸，以及 Simon 变成 T 字姿势时该查哪里。
A 路线：秘密房间的衣柜是唯一能反悔的换法
如果你只是想让 Simon 换身衣服，用游戏里的衣柜就够了，不必动任何文件。社区攻略给出的位置是：通关一次之后，在游戏最开头那条走廊里，黑色剪影走开之前左手边的第一扇门；另一个秘密房间在第六章火车事故之后，从撞毁的轿车旁那块铁板下去的地堡里。两个房间里的布置一样：衣柜、隐藏武器，以及说明解锁规则的书页。
在衣柜里换装的五个步骤
- 先把本篇通关一次。全新存档下秘密房间是锁着的，也就是说成绩单没滚完，衣柜对你来说还不存在。
- 从菜单里选章节载入，第一章是回到开场走廊最快的路径。
- 赶在黑色剪影走开之前走到左手边第一扇门，推门进去。错过了就重玩这一章，这里没有任何会永久错过的东西。
- 使用衣柜，在已解锁的连帽衫之间切换并确认。改动在过场动画和实际游玩里都会生效。
- 想换回来随时再进衣柜。改动写在存档里，不在游戏目录里，不需要重装任何东西。
代价是范围有限：衣柜只能在你的安装里已经存在的服装资源之间切换。游戏从来没做过的角色，只能从别处来，这也正是替换文件这条路的起点。
Cry of Fear 的角色文件里到底有什么
Cry of Fear 的内容放在可执行文件旁边的 cryoffear 目录里。随游戏发售的服装按套存放，每一套是 cryoffear/models/costumes/ 下的一个文件夹，文件夹名就是服装名，里面是该套装的 .mdl 和配套贴图。玩家模型的命名沿用 Half-Life 的习惯，而引擎只加载编译好的 GoldSrc MDL。往那个目录里丢一个 OBJ 或者 GLB，不会起任何作用。
- 身体部件与 bodygroup：网格被拆成若干块，引擎可以隐藏或替换其中的块，同一副骨架因此能套上不同的外套。
- 贴图：带 256 色调色板的索引 BMP，由模型按文件名引用，而不是像 glTF 那样把图像打包进模型文件。
- 骨架：层级很浅的骨骼结构。GoldSrc 时代的角色只有几十根骨骼，远不是现代绑定那种几百根的规模。
- 序列（sequence）：命名为 idle、walk、run、crouch、jump、die 的动画片段，引擎按声明的 activity 选取，而不是靠文件名去猜。
- 判定盒与挂点：绑定在骨骼上的碰撞盒用于命中判定，挂点负责把手里的武器和特效放到正确位置。
- QC 脚本：一份纯文本构建配方，列出这个模型用到哪些 SMD 网格、贴图和序列。替换之前先把原模型的 QC 留好，那是你必须对齐的规格书。
B 路线：替换模型文件，以及让它跑起来的编译链路
替换玩家模型意味着覆盖或顶掉 MDL 文件，所以第一步是备份。把打算改动的文件夹复制到游戏目录之外，记下当前游戏版本；还要记住 Steam 的验证文件完整性会把原始文件装回来，顺手抹掉你的成果。每次只装一处改动，装完就测，否则出问题时你无法判断是哪个文件造成的。
从 Blender 到编译好的 MDL
- 在 Blender 或 Milkshape 3D 里按 GoldSrc 的比例建模，把原点放在两脚之间：一个引擎单位大约等于一英寸，站立的玩家高度约 72 个单位。
- 蒙皮时复制原模型的骨架。GoldSrc 的每个顶点只绑到一根骨骼上，所以肘、膝要留够环线，否则关节一弯就撕裂。
- 面数控制在合理区间。Half-Life 时代的角色通常是几百到约 1500 个三角面，贴图用 256x256 或 512x512 的索引图；在这么老的引擎里堆面数，几乎换不来观感。
- 导出 SMD：一张参考姿势网格，加上每个动画各一份；再写一份 QC，声明模型名、身体部件、贴图和序列的 activity。
- 用 Half-Life SDK 里的 studiomdl 编译。骨骼缺失、贴图没用上、网格超限这些问题，编译器会在引擎看到文件之前先报出来。
- 用 GoldSrc 的模型查看器（例如 Jed's Half-Life Model Viewer）检查成品，然后把编译好的文件放进目标目录，读一个存档看它的实际动作。
| 服装 | 解锁方式 | 需要知道的细节 |
|---|---|---|
| Half-Life Creations 连帽衫 | 第一章公寓房间内拾取 | 首轮游戏就能拿到 |
| Sick Simon 连帽衫 | 以结局 4 通关 | 多数模型包借用的就是这个名字 |
| Hello Kitty 连帽衫 | 在第四章通风管里对死猫按五次使用键 | 最容易走过去没看见 |
| David Leatherhoff 连帽衫 | 以结局 5 通关 | 与 Afraid of Monsters 的联动内容 |
| Twitcher 连帽衫 | 在 Heaven 关卡用斧头击杀一只 twitcher | 要先拿到那把斧头 |
| Mod DB 连帽衫 | 第三章公寓厨房台面上，那间要爬窗上楼顶 | 在通往屋顶的路线上 |
| Afraid of Monsters 连帽衫 | 第四章 Harbor College 校内 | 固定位置拾取 |
| Camo 连帽衫 | 以结局 2 通关 | 条件：不杀 Carcass，把枪交给医生 |
| Black Metal 连帽衫 | 以结局 1 通关 | 条件：不杀 Carcass，自己留着枪 |
| Awesome 连帽衫 | 五个结局各看至少一次 | 实际等于把最后一段打满五遍 |
| Team Psykskallar 连帽衫 | 以结局 3 通关 | 条件：杀掉 Carcass，自己留着枪 |
| Custom 连帽衫 | 解锁其余全部服装后再通关一次 | 衣柜里最后出现的一格 |
Sick Simon、Former Simon 这类包到底改了什么
Cry of Fear 的角色模组大多是资源包，而不是改代码的补丁：里面装的是替换用的 MDL 和贴图，占用游戏已有的服装位置。把 2009 年测试版里没用上的 Simon 模型恢复出来的那类包就是典型例子——几何本身是老素材，只是重新打包，让引擎把它当成 Simon 的某个模型来加载。这也意味着这类包很容易过时：一次更新改了文件夹名或者新增一套服装，模型就可能不显示，退回默认的 Simon。
- 从模组自己的页面下载，并确认它针对的是 Steam 独立版，而不是更早的 Half-Life 1 模组版本。
- 把文件复制进 cryoffear/... 下，保持包内要求的文件夹名；原始文件备份之后才覆盖。
- 先在单机里测试。加载即崩溃的模型，多半是贴图引用丢了，或者引擎找不到某个序列。
- 这种替换只对自己生效。联机合作时其他玩家仍然用他们自己安装里的文件，除非他们也装了同一套包。
- 想还原就删掉替换进去的文件，再跑一次 Steam 完整性验证，原始资源会回来，存档不受影响。
出问题时：把症状对应到出错的那个环节
GoldSrc 换模型的失败方式就那么几种，每一种都指向流程里的某个具体环节。按下面的顺序逐条排查，通常不必从头重做。
- 摆成 T 字或停在参考姿势：引擎找不到它要的序列。把自己的 QC 与原型模型的序列和 activity 逐条对比。
- 贴图发紫、发平或者变成格子：QC 里的贴图路径与磁盘上的文件对不上，或者 BMP 不是 256 色索引格式。
- 模型不可见，或者变成巨大的错误占位物：目录名或模型名写错，也可能这个文件根本没编译过。
- 四肢拉到地图各处，或者载入地图就崩溃：顶点绑到了错误的骨骼上，也可能是骨骼数量超出了编译器的上限。
- 联机里子弹打不中：判定盒被改过。命中判定用的是服务器加载的那份模型，所以判定盒定义要保持一致。
AI 生成的网格在这一流程里能做什么、不能做什么
先用生成工具做出基础网格、再手工收尾，是 Cry of Fear 服装流程里完全成立的一半。Open3DAI 覆盖的正是这一半：文生 3D 与图生 3D、多视图输入、AI 贴图、把你接上的引擎放在一起并排比较，以及导出 GLB、glTF、OBJ、STL、PLY、3MF，另外还有 48 个格式转换器、12 个浏览器工具和一套 REST API。它不做的是 GoldSrc 真正要求的另一半：不绑定骨骼、不做权重、不重拓扑、不展开 UV、不做动画，也不编译 Half-Life 的 MDL，更不会承诺导出即封闭、无需清理就能直接用。要把一个网格变成 Cry of Fear 里的角色，仍然得靠 Blender、Milkshape 3D 和 studiomdl。
引擎可用性、积分价格和第三方条款都会变，游戏更新和模组页面也一样。无论是花预算还是花一个周末去换角色模型，动手之前都请到厂商页面和模组自己的下载页确认一遍，并且无论如何都留一份原始文件的副本。
常见问题
不动任何游戏文件，能换 Simon 的模型吗？
可以，前提是你要的那套服装游戏本身就有。通关一次打开秘密房间，用里面的衣柜在已解锁的连帽衫之间切换即可。游戏目录里的文件不会有任何改动，想换回来就是再进一次衣柜。
Cry of Fear 把 Simon 的模型文件放在哪里？
内容都在可执行文件旁边的 cryoffear 目录里，随游戏发售的服装则按套放在 cryoffear/models/costumes/ 下的各个文件夹中，每个文件夹里是一份编译好的 .mdl 和对应的索引 BMP 贴图。不同版本之间目录名和模型名可能不同，动手前先把要替换的那个文件夹里的确切名字记下来。
替换后的模型在游戏里摆成 T 字姿势，是什么原因？
引擎要播放的序列在模型里没有声明，于是退回参考姿势。把自己的 QC 序列与 activity 列表和原模型逐条对照，同时确认 MDL 内部记录的模型名与游戏要查找的文件名一致。
编译替换模型一定要用 Half-Life SDK 吗？
GoldSrc 这边，把 QC 脚本和 SMD 网格编译成 MDL 的工具是 studiomdl，它随 Half-Life SDK 提供。建模和导出 SMD 可以用 Blender 或 Milkshape 3D，放回游戏目录之前再用 GoldSrc 的模型查看器检查一遍。
AI 生成的模型能直接拿来当 Simon 用吗？
不能直接用。生成的网格和贴图只是起点，GoldSrc 要求这个网格以刚性蒙皮绑到原骨架上，并连同匹配的序列和判定盒一起编译成 MDL。Open3DAI 负责生成网格、贴图，并导出 GLB、glTF、OBJ、STL、PLY、3MF；它不做绑定、不做重拓扑，也不编译 Half-Life 模型，所以 Blender 和 studiomdl 仍在流程里。
一共有多少套服装，哪一套最难拿？
算上 Custom 连帽衫一共十二套。多数绑定某个结局或章节里的固定拾取点，Awesome 连帽衫要求五个结局各看至少一次，Custom 连帽衫则要在解锁其余全部服装之后再通关一次。这个难度排序是基于社区解锁列表的编辑判断，不是实测统计。
替换模型会弄坏联机合作或者存档吗？
存档不受影响，因为改动在游戏目录里，而不在存档数据里。联机合作要另说：其他玩家仍然用自己安装里的文件，除非他们也装了同一套包；命中判定用的是服务器加载的模型，所以判定盒定义要和原模型保持一致。
想把模型模组还原，最快的做法是什么？
删掉自己复制进去的文件，然后对 Cry of Fear 跑一次 Steam 的验证文件完整性，随游戏发售的资源会回来，存档也不受影响。不过还是建议保留自己那份原始文件备份：验证是重新下载，而不是从你可控的快照恢复。
在 Open3DAI 中试一下
把同一份提示词或图片交给多个引擎，并排对比网格，然后导出 GLB、glTF、OBJ、STL、PLY 或 3MF。注册即赠免费积分，无需信用卡。