Pirate 3D — Three.js + Capacitor iOS 游戏模板

Pirate 3D — Three.js + Capacitor iOS 游戏模板

这是一个面向 AI 编程代理的参考模板仓库，配套 YouTube 教程《How I Vibe Code 3D Games With AI》。它不包含可运行的 App 代码，而是提供 Agent Skills、AI 提示词 和 动画元数据 JSON，帮助开发者用 Claude Code 或 Codex CLI 快速构建 Three.js 3D 移动游戏并集成到 iOS。

核心内容

1. Agent Skills

将技能文件夹复制到你的项目中，即可为 AI 编程代理提供上下文：

• Three.js Builder（.claude/skills/threejs-builder/ 或 .codex/skills/threejs-builder/）：覆盖场景搭建、GLTF/GLB 加载、动画混合、着色器、后处理，以及状态机、视差等游戏模式。
• Capacitor iOS（.codex/skills/threejs-capacitor-ios/）：覆盖 Capacitor 原生同步、SPM 与 CocoaPods 选择、常见 iOS 坑点，以及动画索引元数据模式。

2. AI 提示词

prompts/ 文件夹包含视频中的分步提示词：

1. 01-character-creation.txt — Gemini 3D 角色生成（T-pose GLB）
2. 02-level-creation.txt — 2.5D 预渲染背景图创建
3. 03-character-voice.txt — 语音人设定义
4. 04-animate-bg.txt — 循环背景动画提示
5. 05-asset-json.txt — 从 GLB 模型片段生成 assets_index.json
6. 06-threejs-scene.txt — 带轨道控制和触摸输入的 Three.js 查看器场景

3. 动画索引

public/assets/assets_index.json 定义了两个角色（海盗与酒保）的动画元数据契约。每个条目将友好动作名（idle、walk、run、talk）映射到 GLB 内的实际片段名，并包含时长、循环模式和默认状态。仓库不包含 GLB 文件，但 JSON 展示了预期结构，方便你接入自己的模型。

项目结构

.claude/skills/         # Claude Code agent skills
.codex/skills/          # Codex CLI agent skills
public/
  assets/
    assets_index.json   # 动画元数据（片段名、时长、循环模式）
prompts/
  01-character-creation.txt
  02-level-creation.txt
  03-character-voice.txt
  04-animate-bg.txt
  05-asset-json.txt
  06-threejs-scene.txt
docs/
  preview.gif           # 演示录屏
  preview-02.gif

适用人群

适合已具备 Three.js 和 iOS 开发基础，希望借助 AI 编程代理加速 3D 移动游戏原型开发的开发者。如果你正在探索「Vibe Coding」工作流，这个仓库提供了可复用的技能模板和提示词参考。