《小岛物语》开发过程文档
《小岛物语》(Cozy Island)是一款用 Godot 4.7.2 做的 2D 俯视角慢生活游戏,玩法参考《动物森友会》。玩家只用鼠标操作:在小岛上散步、捡东西、和 6 位动物居民聊天送礼,再把东西卖给商店换铃钱。
这个系列文档记录了这款游戏从调研到出演示视频的完整过程,覆盖策划、美术、技术、音频、测试验收和 AI 协作方式。
想查最初给实现者的要求,读 v1 策划规格
DESIGN.md,每批实现细节和实测数据见IMPLEMENTATION_NOTES.md。本系列讲的是“为什么这么做、过程中遇到了什么”,数据都取自这两份文件和开发记录。
文档目录
想看玩家怎样摇苹果、送礼和卖贝壳,先读演示视频的分镜手记。想看开发中哪里出了岔子,读测试与验收;要顺着每次试玩追后面的修改,读批次开发日志。
| 编号 | 文档 | 内容 |
|---|---|---|
| 01 | 缘起与技术调研 | 需求来源,两轮“用 LLM 做游戏”的调研结论,以及它们怎样决定了本项目的技术路线 |
| 02 | 游戏策划 | 定位、核心循环、操作、世界、居民设定、对话系统、经济、时间与昼夜、验收标准、设计变更 |
| 03 | 美术管线 | AI 文生图、选图、抠图、地面 shader、桥与灯光、界面,以及逐帧走路动画的生成与处理 |
| 04 | 技术架构 | 工程约束、目录、各脚本职责、寻路、角色、对话、存档、数据驱动、命令行模式、工具链 |
| 05 | 音频设计 | 动物语 beep → 居民 TTS 配音 → 四时段 BGM,总线与混音电平 |
| 06 | 测试与验收 | 验收流程、自动化测试、截图模式、变异测试、验收中发现的问题及其根因 |
| 07 | 演示视频 | 自动驾驶导演脚本 + Movie Maker 录制 1 分钟玩法视频 |
| 08 | AI 协作工作流 | 策划/验收方与实现方的分工、任务书写法、Codex 委派与监控、经验教训 |
| 09 | 批次开发日志 | v1 和 A–G 共 8 个批次逐批记录 |
| 10 | 已知问题与后续方向 | 当前限制和可以继续做的方向 |
| 11 | 附录:命令速查 | 运行、测试、截图、素材重建、录视频的命令 |
成果一览
| 项目 | 数据 |
|---|---|
| 引擎 | Godot 4.7.2 stable,GDScript,gl_compatibility 渲染器,1280×720 |
| 地图 | 64×44 格(每格 32 px,即 2048×1408 px),1 条河 2 座桥,70 个场景物件 |
| 居民 | 6 位(5 位村民 + 商店老板),282 条台词条目,每位有自己的 TTS 声音 |
| 美术 | 33 张 AI 生成的静态精灵 + 7 个角色共 35 张逐帧走路图 |
| 音频 | 282 条离线语音(约 1082 秒,7.9 MB)+ 4 首时段 BGM(约 5.6 MB) |
| 代码 | scripts/ 约 2500 行 GDScript/shader;含测试和工具脚本共约 5100 行 |
| 测试 | 单个测试脚本约 1.56 万条断言(音乐曲线按帧采样,数量随帧率浮动),截图模式 29 张 |
| 演示 | 57.4 秒、1920×1080 的玩法视频(用工程中的录制脚本拍摄) |
时间线
全部开发集中在 2026-10-16 15:31 到 10-17 08:04,约 17 个小时(中间有用户休息的空档)。时间取自会话记录,均为 UTC(北京时间 +8 小时)。
| 时间 | 事件 |
|---|---|
| 10-16 15:31 | 调研“用游戏引擎 + LLM 做游戏”的方案,以及有没有游戏专用 LLM |
| 17:08 | 用户提出需求:用 Godot 命令行做一个 2D 版动森 |
| 17:14 | 写策划案 DESIGN.md;用美术工作站上的 ComfyUI批量生成素材并选图 |
| 17:21 | v1 整包交给 Codex 实现(约 42 分钟) |
| 约 18:03 | v1 完成,我验收,发现一批视觉问题 |
| 18:05–18:48 | 用户要求拆小批次。Batch A(抠图/灯光)、B(地图/地面/桥)、C(栏杆/界面/音效导出)逐批派发、逐批验收 |
| 18:49 | v1 阶段交付 |
| 10-17 01:49 | 用户要求走路时四肢动作更逼真 → 比较 3 种模型 → 选定 FLUX.2 klein |
| 03:11 | Batch D(逐帧走路)验收通过 |
| 03:59 | 用户要求给居民配 TTS 声音、加背景音乐 → Batch E(语音)、E-fix、F(BGM)、F-fix |
| 05:38 | 发布 BGM 试听挑选页(MIDI 版 vs ACE-Step AI 版) |
| 05:43 | 用户试听后,四个时段全部选 MIDI 版 |
| 07:36 | 用户要一段不超过 1 分钟的玩法视频;Codex 额度用完,由我自己实现 Batch G |
| 08:04 | 演示视频完成 |
分工
- 用户(制作人):提需求、定方向、在关键选择上拍板(拆小批次、选 klein、BGM 全选 MIDI)。
- Claude(策划 / 美术总监 / 验收):调研、写规格、生成和挑选素材、写每批任务书、跑测试、亲眼看截图、读 diff、把问题写进下一批。Codex 额度用完后,Batch G 由 Claude 自己实现。
- Codex(实现):通过
codex-delegate在同一个会话里按批次实现,交付代码、测试和实现说明。
详见08 AI 协作工作流。
开发时的工程目录
这里提供的是开发文档。下面列出文中提到的工程文件,方便对照当时的分工。
DESIGN.md 策划规格(v1)
IMPLEMENTATION_NOTES.md 各批实现与实测记录
docs/dev-process/ 本系列开发手记
project.godot 引擎配置
scenes/main.tscn 很薄的入口场景,世界由代码搭
scripts/ 游戏逻辑(world / actor / interface / voice / music ...)
data/ 地图、居民台词、物品、语音参数、曲目配置(JSON)
assets/ 精灵、走路帧、地面距离场、字体、语音、音乐
tools/ 素材生成、抠图、作曲、配音、录像等离线脚本
tests/run_tests.gd 自动化测试
_raw/ 素材原图选定记录、检查图、MIDI 源说明:开发期间每批验收后只做
git add暂存作为基线,没有提交。全部批次完成后,才按制作人的要求做了第一次提交。原始生成图、走路候选图、TTS 缓存等被.gitignore排除的文件不在仓库里,见10 已知问题与后续方向。
本文写作中使用了 AI 辅助。文字采用 CC BY-NC-SA 4.0 许可。
最后更新于