跳至内容
《小岛物语》开发过程文档

《小岛物语》开发过程文档

所属专题:小岛物语 · Godot 游戏开发

《小岛物语》(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 分钟玩法视频
08AI 协作工作流策划/验收方与实现方的分工、任务书写法、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:21v1 整包交给 Codex 实现(约 42 分钟)
约 18:03v1 完成,我验收,发现一批视觉问题
18:05–18:48用户要求拆小批次。Batch A(抠图/灯光)、B(地图/地面/桥)、C(栏杆/界面/音效导出)逐批派发、逐批验收
18:49v1 阶段交付
10-17 01:49用户要求走路时四肢动作更逼真 → 比较 3 种模型 → 选定 FLUX.2 klein
03:11Batch 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 许可。

最后更新于