Codex Game Studio插件实现无代码构建可追溯Godot游戏原型：通过本地化、确认制、日志驱动的流程，将自然语言设计转化为结构化工程文件与可调试状态机。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用一句话描述角色就生成可运行的游戏原型，不用写代码、不用画美术，但又怕AI胡编乱造导致项目失控——Codex Game Studio插件正是为解决这个矛盾而生的。它把游戏设计意图直接翻译成Godot工程结构、状态机逻辑和基础交互脚本，所有产出都严格绑定本地项目目录，不联网调用外部模型，不自动覆盖已有文件，每一步改动都可追溯、可回退。
创建专属游戏项目工作区
打开 Codex App → 点击左下角「+ New Project」→ 在弹窗中选择「Game Studio」模板 → 指定一个空文件夹作为根路径（例如 【D:\games\roguelike-demo】）→ 勾选「Initialize as Godot 4.6+ project」→ 点击 Create。
这一步会自动生成标准 Godot 项目骨架，包含 res://addons/codex_game_studio/ 目录和默认配置文件。不要跳过初始化，否则后续技能无法识别引擎版本与节点约定。
用自然语言定义核心玩法
在当前项目对话框中输入：
“我需要一个肉鸽动作游戏：玩家操控兽耳战士，使用巨剑近战，每次死亡后解锁新技能；关卡由随机房间组成，含宝箱、陷阱和小怪；击败Boss后进入下一区域。”
按下回车后，Codex Game Studio 插件会自动解析关键词，生成 docs/design_summary.md 并列出待确认项：角色类型、技能解锁机制、房间生成规则、Boss战触发条件。你必须逐条核对并回复“确认”或补充细节，【插件不会擅自执行未确认的设计决策】。
确认完成后，它将同步创建 res://characters/、res://levels/、res://skills/ 三个目录，并在每个目录下生成带注释的 .gd 脚本和 .tscn 场景模板。
驱动美术资产生成与绑定
方法一：本地资源驱动
把已有的 PNG 角色立绘拖入 res://assets/characters/ → 在对话中输入：“用这张图生成兽耳战士的 SpriteFrames 动画，包含 idle、walk_left、attack_down 三组序列，帧率12。” → Codex 自动调用 Godot 的 SpriteFrames 编辑器 API 生成动画资源，不依赖外部图像生成服务。
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
方法二：AI生成+人工筛选
输入：“生成5张兽耳战士不同姿态的线稿草图，风格统一、无背景、PNG格式，分辨率512×512。” → 插件调用本地部署的 Stable Diffusion WebUI（需提前配置路径），输出到 res://assets/refs/ → 你手动挑选一张 → 输入：“将 res://assets/refs/hero_pose3.png 设为 attack_down 主帧，补全8帧循环。”
注意：AI生成的图不会直接进 assets 目录，必须经你点击确认后才移动并重命名，防止垃圾文件污染资源树。
构建可调试的战斗状态机
第一步：声明状态流转规则
输入：“创建 PlayerCombatStateMachine.gd，支持 idle → walk → attack → block → hit 四个主状态，attack 后强制返回 idle，hit 状态持续0.8秒后自动切回 idle。”
第二步：绑定输入与动画
输入：“在 Player.gd 中挂载该状态机，将 Input.is_action_pressed('ui_right') 映射为 walk_right，'ui_attack' 映射为 attack，'ui_block' 映射为 block。”
第三步：注入调试钩子
输入：“为每个状态切换添加 print() 日志，格式为 '[Combat] → {state_name}'，并在 attack 状态中插入 GD.print('Swing!')。”
这一步至关重要——没有日志的状态机在 Godot Debugger 中无法观测流转，你会陷入纯猜谜式调试。
一键启动原型验证流程
点击右上角「Run Prototype」按钮 → Codex 自动执行：
1. 检查 res://main.tscn 是否存在且含 Player 节点
2. 若缺失则生成最小可行场景
3. 运行 godot --path "D:\games\roguelike-demo" --no-window --headless -s res://scripts/test_runner.gd
4. 将 stdout 输出捕获并高亮显示关键错误（如 missing signal、invalid node path）
若控制台出现 “✅ All core states initialized” 字样，说明状态机已加载成功；此时可关闭 headless 模式，在 Godot 编辑器中双击 main.tscn 正常运行，键盘操作即可触发你定义的所有状态流转。
