FuncGodot地图编辑器集成TrenchBroom GameConfig导出与Brush/Face Tag实战【免费下载链接】func_godot_pluginQuake .map support for Godot 4项目地址: https://gitcode.com/gh_mirrors/fu/func_godot_pluginFuncGodot 是一款 Godot 4 插件能把 Quake.map地图文件直接转换成带网格、材质和碰撞的 Godot 场景。本文带你实战它最核心的编辑器集成能力一键导出 TrenchBroom GameConfig并配置 Brush Tag 与 Face Tag让你的地图编辑体验瞬间专业化。为什么要把 FuncGodot 接入 TrenchBroom用 TrenchBroom 这类可视化编辑器画地图再丢进引擎是 Quake 风格游戏开发的主流工作流TrenchBroom里画图元Brush、摆实体、贴纹理保存出.map文件FuncGodot作为 Godot 导入插件把.map、WAD、调色板等文件转成场景但 TrenchBroom 需要一份GameConfig才能认识你的游戏它靠这份配置知道有哪些地图格式、纹理放在哪个文件夹、实体清单FGD长什么样以及哪些面要画成透明。FuncGodot 把这一切都封装成了 Godot 里的普通 Resource改完点一下按钮就导出。一键导出 GameConfig背后发生了什么导出的主角是TrenchBroomGameConfig资源默认配置在addons/func_godot/game_config/trenchbroom/func_godot_tb_game_config.tres脚本实现见addons/func_godot/src/trenchbroom/trenchbroom_game_config.gd。它暴露的关键属性属性作用默认值game_name出现在 TrenchBroom 游戏列表里的名字FuncGodotmap_formats新建地图时可选的格式Valve / Standard / Quake2 / Quake3textures_root_folder纹理根目录相对 Game Pathtexturestexture_exclusion_patterns从列表隐藏纹理的通配符*_normal、*_roughness等 PBR 通道palette_pathQuake WAD2 用的调色板位置textures/palette.lmpfgd_file实体定义清单FGD 文件资源addons/func_godot/fgd/func_godot_fgd.tresentity_scale实体显示缩放表达式32game_config_version兼容旧版 TrenchBroom 的配置版本Latest9在检查器里点击Export GameConfig按钮后插件会自动完成三件事把游戏图标缩放为 32x32 保存为icon.png生成完整 JSON 文本写出GameConfig.cfg包含文件格式、纹理排除、实体定义、Tags 等全部字段一并导出配套的FGD 文件供 TrenchBroom 读取实体列表导出目录由本地配置统一管理打开addons/func_godot/func_godot_local_config.tres设置Trenchbroom Game Config Folder后点击 Save配置会保存到user://目录下的 JSON 文件逻辑见addons/func_godot/src/util/func_godot_local_config.gd。之后无论何时改配置都直接导出到这里。搞懂 Brush Tag 与 Face TagTag标签是 TrenchBroom 根据纹理名或类名自动给图元/面打标记的规则用途是让特殊面以不同外观显示比如透明、并在右键菜单里分类过滤。它只影响编辑器外观不影响 Godot 中的实际功能。Tag 由TrenchBroomTag资源描述脚本addons/func_godot/src/trenchbroom/trenchbroom_tag.gd核心字段tag_name标签显示名如 Cliptag_match_typeTexture匹配面纹理或Classname匹配实体类名tag_pattern匹配模式支持*通配符tag_attributes属性TrenchBroom 目前支持_transparent透明显示texture_name仅 Texture 匹配时生效的附加纹理过滤Face Tag 用纹理匹配——贴了clip纹理的面自动变透明Brush Tag 用类名匹配——类名以trigger开头的整个图元被标记。五个内置标签逐一拆解项目已预置好常用标签直接开箱即用标签类型匹配模式效果配置文件Clip Face TagTextureclip透明显示game_config/trenchbroom/tb_face_tag_clip.tresSkip ⏭Face TagTextureskip透明显示game_config/trenchbroom/tb_face_tag_skip.tresOrigin Face TagTextureorigin透明显示game_config/trenchbroom/tb_face_tag_origin.tresFunc Brush TagClassnamefunc*菜单归类game_config/trenchbroom/tb_brush_tag_func.tresTrigger Brush TagClassnametrigger*透明显示game_config/trenchbroom/tb_brush_tag_trigger.tres路径均相对addons/func_godot/几个值得注意的细节三个 Face Tag 默认都带_transparent属性这是 Quake 工作流惯例clip/skip/origin 面在引擎中会被特殊处理编辑器里半透明化后一眼可辨Func 标签的tag_attributes是空数组——它只用于菜单分类不做透明处理这三个 Face Tag 已在默认 GameConfig 的brushface_tags中预加载brush_tags默认为空需要时自行添加自定义自己的 Tag三步上手当你有自定义面类型例如water*系列纹理时新建资源在项目里创建TrenchBroomTag资源填好tag_name、匹配类型Texture、tag_pattern如water*挂到 GameConfig把它加进TrenchBroomGameConfig的brush_tags或brushface_tags数组Face Tag 进brushface_tagsBrush 标签进brush_tags点 Export GameConfig插件会把标签序列化为 cfg 的tags.brush/tags.brushface条目见_parse_tags逻辑写入GameConfig.cfg导出后在 TrenchBroom 里选中游戏对应的面就会自动变色/透明右键菜单也能按标签筛选了。常见坑位排雷 ✅导出被跳过控制台出现No TrenchBroom Game folder说明 Local Config 里没设 Trenchbroom Game Config FolderFGD 没导出检查 GameConfig 的fgd_file是否为空旧版 TrenchBroom 不认配置把game_config_version调低——版本 4 用textures字段和texture键版本 8/9 用materials字段和material键插件会自动按版本转换见_get_game_config_v4_text与_get_game_config_v9v8_text通配符技巧tag_pattern支持*trigger*可以一次覆盖trigger_door、trigger_push等一整族实体小结FuncGodot 把 TrenchBroom 集成变成了资源 按钮TrenchBroomGameConfig管全局TrenchBroomTag管单个标记一次导出同时产出GameConfig.cfg、图标和 FGD 清单。掌握 Brush/Face Tag 后你的地图在编辑器里就能自解释——哪些面是 clip、哪些图元是 trigger一目了然 【免费下载链接】func_godot_pluginQuake .map support for Godot 4项目地址: https://gitcode.com/gh_mirrors/fu/func_godot_plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考