Propper模型转换工具

Propper 是经过修改的VBSP(en)版本，可输出模型(en)文件而非BSP(en)文件。

Propper允许用户使用 Hammer而非专业建模软件轻松创建模型。它能保持贴图映射完整，并可自动生成物理碰撞网格(en)。

已弃用:如果您使用 Hammer++，现在可以通过工具 > Propper(或快捷键Ctrl+⇧ Shift+P)使用内置的Propper++(en)功能，它将完全替代此工具。该功能直接转换Hammer网格，避免了BSP转换过程导致的几何质量损失。

功能特性

• 可创建静态道具(en)、动态道具(en)或物理道具(en)
• 自动生成.qc文件(en)并编译为游戏可用模型
• 生成有效的物理碰撞网格
• 自动材质转换 - 将地图贴图转为合法的模型贴图
• 区分常规贴图与工具纹理(en)(如nodraw和clip)
• 支持Hammer的平滑组(en)或自动平滑
• 允许在Hammer内配置模型的表面属性、用途和网格参数
• 支持置换面(en)转换(最终模型将非实体)

证实:是否为实体待确认

• 支持多皮肤材质(en)
• 支持自定义碎片效果
• 支持$keyvalues(en)：缆绳、粒子效果和物理枪交互
• 支持单地图输出多个模型
• 支持细节层级(en)
• 支持部件组(en)

下载

• Propper 0.24版 下载地址
• Propper 0.31测试版 下载地址(原作者最后版本)
• 适用于 Source SDK Base 2013的版本 此处下载(第三方分支)
• 军团要塞2专用版 此处获取

警告:部分Propper版本已过时，仅兼容\"Source SDK\"基础版本，详情参见此说明。

免责声明

社区地图制作者已成功使用此工具。其基于VBSP开发，我们相信它不会损坏电脑。但使用风险自负，对于使用Propper可能造成的计算机或游戏损坏，本人不承担任何责任。

使用指南

安装步骤

1. 将propper.fgd(en)和propper.exe解压至目标游戏的bin目录 2. 在Hammer中打开工具 > 选项 3. 在游戏配置标签页添加propper.fgd文件 4. 点击应用后重启Hammer

注意:需在* c:\propsource\用户名\自定义模型文件夹* 路径创建相应目录

创建模型

1. 在Hammer中将笔刷转为propper_model实体 2. 配置关键属性：

模型名称	输出模型的相对路径(无需.mdl后缀)
材质路径	模型贴图存储位置(需预先创建)
物理网格	指定代表碰撞形状的笔刷实体(留空则生成非实体模型)
凹面碰撞	启用后将生成精确碰撞模型(否则使用简化包围盒)

编译命令

在Hammer运行参数中添加：

propper -game "游戏目录" 地图名.vmf

注意：参数框内不得有多余空格或换行

扩展配置

通过以下实体增强模型功能：

• propper_physics - 物理属性配置
• propper_skins - 多皮肤材质(0.31版取消32张贴图限制)
• propper_attachments - 添加挂接点
• propper_lod - 生成低模版本

已知问题

• 贴图可能错误映射到不匹配的表面
• 使用根目录材质时会导致重复转换
• 移动模型后原点坐标可能重置
• 与Garry's Mod的studiomdl不兼容
• 超过brushsides限制时无报错

游戏适配方案

求生之路系列/ 异形丛生/ 传送门2

1. 用GCFScape提取材质到橙盒引擎游戏目录 2. 通过Source SDK运行Propper 3. 将生成文件复制回目标游戏

反恐精英：全球攻势

推荐使用专用整合包：下载地址

常见问题

Q: 出现filesystem_steam.dll错误 A: 需使用基于Source SDK 2013编译的版本

Q: 碰撞网格位置错误 A: 确保func_brush与propper_model原点坐标一致

Q: 模型光照效果差 A: 编译时添加"-StaticPropLighting"参数，并在Propper中禁用法线贴图

使用技巧

• 对不可见面使用nodraw纹理可减少多边形
• 通过放大制作可保留1/16单位的精细结构
• 材质路径避免与地图贴图目录重合
• LOD模型需按从近到远顺序创建

相关链接

• Propper-2013 v1.0
• SteamPipe配置指南

参见

• GoldSrc版等效工具(en)
• Hammer++集成版(en)