Codex Game Maker

在 AI 辅助创作日益普及的今天，生成一张精美的角色图很容易，但将其转化为游戏中可运行、可动画、可交互的资产却难如登天。Codex Game Maker 是一个专为 Codex 设计的 Godot 优先 游戏制作工作流。它不仅仅是一个提示词集合，更是一套完整的自动化工具链，能将 Codex 会话瞬间变身为轻量级的游戏制作空间。

通过集成 Godot 4.4 引擎检测、资产自动化处理（去背景、切帧、QA）、以及 Web 导出预览，Codex Game Maker 解决了 AI 生成内容与游戏引擎之间的“最后一公里”问题，让开发者能专注于创意本身，而非繁琐的技术细节。

核心亮点：Godot 优先、资产可用、流程轻量

1. Godot 4.4 深度集成

• 一等公民支持：默认推荐并自动配置 Godot 4.4，支持引擎检测、安装/注册、Web 导出模板管理及浏览器即时预览。
• 智能接管：能识别现有的 Unity/Unreal/Phaser 项目并保留结构，但对新项目默认采用 Godot 4.4 + Web Export 的最佳实践。
• GDScript Lint：内置代码规范检查，确保生成的脚本符合 Godot 最佳实践。

2. “可进游戏”的资产管线

• 超越“好看”：不再止步于生成静态图片。Codex Game Maker 将 GPT Image 生成的原始素材自动转化为：
  • 透明 PNG/GIF：自动去背景。
  • SpriteFrames：自动切帧、对齐，生成 Godot 可用的动画资源。
  • Metadata & QA：自动生成元数据并进行质量检查（如边缘瑕疵修复）。
• 自动化导入：一键将处理好的资产导入 Godot 项目，生成 AnimatedSprite2D、SpriteFrames、TileMapLayer 等节点配置文件。

3. 轻量且专业的 Skill 体系

• 8 大核心 Skills：start（启动）、design（设计）、art（美术）、sprite（精灵）、map（地图）、asset QA（资产质检）、architecture（架构）、review（评审）。
• 显式专业流程：发布（/release）、团队协作（/team-*）、音频/本地化_pass 等高级功能仅在明确触发时启用，保持日常开发的轻量化。
• 文档驱动决策：遇到版本冲突或资源问题时，优先查询官方文档和网络资源，确保解决方案的准确性。

4. 规划握手与上下文管理

• Planning Handshake：在项目启动或复杂需求前，Codex 会总结需求、检测上下文、给出默认方案，并最多询问 3 个关键问题，确认 go with defaults 后才开始创建文件，避免盲目生成。
• 状态持久化：通过 planning docs、asset manifests 和 production/session-state/active.md 维持长期项目的连续性，适配大上下文窗口（目标 1M tokens）。

快速开始

1. 克隆与初始化

git clone https://github.com/0xnickmortal/Codex-Game-Maker.git my-game
cd my-game

# Windows
powershell -ExecutionPolicy Bypass -File tools\check-install.ps1

# macOS/Linux
pwsh -File tools/check-install.ps1

2. 在 Codex 中启动

打开 Codex，输入：

“Use Codex Game Maker to start this game project.”

Codex 将进入规划握手阶段，确认需求后自动搭建项目结构。

3. 配置 Godot 环境

安装 Godot 4.4 及 Web 导出模板：

powershell -ExecutionPolicy Bypass -File tools\install-godot.ps1 -WithExportTemplates

注册已有 Godot 路径（可选）：

powershell -ExecutionPolicy Bypass -File tools\register-godot.ps1 -GodotPath "F:\Godot_v4.4-stable_mono_win64\Godot_v4.4-stable_mono_win64"

4. 创建与处理资产

创建多动作角色（如英雄猫）：

powershell -ExecutionPolicy Bypass -File tools\create-action-bundle.ps1 -Root . -AssetId hero-cat -Description "cute orange tabby cat game hero with a blue backpack" -Actions "idle,run,jump,attack,hurt"

处理现有原始图集（Raw Sheets）：

powershell -ExecutionPolicy Bypass -File tools\create-action-bundle.ps1 -Root . -AssetId hero-cat -ProcessExistingRaw

资产 QA 与修复：

powershell -ExecutionPolicy Bypass -File tools\check-asset-qa.ps1 -Root .
powershell -ExecutionPolicy Bypass -File tools\repair-asset-processing.ps1 -Root . -Apply

导入 Godot：

powershell -ExecutionPolicy Bypass -File tools\import-sprite-to-godot.ps1 -Project . -BundleId hero-cat

5. 浏览器预览

powershell -ExecutionPolicy Bypass -File tools\preview-godot-web.ps1 -Project . -CreatePresetIfMissing

它能生成什么？

• 角色与生物：玩家、敌人、NPC、召唤物、怪物，包含 idle/walk/run/jump/attack/hurt/death 等完整动作序列。
• 特效与道具：投射物、打击特效、 muzzle flash、灰尘、魔法特效、动画道具。
• 地图与关卡：分层地图、透明 props、碰撞体、区域触发器、出口、检查点及放置元数据。
• Godot 原生资源：AnimatedSprite2D、SpriteFrames、Sprite2D、StaticBody2D、Area2D、TileMapLayer 等节点的配置文件与场景文件。