Windows 11下Hammer编辑器中TF2地图无法编译的问题求助

阿华AIGC实验室

2026-6-11

问题

使用Windows 11系统，通过Team Fortress 2目录中的Hammer编辑器制作地图，自定义纹理已转换为正确格式且在编辑器中显示正常，但地图无法完成编译——编译过程未生成.bsp文件，VBSP程序未正常运行。查阅Valve开发者网站未找到有效解决办法，编译控制台输出如下：

** 正在执行...
** 命令: "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\bin\vbsp.exe"
** 参数: -game "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf" "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\map_name.vmf"

Valve Software - vbsp.exe (2025年10月8日版本)
12线程
使用着色器API: shaderapiempty.dll
材质路径: C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\materials
正在加载 C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\map_name.vmf
尝试创建非四边形置换面! (实体0，笔刷11)


** 正在执行...
** 命令: "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\bin\vvis.exe"
** 参数: -game "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf" "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\map_name"

Valve Software - vvis.exe (2025年10月8日版本)
12线程
读取 c:\program files (x86)\steam\steamapps\common\team fortress 2\tf\maps\Saxxy_Cliffs.bsp
打开 c:\program files (x86)\steam\steamapps\common\team fortress 2\tf\maps\map_name.bsp 失败

** 正在执行...
** 命令: "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\bin\vrad.exe"
** 参数:  -game "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf" "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\map_name"

Valve Software - vrad.exe SSE (2025年10月8日版本)

      Valve辐射度模拟器     
12线程
[从'lights.rad'读取纹理光源]
未知的光源说明符类型 - lights

[从'lights.rad'解析出56个纹理光源]

加载 c:\program files (x86)\steam\steamapps\common\team fortress 2\tf\maps\Saxxy_Cliffs.bsp
打开 c:\program files (x86)\steam\steamapps\common\team fortress 2\tf\maps\map_name.bsp 失败

** 正在执行...
** 命令: 复制文件
** 参数: "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\Saxxy_Cliffs.bsp" "C:\Program Files (x86)\Steam\steamapps\common\Team Fortress 2\tf\maps\map_name.bsp"

解决方案

修复非四边形置换面：控制台明确提示尝试创建非四边形置换面! (实体0，笔刷11)，这是VBSP终止编译的核心原因。打开Hammer编辑器，定位到实体0下的第11个笔刷：
- 置换面必须为四边形（4个顶点），若当前笔刷是三角形或其他多边形，删除置换效果，重新为四边形笔刷添加置换；
- 若笔刷本身形状不符合要求，拆分笔刷为多个四边形后再设置置换，或调整笔刷形状为四边形。
修正编译路径配置：
- 当前编译脚本存在错误的复制命令，试图复制Saxxy_Cliffs.bsp到你的地图文件，需在Hammer的编译设置中删除该无效复制步骤，确保编译流程仅针对map_name.vmf生成对应.bsp；
- 删除TF2地图目录下的临时编译文件（如.lin、.prt、.log等），避免残留文件干扰正常编译。
修复lights.rad文件错误：控制台提示未知的光源说明符类型 - lights，打开TF2根目录下的lights.rad文件，查找包含lights的错误行，删除或修正该行的光源定义格式，确保其符合Valve纹理光源的规范要求。