Packbsp: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 1: Line 1:
'''PackBsp''' is a developer tool that can automatically detect custom contents needed for a map, resolve and include dependencies within them, and pack all the relevant content into the BSP file. It is currently under active development by the author.  
'''PackBsp''' is an open-source developer tool that automatically analyzes a map and discovers its network of dependencies, such as artistic assets, and packs them into the BSP file. It is currently under active development by the author.


"Dependencies" include VTF texture files which may be required by a VMT material file, or WAV files referenced from within a custom soundscape, or custom particle files (PCF) used within a particle manifest.
For example, your map may have a custom model in it. PackBSP will analyze the model to find all the files and materials it uses, and then analyze those to find gibs or textures, etc. until everything has been explored. It will compare these files against what exists in GCF/NCF files so that only the custom content you really need is included in the map, and can show you when needed content is missing.
 
It relies on the Source SDK to access the [[bspzip]] SDK tools for a subset of it's functionality, as well as utilizing [[HLLib]] to open BSP/GCF files. It will automatically determine the GCFs shipped with a game and will avoid packing duplicate contents.


[[File:Packbsp_screen01.png]]
[[File:Packbsp_screen01.png]]
Line 17: Line 15:


== Eventual plans ==
== Eventual plans ==
* Support for VPK-based mods (Left 4 Dead series, Alien Swarm)
* Support for Left 4 Dead series, Alien Swarm
* Support for Macs
* Support for Macs


== External links ==
== External links ==
* [http://technofovea.com/blog/projects/packbsp PackBsp site]
* [http://technofovea.com/blog/projects/packbsp PackBsp author site]


== See also ==
== See also ==

Revision as of 01:01, 5 April 2011

PackBsp is an open-source developer tool that automatically analyzes a map and discovers its network of dependencies, such as artistic assets, and packs them into the BSP file. It is currently under active development by the author.

For example, your map may have a custom model in it. PackBSP will analyze the model to find all the files and materials it uses, and then analyze those to find gibs or textures, etc. until everything has been explored. It will compare these files against what exists in GCF/NCF files so that only the custom content you really need is included in the map, and can show you when needed content is missing.

Packbsp screen01.png

Features

  • Detects engines and games the same way the Source SDK launcher does.
  • Autodetects the relevant GCFs for a game and examines their contents.
  • Uses the same data Hammer does (FGDs) to intelligently detect uses of textures, models, etc. in your map.
  • Packs custom skybox textures and detail sprites.
  • Examines VMT files and understands a wide variety of dependencies, such as bumpmaps, env-maps, patch shaders, etc.
  • Handles map-specific particle manifests.
  • Handles custom soundscapes.

Eventual plans

  • Support for Left 4 Dead series, Alien Swarm
  • Support for Macs

External links

See also