VibeyMapTools (VMT)
Modern BSP compilation tools for Quake engine mapping
Formerly ericw-tools, now with extra sparkle โจ๐ง๐ ๏ธ
Download | Documentation | Wiki | Changelog
๐งฐ Tools (aka the toolbox)
| vmt-bsp |
Compile .map to .bsp |
| vmt-vis |
Calculate PVS visibility |
| vmt-light |
Calculate lightmaps with Embree CPU ray tracing |
| vmt-bspinfo |
BSP information utility |
| vmt-bsputil |
BSP manipulation utility |
| vmt-maputil |
Lua scripting for .map workflows |
| vmt-hub |
Map build hub (Qt) |
๐ Coming from ericw-tools? Here is the glow-up ๐ก๐งฅโจ
Same bones, new polish. If you used qbsp/vis/light before, your muscle memory still works. Flags and map formats are familiar. VMT adds modern build + packaging and a pile of shiny upgrades. ๐ง๐ ๏ธ
Rename cheat sheet (old -> new):
| ericw-tools |
VibeyMapTools |
qbsp |
vmt-bsp |
vis |
vmt-vis |
light |
vmt-light |
bspinfo |
vmt-bspinfo |
bsputil |
vmt-bsputil |
maputil |
vmt-maputil |
hub |
vmt-hub |
What stayed the same (cozy mode):
- Classic compile flow:
bsp -> vis -> light
- Quake II + Remaster support is still here (
-q2bsp, -lightgrid, -world_units_per_luxel) ๐ง ๐ฎ
- CLI flag vocabulary, map formats, and output expectations
- Upstream docs still apply: ericw-tools docs ๐
What is new & shiny (and yes it is a lot):
vmt- prefix on every binary so ericw-tools can live side-by-side ๐งนโจ
- Semantic versioning + tag-driven releases with CI-built packages ๐ฆ๐
- Build metadata +
version.hh for scripting and diagnostics ๐งพ๐ ๏ธ
- Improved Half-Life support (updated behavior + smoother compatibility) ๐ฎโจ
- Numerous bug fixes and improvements across the toolchain ๐งฐ๐
๐ Quick Start
# Standard compilation (classic flow โจ)
vmt-bsp mymap.map
vmt-vis mymap.bsp
vmt-light mymap.bsp
# High-quality lighting with extra samples and bounces ๐ฅ
vmt-light -extra4 -bounce 2 mymap.bsp
๐ Key Features
- ๐ง Fast CPU ray tracing via Embree
- ๐ HDR lightmaps (
-hdr) for engines that support it
- ๐ Opt-in, path-sanitized lighting manifests (
-embedsettings) for reproducible relights
- ๐ค๏ธ Stock GoldSrc
light_environment and light_spot compatibility in Half-Life BSPs
- ๐๏ธ Safe loose/PAK texture discovery with both traditional
textures/ and prefix-free layouts
- ๐ฅ๏ธ A Qt-powered map build and preview workflow in
vmt-hub
๐ฆ Downloads
| Platform |
Package |
Windows |
vibeymaptools-windows-*.zip |
Linux |
vibeymaptools-linux-*.tar.gz |
macOS |
vibeymaptools-macos-*.tar.gz |
โจ Latest Release
๐งช Building from Source
git clone --recursive https://github.com/themuffinator/VibeyMapTools.git
cd VibeyMapTools && cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
macOS 10.15+ prep: brew install cmake embree tbb qt@6 (Qt6 only needed for vmt-hub)
Requirements
- CMake 3.16+
- C++20 compiler (Visual Studio 2019 16.11+, GCC 10+, or Clang 12+ with a C++20 standard library)
- macOS 10.15+ (Catalina) recommended for Apple builds
- Embree 4.x + oneTBB (required for
vmt-light)
Optional extras:
See BUILDING.md for detailed instructions.
๐ Documentation
| Document |
Description |
| BUILDING.md |
Build instructions, versioning, CI/CD |
| CHANGELOG.md |
Version history and release notes |
| WIKI.md |
Documentation hub and quick reference |
| docs/ |
Full tutorials and reference |
๐งพ License
GPL v3 - See COPYING
๐ Third-party attribution
The BSP JSON texture exporter includes an adapted
Base64 encoder by tomykaira,
used under the MIT License; its copyright and permission notice are retained in
the source.
The reproducible build and test stack uses pinned, MIT-compatible submodules:
{fmt},
JsonCpp,
nanobench, and
pareto. Their tested revisions are
recorded as Git links so a recursive clone receives the same dependency set. ๐