自动BSP打包工具

AutoBSPpackingTool

Developer(s)

Drinkly

Written in

Operating system

Type

第三方工具

Target engine(s)

起源

Distribution

免费软件

Download

GitHub

Version

18.0.1

AutoBSPpackingTool是为起源引擎(en)开发者和地图制作者打造的第三方工具。它能自动检测并打包地图(en)中几乎所有可能使用的自定义资源。

注意:本程序需要Microsoft .NET Framework 4.0或更高版本。

提示:建议自行打包脚本中引用的自定义内容，因为在多数情况下，不运行引擎就无法检测脚本中使用的资源。

重要:请将程序放在独立文件夹中运行，因为它会在.exe所在目录创建缓存文件夹和游戏配置存储文件夹。

AutoBSP打包工具设置界面

复选框	会打包的文件（如果存在）
.nav (导航网格)	/maps/<地图名>.nav
.ain (信息节点)	/maps/graphs/<地图名>.ain
.txt (地图描述)	/maps/<地图名>.txt
.txt (声景配置)	/scripts/soundscapes_<地图名>.txt
.txt (声音脚本)	/maps/<地图名>_level_sounds.txt
.cache (声音缓存)	/maps/soundcache/<地图名>.cache
.txt (炸弹点位重试配置)	/maps/<地图名>_retake.txt
.txt (摄像机位置)	/maps/<地图名>_cameras.txt
.txt (地图故事)	/maps/<地图名>_story.txt
.txt (地图解说)	/maps/<地图名>_commentary.txt
.txt (粒子清单)	/particles/particles_manifest.txt /maps/<地图名>_particles.txt /particles/<地图名>_manifest.txt
.txt (雷达信息)	/resource/overviews/<地图名>.txt
.dds (雷达图像)	/resource/overviews/<地图名>_radar.dds /resource/overviews/<地图名>_radar_spectate.dds (及垂直剖面图)
.svg (地图图标)	/materials/panorama/images/map_icons/map_icon_<地图名>.svg
.png (地图背景)	/materials/panorama/images/map_icons/screenshots/1080p/<地图名>.png
.kv (玩家模型)	/maps/<地图名>.kv
.kv3 (机器人行为)	/scripts/<脚本或.vmf中提及的任何文件>.kv3
.png (危险区域生成掩码)	/maps/<地图名>_spawnmask.png
.png (危险区域部署图)	/materials/panorama/images/survival/spawnselect/map_<地图名>.png
.vtf (危险区域平板地图)	/materials/models/weapons/v_models/tablet/tablet_radar_<地图名>.vtf

功能特点

• 自动检测材质、纹理、模型、声音(.wav(en), .mp3(en), .ogg, .flac)、天空盒(en)材质、细节道具(en)文件、色彩校正(en)配置、粒子(en)等
• 检测模型中使用的材质和纹理（包括皮肤(en)），同时识别$includemodel(en)参数和碎片模型(en)
• 识别patch(en)材质
• 检测.nav(en)(导航网格(en)), .ain(en)(info_node), .txt(地图描述(en)), .txt(声景(en)), .txt(声音脚本(en)), .cache(声音缓存(en)), .txt(炸弹点位重试(en)), .txt(摄像机位置(en)), .txt(地图故事), .txt(地图解说(en)), .txt(粒子清单(en)), .txt(雷达信息(en)), .dds(雷达图像(en)), .svg(地图图标), .png(地图背景), .kv(玩家模型(en)), .kv3(en)(机器人行为(en)), .png(危险区域生成掩码(en)), .png(危险区域部署图(en)), .vtf(危险区域平板地图(en))
• 检测声景(en)和声音脚本(en)文件中引用的声音
• 检测脚本(en)和配置(en)
• 检测脚本中引用的模型、声音、机器人行为文件及其他脚本和配置仅当它们带有文件扩展名时 (.mdl(en), .wav(en), .mp3(en), .ogg, .flac, .kv3(en), .nut(en), .cfg(en))

警告:

• 本程序无法检测路径中包含空格的脚本中引用的资源

• 同时查找func_instance实体中指定的.vmf(en)文件并打包其自定义资源
• 程序读取gameinfo.txt（以及 Garry's Mod的mount.cfg）获取内容搜索路径
• 程序还读取libraryfolders.vdf获取Steam库文件夹路径
• 可选择将所有找到的文件打包到.bsp(en)中，或保存包含所有检测到的自定义资源列表的文件
• 程序会创建.bsp(en)文件的备份副本(.bsp.backup)
• 程序启动时检查更新
• 打包完成时显示通知

支持的游戏

{{Tip|您可以创建自己的游戏配置或编辑现有配置}

原生支持：

• 反恐精英：全球攻势
• Garry's Mod
• 传送门2

选项

程序也可以通过命令行界面使用。以下是启动程序时可直接传递的参数列表：

--vmf <路径>

设置.vmf文件路径

--bsp <路径>

设置.bsp文件路径（如果未指定，将在cache文件夹中保存包含所有检测到的自定义资源列表的文件）

--game <索引

选择要使用的游戏。索引是从0开始的[[Zh/

1. Supported games|支持游戏列表]](en)中的数字（列表顺序未来可能改变，因此最好使用游戏文件夹名称或其路径）

此外，如果程序无法找到您的Steam路径，并且在此参数中使用游戏文件夹路径，则将从该路径获取Steam路径

示例：0, 1, csgo, garrysmod, C:/Program Files (x86)/Steam/steamapps/common/Counter-Strike Global Offensive/csgo/

--log (或 -l)

创建日志文件。如果启用此选项且任何参数无效，将在cache文件夹中创建cmd_exit_reason.log文件

--notify (或 -n)

打包完成时显示通知

--use-native-tools (或 -u)

使用原生（内置）工具而非vpk.exe(en)和bspzip.exe(en)

--addcfg <路径>

添加游戏配置（位于<.exe文件所在目录>/game_cfgs/的配置会自动添加）

--gameinfo <路径>

如果gameinfo.txt未存储在默认位置或程序无法找到，则设置其路径

--mountcfg <路径>

如果mount.cfg未存储在默认位置或程序无法找到，则设置其路径（仅 Garry's Mod）

--cachedir <路径>

覆盖默认cache文件夹路径(<.exe文件所在目录>/cache/)

--no-backup (或 -b)

不创建.bsp(en)文件的备份副本

与Hammer配合使用

您可以添加Hammer配置以便在编译后立即打包所有自定义资源。如需设置，请按照以下步骤操作：

1. 在专家编译模式中添加新的编译配置
   
2. 将其名称设置为[AutoBSPpackingTool] - 打包数据或任意您想要的名称
   
3. 将命令设置为程序.exe文件的完整路径
   

   示例：C:/Users/user/Downloads/AutoBSPpackingTool.exe

4. 将参数设置为：--vmf $path\$file.vmf --bsp $bspdir\$file.bsp --game $gamedir --notify，如需可添加其他参数
   
5. 完成！现在点击开始！并等待通知出现

{{Note|如果您将 Hammer++用于官方不支持的游戏（例如 传送门2），可能需要根据使用的游戏手动设置--game参数，因此 传送门2的完整参数将如下所示：
--vmf $path\$file.vmf --bsp $bspdir\$file.bsp --game "portal2" --notify}

外部链接

下载

• GitHub

社区

•  Reddit讨论帖

参见

• 第三方工具(en)
• VIDE(en)
• Pakrat(en)