人工智能AI Agent游戏开发AI 技能媒体生成【免费下载链接】godogenAutonomous game development for Godot, Bevy, and Babylon.js with Claude Code and Codex项目地址https://gitcode.com/gh_mirrors/go/godogen点击查看免费下载本文是 Godogen 项目中engines/godot.md引擎指南的深度解读。它服务于一个核心场景让 Claude Code / Codex 这样的编码 Agent 在一个只含运行时清单 引擎指南 资产技能的瘦仓库里从头搭建一个可运行的 Godot 4.NET 构建C# 游戏项目并最终产出可证明运行结果的视频。读完本文你将掌握 Godot 侧工程布局的硬性约束、用 C#SceneTree脚本在构建期生成.tscn场景的完整套路、几类编译通过但运行时静默失败的陷阱清单以及用--write-movie ffmpeg 产出确定性证明视频的完整命令链。这份指南在 Godogen 中的角色引擎即渲染期选择Godogen 不是游戏本身而是生成游戏的生成器godogen - 游戏仓库 - 游戏。源仓库本身刻意保持单薄——只维护一个引擎无关的运行时清单 prompts/runtime.md、一个跨引擎的资产生成技能 asset-gen/SKILL.md以及三份按引擎区分的指南 engines/godot.md、engines/babylon.md、engines/bevy.md。引擎和宿主 AgentClaude 还是 Codex是发布期的渲染选项而非相互独立的源码树。由 publish.sh 在发布时把对应引擎指南原样拷贝进新游戏仓库./publish.sh --engine godot --agent claude --out ~/my-game # 生成 CLAUDE.md .claude/skills/ ./publish.sh --engine godot --agent codex --out ~/my-game # 生成 AGENTS.md .agents/skills/以 Godot 为例发布产物包括运行时清单CLAUDE.md或AGENTS.md由 prompts/runtime.md 渲染其中指明读取godot.md获取引擎指导、godot.md引擎指南原文见 publish.sh 的cp $REPO_ROOT/engines/$ENGINE.md $TARGET/$ENGINE_GUIDE_FILE、以及asset-gen技能目录。同时 publish.sh 还会为 Godot 目标写入专用.gitignoreassets、screenshots、.godot、*.import、bin/、obj/均不入库。设计哲学见 AGENTS.md是不给显而易见的指导指南只承载模型无法快速推断或发现的东西——技术栈与布局骨架、静默失败陷阱、捕获配方。游戏脚手架、业务代码全部由 Agent 依据这份短指南自行重建。技术栈与项目形态硬性约束一览Godot 引擎指南锁定的技术栈是Godot 4.NET / Mono 构建 C#且所有 Godot C# 类必须声明为partial。这是从 CHANGELOG.md 记载的 2026-04-06 C# 迁移事件延续下来的既定路线全部技能与生成代码从 GDScript 迁移到 C# / .NETdotnet build取代了原先按文件逐个--check-only的校验循环。迁移动机在 docs/gdscript-vs-csharp.md 中有完整论述GDScript 的:类型推断在instantiate()、多态数学函数、数组/字典元素访问等约 15 类 API 上会静默返回 Variant形成温水煮青蛙式的类型错误流而 C# 泛型与类型推断如GD.LoadPackedScene(...)让同类错误在编译期就被拦截。标准项目骨架文件/目录职责与约束project.godot引擎配置、输入动作、显示、物理。版本敏感字段必须与已安装工具链匹配config_version以及.csproj中的Godot.NET.Sdk/...版本与TargetFramework。运行时先执行godot --version/dotnet --version实测不要凭记忆硬编码已有项目则保留原值。3D 项目设置3d/physics_engineJolt Physics并固定physics_ticks_per_second{ProjectName}.csproj程序集名必须与assembly_name一致必须包含EnableDynamicLoadingtrue/EnableDynamicLoadingscripts/*.cs运行时行为scenes/*.tscn场景构建期生成见下文assets/只放运行中游戏真正加载的文件生成输入与引用refs一律放在其外避免污染运行时资产目录构建门禁Build Gate每次改动后按固定顺序通过三道关卡保证用户本地运行godot --path .或编辑器始终反映当前状态dotnet build # 1. 编译门禁 godot --headless --import # 2. 资产变更后重新导入 godot --headless --quit # 3. 冒烟退出其中 headless 退出时出现的 RID 泄漏警告是良性的可忽略。用户在侧观看时是自己运行项目的因此保持构建与导入干净是持续要求而非一次性动作。场景是构建期生成的不是手写的Godot 引擎指南的核心主张场景以 C#SceneTree脚本在构建期生成而非手工编辑。每个场景对应一个一次性 headless 构建脚本godot --headless --script scenes/BuildX.csBuilder 负责构建节点层级、设置属性、挂接脚本、打包pack最后Quit()。它不含任何运行时逻辑——没有_Ready/_Process、信号或游戏状态。构建顺序遵循先叶子场景、后父场景因为父场景需要引用已就绪的叶子。序列化三规则都是静默失败下面的规则全是静默失败型编译照常通过但保存出的.tscn要么丢节点、要么文件膨胀。指南给出三条铁律Owner 链每个节点都必须把Owner设为场景根否则不会被序列化。构建完成后遍历整棵树对所有后代设置child.Owner root——但绝不递归进实例化的 GLB /.tscn节点这些节点SceneFilePath非空。若误递归进 GLB其全部网格会被内联成文本产生 100MB 的.tscn。校验打包结果打包前统计节点数打包后用Instantiate()实例化并再次统计比对一致才放行ResourceSaver.Save()。否则一次静默丢节点会伪装成成功。SetScript()会释放 C# 包装对象脚本必须最后设置层级建完再挂。对于根节点先把它加进一个临时Node设置脚本后通过temp.GetChild(0)重新取回再打包。这个临时父节点模式在 docs/gdscript-vs-csharp.md 中有对应说明——它是 C# 迁移后新增的唯一重大怪癖调用SetScript()后原 C# 变量已死ObjectDisposedException一旦写进模板实践中就再也不会踩到。共享保存路径的代码骨架引擎指南原文可直接落进任意 Buildervoid PackAndSave(Node root, string path) { SetOwnerRecursive(root, root); // skip nodes with SceneFilePath set int expected CountNodes(root); var packed new PackedScene(); if (packed.Pack(root) ! Error.Ok) { Quit(1); return; } var test packed.Instantiate(); int got CountNodes(test); test.Free(); if (got expected) { GD.PushError(nodes dropped); Quit(1); return; } // serialization failed silently ResourceSaver.Save(packed, path); Quit(0); }GLB 模型接入规则对于 GLB 模型实例化其PackedScene测量MeshInstance3D的 AABB 来决定缩放碰撞形状必须用基于 AABB 的图元Box/Sphere/Capsule。严禁对导入网格调用CreateTrimeshShape()/CreateConvexShape()——那会把帧率打到 1 FPS 以下。值得记住的怪癖静默失败清单引擎指南认为模型已经熟知多数 Godot 行为但下面这几类失败不会报任何错误必须主动规避macOS 上致命错误表现为挂起而非退出Godot 会把错误放进一个NSAlert模态框--headless无法关闭它于是进程以 0% CPU 空转缺主场景也会这样。对策每次godot调用都包在timeout下运行退出码 124 即视为失败。如果输出停在.NET: Initializing module...说明GodotSharp/未被找到——PATH上的godot是符号链接而非包装脚本。ArrayMesh.GenerateNormals()是程序化网格接收阴影的必要条件不调用或把CullMode.Disabled当作安全网都会让阴影静默消失——正确做法是修缠绕顺序。MultiMeshInstance3D GLB 打包/保存时会丢网格改用独立实例。GLB 内部节点上的MaterialOverride同样无法序列化owner 被跳过——需要自定义材质时改用程序化ArrayMesh。射线对ConcavePolygonShape3Dtrimesh命中不可靠改用形状查询shape query或对地形高度做解析采样。.gdignore会让导入器静默跳过整个目录只有screenshots/目录允许放它assets/永远不要。C# 枚举名不可靠训练数据偏向 GDScriptLLM 猜出的 C# 枚举名常常是错的如BGMode.Sky而非BGModeEnum.Sky。对策是直接对照已安装 Godot 验证——阅读 Godot 文档/程序集中的 C# API而不是靠记忆猜测。这一点在 docs/gdscript-vs-csharp.md 中被列为 C# 迁移后仅剩的三个痛点之一。与帧率无关的阻尼公式speed * Mathf.Exp(-rate * delta)而不是每帧speed * (1 - drag)。捕获证明视频确定性录制的完整配方Godogen 的交付铁律是用运行中的游戏证明结果而不是用一次干净编译见 prompts/runtime.md。对 Godot 而言这条铁律落地的载体就是硬件 VulkanmacOS 上用 Metal驱动的 Godot 电影写入器硬件 GPU 渲染正确且是录视频的硬性前提软件 Vulkanllvmpipe/lavapipe还能出静态帧但必须跳过视频并向用户说明。macOS 没有xvfb捕获在真实窗口中进行此时给--write-movie追加--headless会直接中止报Parameter t is null。捕获由test/下的专用捕获SceneTree脚本驱动如Presentation.cs完整命令链如下Linux 无头机器上在xvfb-run内执行优先使用硬件 Vulkan ICD# 前置xvfb-run -a -s -screen 0 1920x1080x24优先硬件 Vulkan ICD godot --headless --import godot --write-movie screenshots/result/frame.png --fixed-fps 30 --quit-after 450 --script test/Presentation.cs ffmpeg -y -framerate 30 -pattern_type glob -i screenshots/result/frame*.png \ -c:v libx264 -pix_fmt yuv420p -movflags faststart screenshots/result/video.mp4要点逐条拆解--fixed-fps 30使运动确定性化450 帧 30fps 正好 15 秒满足 prompts/runtime.md 要求的 15–20 秒证明视频时长。镜头必须提前摆好在 Builder 或_Initialize中预置摄像机位置——电影写入器第一帧在_Process之前就会渲染。捕获期输入由脚本驱动不要依赖实时按键否则每一帧都是人为不确定因素。成片质量要求片段必须展示行为在全窗口范围内持续推进——没有死时间没有单帧循环。从指南到交付一份文档贯穿全流程把整条链路串起来看用户给出游戏描述 → Agent 依据 prompts/runtime.md 读入godot.md→ 按技术栈 项目形态搭好 C# 工程 → 用构建期SceneTree脚本按三条序列化铁律生成场景 → 用 asset-gen/SKILL.md 生成贴图、GLB 与精灵动画Godot 侧运行时资产统一放assets/见 publish.sh 对RUNTIME_ASSET_DIR的赋值→ 用硬件 Vulkan 的电影写入器录下确定性的 15 秒证明视频 → 自己回放确认行为正确后再交付。用户在场时则以godot --path .的实时窗口替代视频Agent 在品味/范围/成本决策点征求确认这两种模式的分流逻辑同样写在 prompts/runtime.md 中。整套设计隐含一个取舍引擎指南不追求全面覆盖 Godot API那超出单页容量也会与已安装版本脱节而是把文字预算全部花在模型无法快速推断的三类知识上——项目骨架的硬约束、序列化的静默失败规则、确定性捕获配方。任何想复用这套工作流的读者都可以直接把本文中的PackAndSave骨架、构建门禁三步命令与--write-movie ffmpeg 配方照搬进自己的 Godot 4 C# 项目让可运行的游戏与可回放的证明同时成立。赞分享人工智能AI Agent游戏开发AI 技能媒体生成【免费下载链接】godogenAutonomous game development for Godot, Bevy, and Babylon.js with Claude Code and Codex项目地址https://gitcode.com/gh_mirrors/go/godogen点击查看免费下载相关推荐Godot引擎2D游戏开发构建主游戏场景Godot引擎2D游戏开发构建主游戏场景 概述 在2D游戏开发过程中主游戏场景是整个游戏的核心枢纽负责协调各个游戏元素的交互与逻辑。本文将详细介绍如何使用文档教程游戏开发Godot引擎3D游戏开发设计怪物场景Godot引擎3D游戏开发设计怪物场景 概述 在3D游戏开发中怪物Mob是游戏体验的重要组成部分。本文将详细介绍如何在Godot引擎中创建一个基础的怪物文档教程游戏开发终极C游戏引擎开发指南使用Doxygen自动生成专业API文档终极C游戏引擎开发指南使用Doxygen自动生成专业API文档 在C游戏引擎开发过程中维护清晰的API文档是提升团队协作效率的关键。本文将介绍如何使教程游戏开发图形学上一篇揭秘智能英语学习革命用DashPlayer打造你的个性化沉浸式学习系统下一篇BilibiliDown终极指南如何高效下载B站视频构建个人媒体库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考