Skip to content
id Tech 3 Map Compiler
C++ C Batchfile Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

id Tech 3 Map Compiler

This project is a modified version of Q3Map2, which is a map compiler for games based on id Tech 3 engine, forked from NetRadiant's q3map2 2.5.17n. All API changes, bug fixes and new features are listed in the changelog.


The wiki page has detailed information about all switches map compiler currently supports.


The scripts directory contains fully functional batch scripts to do compiling, decompiling and model conversion work.

Precompiled binaries

Windows binaries can be found under releases page.


You are free to make feature requests/bug reports under issues, as well as pull requests of course. More information can be found here.

External dependencies

All required dependencies are shipped with the project.
assetsys loads binary assets into virtual file system.
The library used in a project contains custom changes. MIT License.
Catch2 test framework for unit-tests, TDD and BDD. Boost Software License.
filesystem a simple class for manipulating paths on Linux/Windows/Mac OS. BSD-3 License.
jpeg-compressor jpeg compression/decompression lib. Public domain.
lodepng PNG encoder and decoder. zlib License.
msdirent.h dirent API for MS Windows. MIT License.
tinyformat type safe printf replacement library. Boost Software License.

Compiling binaries

Compiling on linux

mkdir build && cd build

Compiling on Windows

Several options are available.

Visual Studio 2017

In VS2017 you can natively open up the CMake project folder: File > Open > CMake, and compile the project using CMake menu.

Compile from command line

mkdir build
cd build
cmake ..
cmake --build . --target mapcompiler --config Release

Generate Visual Studio solution

mkdir build
cd build
cmake .. -G "Visual Studio 15 2017"

Open up sln in Visual Studio and build solution from there.

Original Q3Map2 License

Copyright (C) 1999-2007 id Software, Inc. and contributors.
For a list of contributors, see the accompanying CONTRIBUTORS file.

This file is part of GtkRadiant.

GtkRadiant 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.

GtkRadiant 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 GtkRadiant; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA


This code has been altered significantly from its original form, to support
several games based on the Quake III Arena engine, in the form of "Q3Map2."
You can’t perform that action at this time.