How to set up FuncGodot with TrenchBroom for Godot 4?

Install the FuncGodot plugin in Godot, export the FGD file using the plugin's tools, and configure TrenchBroom to use it. The online documentation provides specific steps for integration and game config setup.

Can FuncGodot import .vmf maps from newer Source engine games?

FuncGodot supports .vmf files used by Source engine, but compatibility may vary with newer versions or custom assets. It's recommended to test with your map files and check the documentation for any limitations.

FuncGodot vs Qodot: which one should I use for Godot 4?

FuncGodot is a rewrite of Qodot for Godot 4 with active maintenance and improvements. For new projects, choose FuncGodot as it's tailored for Godot 4, while Qodot might have legacy compatibility issues.

How to add custom materials or shaders to imported maps in FuncGodot?

Use the entity definition system to override materials or define custom ones in Godot after import. FuncGodot allows material assignment via classname keys, and you can tweak UVs and textures in the generated scene.

Does FuncGodot support dynamic lighting and shadows in Godot?

FuncGodot generates standard Godot meshes, so lighting depends on Godot's rendering system. However, map formats don't include advanced lighting data, so you'll need to manually add lights and configure shadows in Godot.

Is there a way to optimize large .map files for better performance?

Use FuncGodot's collision shape options (convex vs. concave) and consider simplifying brush geometry in the map editor. For large maps, you might need to implement LODs or manually optimize meshes in Godot post-import.

Open-Awesome

func_godot

MITGDScript2025.12

A Godot 4 plugin that imports Quake .map and Valve .vmf files to generate scenes, materials, and collision.

GitHub

790 stars70 forks0 contributors

What is func_godot?

FuncGodot is a plugin for Godot 4 that imports Quake .map and Valve .vmf files to generate full Godot scenes, including meshes, materials, and collision shapes. It enables developers to create 3D levels using established map editors like TrenchBroom, bridging traditional level design workflows with modern game engines.

Target Audience

Godot developers and level designers who want to use professional 3D map editors (e.g., TrenchBroom, Hammer) for environment creation, especially those familiar with Quake or Source engine workflows.

Value Proposition

It provides a robust, customizable pipeline for importing complex map data into Godot, with extensive entity support and editor integration, saving time compared to manual scene building while maintaining creative control.

Overview

Quake .map support for Godot 4

Use Cases

Best For

Importing Quake or Half-Life style maps into Godot projects
Creating 3D levels with TrenchBroom or Hammer for Godot games
Generating automatic collision meshes from brush-based geometry
Defining custom game entities that spawn from map editor data
Building environments with textured materials and UVs from .map files
Integrating traditional level design pipelines into modern game engines

Not Ideal For

Projects using sculpted or organic 3D models from tools like Blender, as FuncGodot is optimized for brush-based geometry from Quake-style editors.
Teams needing real-time, collaborative level design directly in the Godot editor without external software dependencies.
Games requiring advanced, engine-native lighting or material systems that exceed the capabilities of .map and .vmf formats.
Developers seeking a drag-and-drop, visual scripting approach for level design, since FuncGodot relies on text-based map files and entity definitions.

Pros & Cons

Pros

Broad Editor Compatibility

Supports multiple industry-standard editors like TrenchBroom, Hammer, J.A.C.K., and NetRadiant Custom, as listed in the README, allowing designers to use their preferred tools.

Automated Scene Generation

Generates Godot scenes with meshes, materials, UVs, and collision shapes from brush geometry, saving manual effort in environment creation.

Customizable Entity System

Allows fully customizable entities via classname and key-value pairs, enabling spawn nodes, scripts, or packed scenes, as detailed in the entity support section.

Texture Format Flexibility

Handles various texture formats like WAD2, WAD3, .lmp palettes, and .wal, providing broad compatibility for material imports from map files.

Cons

External Tool Dependency

Requires setup and proficiency in external map editors like TrenchBroom, adding complexity and a learning curve compared to built-in Godot tools.

Limited to Brush Workflows

Focused on Quake and Valve map formats, which may not integrate well with modern 3D modeling pipelines or support non-brush geometry effectively.

Performance Overhead Risks

Generating scenes from complex brush geometry can lead to heavy meshes and collision shapes, potentially impacting performance in Godot for large maps.

Steep Learning Curve

Assumes familiarity with map editing concepts and formats, which might be a barrier for developers new to Quake or Source engine workflows.

Frequently Asked Questions

Related Projects

Pixelorama

Unleash your creativity with Pixelorama, a powerful and accessible open-source pixel art multitool. Whether you want to create sprites, tiles, animations, or just express yourself in the language of pixel art, this software will realize your pixel-perfect dreams with a vast toolbox of features. Available on Windows, Linux, macOS and the Web!

Stars9,811

Forks520

Last commit2 days ago

Godot Demo Projects

Demonstration and Template Projects

Stars9,080

Forks2,173