Skip to content
Quake/Hexen 2 Map compiling tools - branch of
Branch: master
Clone or download
Latest commit 5010dc9 May 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
3rdparty/googletest common: drop glm dependency Apr 24, 2017
bspinfo change branding to ericw-tools Oct 19, 2017
bsputil bsputil: start a --compare feature for helping with qbsp testing Jan 10, 2019
cmake build: restore mingw support Aug 5, 2016
common qbsp: -objexport debugging: Add another point where an .obj is dumped Jan 27, 2019
include light: increase max sky distance to 1M Apr 20, 2019
light light: bounce: also make shadow-casting bmodels bounce (unless they May 12, 2019
lightpreview lightpreview: tweak ui file Apr 29, 2017
man light: Add "_bounce" "-1" to disable bouncing for a func_detail/etc. Jan 22, 2019
qbsp qbsp, light: support _minlight_exclude on func_group, detail, etc. Apr 6, 2019
qbsp3 qbsp3: wip; converting to use ericw-tools/common Oct 5, 2017
testmaps Add showing unwanted splitting vs tyrutils-0.15 Feb 10, 2019
vis vis: fix for microleafs blocking vis Mar 25, 2019
.gitignore Don't ignore embree... Apr 12, 2018
.travis.yml change branding to ericw-tools Oct 19, 2017
CMakeLists.txt change branding to ericw-tools Oct 19, 2017
COPYING Import initial sources Aug 28, 2006 document a dependency on libtbb (#235) Mar 25, 2019
appveyor.yml change branding to ericw-tools Oct 19, 2017 test: fix Jan 16, 2018
gpl_v3.txt docs: add license note Jun 18, 2016


Original tyurtils:

Build Status Build status


ericw-tools is a branch of Tyrann's quake 1 tools, focused on adding lighting features, mostly borrowed from q3map2. There are a few bugfixes for qbsp as well. Original readme follows:

A collection of command line utilities for building Quake levels and working with various Quake file formats. I need to work on the documentation a bit more, but below are some brief descriptions of the tools.

Included utilities:

  • qbsp - Used for turning a .map file into a playable .bsp file.

  • light - Used for lighting a level after the bsp stage. This util was previously known as TyrLite

  • vis - Creates the potentially visible set (PVS) for a bsp.

  • bspinfo - Print stats about the data contained in a bsp file.

  • bsputil - Simple tool for manipulation of bsp file data

See the doc/ directory for more detailed descriptions of the various tools capabilities. See changelog.txt for a brief overview of recent changes or for the full changelog and source code.


Requires CMake 2.8, groff, and a compiler with C99 and C++11 support.
Embree v2.10.0+ is optional but recommended. If you do use Embree, the Thread Building Blocks (tbb) library is also required.

Tested on:

  • Ubuntu 14.04 / Clang 3.5.0
  • Ubuntu 14.04 / gcc 4.8.4
  • OS X 10.11 / Xcode 7.3
  • Windows 10 / Visual Studio 2013 Community

Ubuntu 14.04 x86_64

sudo apt-get install git cmake build-essential groff

git clone
cd ericw-tools

mkdir build
cd build

wget -O embree.tgz
tar xf embree.tgz
sudo apt-get install libtbb2

cmake .. -DCMAKE_BUILD_TYPE=Release -Dembree_DIR="$(pwd)/embree-2.17.5.x86_64.linux"
make -j8 VERBOSE=1

Executables will be located in:

  • ericw-tools/build/qbsp/qbsp
  • ericw-tools/build/vis/vis
  • ericw-tools/build/light/light
  • ericw-tools/build/bspinfo/bspinfo
  • ericw-tools/build/bsputil/bsputil


  • Kevin Shanahan (AKA Tyrann) for the original tyrutils
  • id Software (original release of these tools is at
  • rebb (ambient occlusion, qbsp improvements)
  • q3map2 authors (AO, sunlight2, penumbra, deviance are from q3map2)
  • Spike (hexen 2 support, phong shading, various features)
  • MH (surface lights based on MHColour)
  • mfx, sock, Lunaran (testing)
  • Thanks to users at func_msgboard for feedback and testing


This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Builds using Embree are licensed under GPLv3+ for compatibility with the Apache license.

You can’t perform that action at this time.