Text in. Levels out.

MapForge turns a plain-text map spec (YAML or JSON) into a complete graybox level in one editor pass: floors, walls, circular rooms, stairs, ramps, doorway openings, blockout props, gameplay markers, a real PlayerStart, a NavMeshBoundsVolume — and a default light rig so the level is never black.

ITERATE FEARLESSLY

Generation is deterministic and only ever deletes actors prefixed "GB_". Your hand-placed props, lights, and gameplay actors are never touched. Change one number in the spec, regenerate, and get exactly the same level plus your change.

SPECS ARE THE INTERFACE

Map specs are plain text: version them, diff them, review them in pull requests — or let AI write them. A free open-source MCP server lets Claude and other MCP clients write specs and generate levels from a chat message, or even from a hand-drawn sketch.

THREE WAYS TO RUN

• Editor menu: Tools > MapForge > Generate Graybox Levels

• Console: MapForge.Validate / MapForge.GenerateAll

• Unattended CI: UnrealEditor-Cmd.exe -ExecCmds="MapForge.GenerateAllAndQuit"

PROJECT-AGNOSTIC

Pure Editor-module plugin (no runtime cost). References only engine assets. Includes automation tests. Project Settings options: spec directory, marker type registry (map your own actor classes), auto-create missing levels, default lighting toggle.

Perfect for level designers blocking out combat spaces, teams that want reviewable level layouts, and anyone building AI-assisted content pipelines.

TECHNICAL DETAILS

• Editor-only module (MapForgeEditor), CanContainContent: false

• Supported: UE 5.7 / 5.8, Windows (Win64 verified)

• Spec language: documented YAML subset or JSON, JSON Schema included

• Documentation: quick-start guide + full spec-writing guid