whatisgithub

What is godot-map-builder?

callmemhz/godot-map-builder — explained in plain English

Analysis updated 2026-05-18

33GDScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A Godot 4 plugin that lets you build and texture 3D game levels directly inside the editor using solid shapes called brushes, with no export step needed.

Mindmap

mindmap
  root((repo))
    What it does
      In-viewport level editor
      Brush-based map building
      Bake to Godot scene
    Editing tools
      Extrude and clip faces
      Vertex and edge editing
      Subtract and hollow brushes
    Primitives
      Wedges and cylinders
      Arches and stairs
      Curved corridors
    Texturing
      Per-face material painting
      PBR texture set detection
      Valve 220 style UVs
    Import and export
      Import TrenchBroom map files
      Bake optimized scene
      Retro rendering module
    License and audience
      MIT licensed
      Sponsored by MakePlay ai

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Sketch and texture a full 3D level inside the Godot editor without external tools.

USE CASE 2

Import a TrenchBroom .map file and continue editing it directly in Godot.

USE CASE 3

Bake a finished brush layout into an optimized scene with merged meshes and collision.

USE CASE 4

Apply a retro PlayStation-era visual style to a 3D level for a vintage look.

What is it built with?

GDScriptGodot 4

How does it compare?

callmemhz/godot-map-buildergodotengine/godot-docs-project-starterskelpekk/juicee
Stars333926
LanguageGDScriptGDScriptGDScript
Last pushed2025-04-15
MaintenanceStale
Setup difficultyeasyeasyeasy
Complexity3/51/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Godot 4.7 or later, installation is a standard plugin copy into the addons folder.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Map Builder is a plugin for the Godot game engine, version 4.7 or later. It adds a level editor directly inside the Godot viewport, letting you sketch out and texture full 3D levels without switching to an external program. The workflow is inspired by classic tools like TrenchBroom and Quake-era editors, where you build maps out of solid convex shapes called brushes. The core idea is that the map you draw is already a Godot scene, so there is no export or import step between designing and playing. The main editing tools center around drawing and manipulating these solid brushes on a grid. You can drag out a box, push or pull a face to resize it, extrude faces outward to create new shapes, or carve inward to clip sections away. There are tools for editing individual vertices and edges, slicing brushes with a clip line, merging multiple brushes together, subtracting one brush from another to make doorways, and hollowing a solid block into walls. The plugin also provides parametric primitives like wedges, cylinders, arches, curved corridors, and configurable stairs. For texturing, Map Builder includes a material dock with a live preview of the selected face. You can paint textures per face, apply quick material stamps, and adjust offset, scale, and rotation in a Valve 220 style. The system detects PBR texture sets automatically, keeps textures locked to the world during edits, and offers one-click UV resets. You can also import existing .map files from TrenchBroom, scaled to match common Godot conventions. When your layout is done, a single bake command converts the entire map into an optimized scene with merged meshes and generated collision, ready to drop into your game. An optional retro rendering module provides a PlayStation-era visual style, with low-resolution upscaling, texture downsampling, color grading, and several preset look-up tables. Every editing action goes through Godot's undo system. The project is MIT licensed and sponsored by MakePlay.ai.

Copy-paste prompts

Prompt 1
Help me install the Map Builder plugin in Godot 4 and show me how to draw my first brush in the viewport.
Prompt 2
Walk me through subtracting one brush from another in Godot Map Builder to create a doorway between two rooms.
Prompt 3
I have a .map file from TrenchBroom, how do I import it into Godot Map Builder and start editing it?
Prompt 4
Explain how to use the bake command in Map Builder to turn my brush layout into an optimized Godot scene with collision.
Prompt 5
Show me how to enable the retro rendering module in Map Builder and apply a PlayStation-era look to my level.

Frequently asked questions

What is godot-map-builder?

A Godot 4 plugin that lets you build and texture 3D game levels directly inside the editor using solid shapes called brushes, with no export step needed.

What language is godot-map-builder written in?

Mainly GDScript. The stack also includes GDScript, Godot 4.

What license does godot-map-builder use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is godot-map-builder to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is godot-map-builder for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.