Quake level patcher for water visibility
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.




pyvispatch is a tool which patches levels for the original Quake to give them transparent water in GLQuake and many modern clients. This is accomplished by reading in new visibility data from small patch files and replacing the older information within the original levels. pyvispatch can patch both standalone BSP files as well as levels stored in Quake PAKs.

This tool is a full re-implementation of the original VisPatch utility, authored by Andy Bay and enhanced by O.Sezer, in Python. pyvispatch was created to:

  • Reduce some limitations of the original VisPatch such as relative directory handling
  • Address bugs in the output of PAK files
  • Make it easier to extend the tool or include it with other applications
  • Provide a basis for other Quake tools that I would like to write and enhance


vispatch.py [-h] [--version] [-D DIRECTORY] [-d VIS_FILE] [-n | -e] file

positional arguments:

  • file

    level filename pattern, .bsp or .pak type, wildcards and additional levels of relative subdirectories are allowed

optional arguments:

  • -h, --help

    show this help message and exit

  • --version

    show program's version number and exit


    the directory that the level files are in (default: current directory)

  • -d VIS_FILE, --data VIS_FILE

    the vis data file (default: vispatch.dat)

  • -n, --new

    instead of overwriting the original level files, if files are inside a .pak create a new .pak with the modified files, else if they are individual .bsp files copy a backup of each old file to name.bak before patching

  • -e, --extract

    retrieve all the vis data from the given file


  • v0.1.0

    Now possible to include a subdirectory along with the file argument that is relative to the current directory or whichever directory is specified by the -D argument.

Legal Junk

Copyright © 1996-1997 Id Software, Inc.
Copyright © 1997-2006 Andy Bay IMarvinTPA@bigfoot.com
Copyright © 2007-2011 O.Sezer sezero@users.sourceforge.net
Copyright © 2012 John Trainer n@nightmiles.org

pyvispatch comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions; see COPYING for details.