为什么值得关注

它将经典的 Quake 时代画刷工作流程引入 Godot，省去了外部工具的导出/导入循环，并包含 CSG 操作、逐面纹理贴图、.map 导入以及可选的复古渲染工具包。

适合谁使用

使用 Godot 制作 3D 游戏的开发者
偏好画刷建模的关卡设计师
希望集成关卡编辑的独立开发者
尝试复古渲染效果的爱好者

典型使用场景

在 Godot 编辑器中快速勾勒和迭代关卡几何体
使用 CSG 合并/减法及基本几何体创建模块化环境
导入 TrenchBroom 的 .map 文件并转换为优化的 Godot 场景
利用可选的 RetroViewport 和纹理降采样实现 PSX 时代的复古外观

项目优势

完全集成到 Godot 编辑器中，支持撤销和网格对齐
支持高级画刷操作，如面挤压、雕刻、切割和掏空
包含逐面纹理绘制，支持 Valve 220 UV 和自动 PBR 检测
提供独立的复古渲染模块，包含抖动、量化及 LUT 预设

使用前须知

需要 Godot 4.7+，不兼容较早版本
早期版本（v0.1.0）可能存在功能缺失或错误
复古渲染模块为可选，可能不适用于所有美术风格

README 快速开始

🧱 Map Builder

TrenchBroom-style brush level editor — right inside the Godot 4 viewport.

Block out and texture whole levels without leaving the engine: draw convex brushes on a grid, push/pull faces, carve with clips and CSG subtract, paint textures per face — then bake everything into one optimized scene ready for gameplay.

Why

Godot's CSG nodes are great for prototyping but slow to edit at level scale, and external tools like TrenchBroom mean a constant export/import round-trip. Map Builder brings the classic Quake-era brush workflow — solid convex brushes, grid snapping, face push/pull — into the Godot editor itself, so the map you sketch is already a Godot scene.

✨ Features

🔨 Brush editing

Convex brushes as first-class nodes — every brush is a set of planes; vertices and edges are derived, so geometry is always a valid solid
Box tool — drag on the ground (or on top of any brush) to draw a new box
Face push/pull — Shift+drag a face along its normal, grid-snapped; coplanar faces across the selection move together
Face extrude & carve — Ctrl+Shift+drag a face outward to extrude a new brush, or inward to clip-split the slab off the source (with a see-through ghost preview)
Vertex & edge editing — drag corners or edges with grid snapping (Alt = vertical); the brush re-solves as a convex hull
Clip tool — draw a line across a face to slice every selected brush along that plane
CSG — Merge selected brushes into their convex hull; Subtract to carve windows/doorways
Hollow — turn a brush into walls of a given thickness

🏗️ Level assembly

Primitives — box, wedge, cylinder, arch, ring (curved corridor), parametric stairs (steps / rise / run / width)
Arc tool — revolve any face around an anchor to build arches and bent corridors, one brush per step
Grouping — Ctrl+G groups brushes; double-click to enter a group and edit in isolation, Esc to leave
Sweep select — Ctrl+drag across brushes to select (or deselect) them in one stroke
Nudge — Ctrl+arrows / Ctrl+PgUp/PgDn move the selection one grid step
Everything is undoable — every tool commits through the editor's undo system

🎨 Texturing

**Material dock

项目描述

TrenchBroom-style brush level editor inside the Godot 4 viewport - draw convex brushes, push/pull faces, clip, texture, and bake to an optimized scene.

godot-map-builder