QMap Godot

Lightweight loader & editor for Quake & Source style Maps, Wads, and FGDs

QMap Godot brings classic id Tech / Source-style level authoring into the Godot editor. Import .map geometry, .wad textures, and .fgd entity definitions directly into your project — no external conversion step required.

Features

• .map loading — Parse and import Quake/Source-format map files directly into Godot, and support user-designed levels natively in your project.
• WAD texture support — Read textures directly from .wad archives, view them in-editor, and apply them directly to brushes.
• FGD entity definitions — Build and edit .fgd files in-editor, giving full control of how entities are loaded and managed, fully ready to hook into Godot nodes and scripts.

Requirements

• Godot 4.6+

Installation

1. Download or clone this repository.
2. Copy the plugin folder into your project's addons/ directory.
3. In Godot, go to Project → Project Settings → Plugins and enable QMap Godot.

Usage

Any .map editor can be used, including importing directly from old Quake/Source games. My personally recommended editor is TrenchBroom.

Quick start instructions as well as a full guide can be found here.

Contributing

Issues and pull requests are welcome — this project is actively evolving, so feedback on real-world use cases is especially helpful.

License

Licensed under the MIT License.

Support

If you enjoy this project, consider supporting development: