TrenchBroom is a [[GPLv3]] licensed [[id Tech 2|Quake Engine]] level editor written in [[C++]].
- [Website](https://trenchbroom.github.io/)
- [Source](https://github.com/TrenchBroom/TrenchBroom)
- [Documentation](https://trenchbroom.github.io/manual/latest/)
- AlternativeTo
> TrenchBroom is a free (GPLv3+), cross platform level editor for Quake-engine based games. It supports Quake, Quake 2, and Hexen 2
# Notability
# Philosophy
# Platform Support
- Linux
- MacOS
- Windows
- 32
- 64
## Engine Support
Fully supports the majority of [[id Tech 2]] games and has experimental support for [[id Tech 3]] and [[GoldSrc]] games.
# Features
# Tips
## Setup
### Load WADs
WAD list is on the world spawn entity.
## Map Scaling
Trenchbroom uses "Quake Units" for all of its measurements. These are theoretically arbitrary, but when loaded into most engines, they tend to have a standard scaling factor.
$
32_{quake \_ units} = 1_{meter}
$
At the default grid scale of 16, this is 2 squares per meter.
[[Func Godot]] allows for arbitrary [settings](https://func-godot.github.io/func_godot_docs/FuncGodot%20Manual/FuncGodot%20Manual.html) for the "Inverse Scale Factor" from Quake Units into Godot Units, but defaults to `32`.
## Camera / View
### Center on Selected
1. Ctrl-U
### Rotate View Around Cursor
1. Alt right click drag
## Face Actions
### Move Face
1. Shift left click drag
### Extrude Face
1. Ctrl-Shift left click drag
### Slice Face
Lets you cut a shape into pieces using the face as the blade.
1. Ctrl-Shift left click drag
## Texture Actions
### Spread Texture
Uses the current texture and offsets it so that the other faces align to it on the texture map.
1. Select face with texture
2. Shift-Alt left click drag across other (contiguous) faces
### Wrap Texture
Similar to spread but wraps the current object.
1. Select face with texture
2. Shift-Alt left *double* click
### Copy Texture
1. Select face with texture
2. Hold alt
3. Click destination face
### Shift Texture
1. Select face with texture (shift-click)
2. Ctrl-Arrows
## Object Actions
### Skew Object
1. Select object
2. Shift-Alt left click drag
# References
## Cheatsheets
- https://www.slipseer.com/index.php?threads/bals-quake-mapping-tips-tricks.100/
- https://book.leveldesignbook.com/appendix/tools/trenchbroom
## Tutorials
```cardlink
url: https://youtu.be/gONePWocbqA
title: "Quake Mapping: TrenchBroom 2 Quickstart"
description: "IMPORTANT: Trenchbroom has had some user interface changes since this video was published. Please refer to the use manual if you can't find something mention..."
host: youtu.be
favicon: https://www.youtube.com/s/desktop/dd6eea47/img/logos/favicon_32x32.png
image: https://i.ytimg.com/vi/gONePWocbqA/maxresdefault.jpg
```
```cardlink
url: https://www.youtube.com/watch?v=E27I6JCn9jw
title: "Trenchbroom and Quake: Curved Tunnel"
description: "Forgot to mention, you should add the key _phong with a value of 1 to your curved hallway func_detail entities!Grab the Makkon textures here, and drop a like..."
host: www.youtube.com
favicon: https://www.youtube.com/s/desktop/dd6eea47/img/logos/favicon_32x32.png
image: https://i.ytimg.com/vi/E27I6JCn9jw/maxresdefault.jpg
```
```cardlink
url: https://www.youtube.com/watch?v=m3hqbytOdV4
title: "All about compiling [GoldSRC Mapping]"
description: "Avoid them BSP leaks!Here I talk about exporting your maps to Half-Life, and some problems you might encounter along the way. I also give a little bit of tro..."
host: www.youtube.com
favicon: https://www.youtube.com/s/desktop/606e092f/img/logos/favicon_32x32.png
image: https://i.ytimg.com/vi/m3hqbytOdV4/maxresdefault.jpg
```
- https://andrewyoderdesign.blog/2019/06/08/making-your-first-map-in-quake-part-1/