Q3-BSP

What is this?

This is a module for Python used to load Quake 3 Arena BSP files into readable data.
This module does not yet support: visdata, lightvols, nodes, leafs, leaf faces, brushes

TL;DR - Too Long; Didn't Read

Download LoadBSP.py and surfaceflags.py
All colors are in RGBA and use the get() method to retrive data from the BSP file.
You can choose to use either gameobjects (GAME_OBJ), numpy (NUMPY) or python lists (LIST) for vector using the "vector" keyword parameter. The same goes for graphics module ("gfx" parameter). For graphics, you can choose from: PyGame (PYGAME), PIL (PIL) or 3D python lists (NO_GFX). Default settings is: vector = LIST, gfx = PYGAME.

Example of use:

import LoadBSP
bsp = LoadBSP.BSP('maps/q3tourney6.bsp', vector = LoadBSP.GAME_OBJ, gfx = LoadBSP.PYGAME)

for texture in bsp.get("textures"):
    print texture[0]

These are the possible commands for get:

"entities", "textures", "planes", "nodes", "leafs", "leaffaces", "leafbrushes", "models", "brushes"
"brushsides", "vertices", "meshverts", "effects", "faces", "lightmaps", "lightvols", "visdata"

(These names refer to the names of the lumps given here: "Unofficial Quake 3 Map Specs")

Detailed explanation

Requirements

This module has been tested on Python 2.6.5. It will probably work on 2.7.x too, but it hasn't been tested.
You will need "LoadBSP.py" for a minimal setup. If you want to read/translate texture flags, you'll have to download "surfaceflags.py" too. surfaceflags.py is a translation of surfaceflags.h provided by ID software's GitHub. I assume that you have read the article, "Unofficial Quake 3 Map Specs", before using this module.

How to use

Please read the TL;DR first. This gives a brief description of all the parameters.
This is a module for Python used to load BSP maps into readable data. The interface of the module is really simple; when creating an instance of the LoadBSP class, you tell what BSP file to load using the "fname" argument and the map will then begin loading. When the map is loaded, you can use the get() method to retrive the data of each "lump". Here is an example, on how to print all the texture paths:

import LoadBSP
bsp = LoadBSP.BSP('maps/q3tourney6.bsp')

for texture in bsp.get("textures"):
    print texture[0]

With no keyword parameters, it uses python lists for vectors and PyGame for graphics.

Using PIL instead of PyGame:

import LoadBSP
bsp = LoadBSP.BSP('maps/q3tourney6.bsp', gfx = LoadBSP.PIL)

Thanks to

Thanks to "ThomasEgi" from panda3d.org. This module is based on the code, he provided in this thread: panda3d.org...t=7920
Thanks to "Kekoa Proudfoot" for the "Unofficial Quake 3 Map Specs"

Links

####Sources "Unofficial Quake 3 Map Specs"
panda3d.org
graphics.cs.brown.edu misofruit.co.kr devmaster.net

####Non-standard modules gameobjects
pygame 1.9.1