search

snake-biscuits / bsp_tool

Python library for analysing .bsp files
GNU General Public License v3.0
104 stars 8 forks source link
apex-legends bsp idtech infinity-ward python quake-engine source-engine titanfall titanfall-2

readme

bsp_tool

Python library for analysing .bsp files

bsp_tool provides a Command Line Interface for analysing .bsp files

Installation

To use the latest unstable version, clone with git:

$ git clone git@github.com:snake-biscuits/bsp_tool.git

You can also clone with pip:

$ pip install git+https://github.com/snake-biscuits/bsp_tool.git

Or, use the latest stable release (August 2024 | 0.5.0 | Python 3.8-11):

$ pip install bsp_tool

Fair Use

Please do not use bsp_tool to copy or steal another creator's work
The primary goal of bsp_tool is to extend community mapping tools

Always

DO NOT use this tool to steal another creator's work
DO use this tool to understand the .bsp format(s) and create more specific tools

Be aware that this gets even more complicated with commercial projects

Usage

To load a .bsp file in python:

>>> import bsp_tool
>>> bsp_tool.load_bsp("map_folder/filename.bsp")
<ValveBsp filename.bsp (VBSP version 20) at 0x00...>

Full documentation: snake-biscuits.github.io/bsp_tool/ [WIP]

Thanks