BSPZIP打包工具

VBSP ▶ VVIS ▶ VRAD ▶ BSPZIP

BSPZIP是一款命令行(en)工具，可将任意文件打包进BSP(en)地图文件。加载地图时，这些文件会被挂载，效果等同于存放在游戏实际内容目录中。

提示:推荐使用[[Zh/

1. GUIs/Replacements|图形界面工具]](en)替代直接操作BSPZIP

提示:通过支持 LZMA压缩的ZIP(en)解压工具可直接查看BSP内嵌文件
注意：部分操作会在"pakfile"数据块后追加内容，此时需通过哈希值访问

{{bug|tested=|根目录下的materials/自定义VMT(en)文件可能打包失败，请使用子目录存放
示例：materials/my_materials/}

虽然推荐使用BSPZIP打包资源，但在处理Maplist Thumbnails(en)等特殊情况时，建议改用资源清单(en)方案。

使用指南

工具路径：common\<gamename>\bin\bspzip.exe

批量添加文件

基础命令格式：

-addlist <输入bsp> <文件列表> <输出bsp>
-addorupdatelist <输入bsp> <文件列表> <输出bsp>（仅OrangeBox版支持增量更新）

提示:输入输出文件可设为相同路径

文件列表（.txt）格式规范：

内嵌路径/file1
本地绝对路径\file1
内嵌路径/file2
本地绝对路径\file2

示例：

materials/foo/bar.vtf
D:\Steam\...\materials\foo\bar.vtf
sound/lorem/ipsum.mp3
D:\Steam\...\sound\lorem\ipsum.mp3

单文件操作

-addfile <输入bsp> <内嵌路径> <本地路径> <输出bsp>

文件提取

-extract <bsp文件> <输出.zip>
-extractfiles <bsp文件>
-dir <bsp文件>

Cubemap反射(en)贴图处理

-extractcubemaps <bsp文件> <输出目录>
-deletecubemaps <bsp文件>

警告:慎用-deletecubemaps，该指令会删除bsp内所有.vtf文件

{{bug|tested=|此命令可能损坏PAKFILE数据块，建议改用 VIDE或 VPKEdit}

压缩功能

(存在于自 以来) 压缩命令：

-repack -compress <bsp文件>

解压命令：

-repack <bsp文件>

警告:

• 压缩地图会导致 起源电影制作器崩溃
• 已压缩地图生成立方体贴图时将引发游戏崩溃

错误:压缩后ADPCM音频可能缓存异常，建议仅对循环音乐使用此格式  (tested in： )

错误:压缩BSP中的ANI(en)文件无法正常加载

图形界面工具

• Compile Pal
• Packbsp(en)
• Map Analyst
• Pakrat
• VIDE
• VPKEdit