吴晓波的个人网站

吴晓波的个人网站

烟雨西塘 嘉桐快跑-基于Codex的游戏开发日记

“烟雨西塘 嘉桐快跑”游戏终于开发完毕了。新版本预览图如下:

项目从2026.06.10开始构思并输入了第一个提示词,到2026.06.14打包成Windows平台的exe文件完成最终封装,至此,为期4天的Codex编程体验告一段落。6月11日,网站上线了第一版的游戏(game.5xiaobo.com),那一版界面还是非常粗糙的,只能说仅能玩。

那一版没有灵宠(宠物系统),没有在线商城,没有通关结算画面,更没有彩蛋。后来的几天,跟女儿一起进行了头脑风暴,才添加了这些。

整个开发过程中,Codex给我带来了很大的便利,我就使用过程中的体会给大家进行分享。

首先第一个就是如果能用Chat GPT 5.5的,一定要用这个模型。虽然我起初是用了CC Switch接入Deepseek V4 Pro的API接口来进行调用。

但是有一说一,这货有时候能听懂你在说什么,有时候又会胡言乱语。所以后来我忍无可忍,接入了ChatGPT 5.5。果然ChatGPT 5.5一用,它就能非常清楚得理解我的提示词,准确性大大提高。而且还有一个核心的点,ChatGPT 5.5可以在输入框输入“/image gen”来调用画图Skill,这个是Deepseek无法比拟的。我游戏中的很多图片都是用这个技能生成的。此外,大家可以看到左侧的项目对话栏,我做了一个角色的分工,因为额度有限,我需要针对不同的工作内容设置不同的推理模式;此外,为了节省时间,我会让这几个角色同时开始工作(不同领域)。

但是“image gen”这个技能有时候对图片上添加中文字好像很不友好,按理说背后应该是image2技术,不至于那么拉跨。所以我后来对不满意的图片还是直接在ChatGPT的网页版让image2来直接生成了,网页版的图片生成真的是王炸,非常震撼。

特别介绍一下最终版的三个有趣点:

第一个是:灵宠(宠物),可以在商城里面进行购买,总共6种动物,地上跑的三种,天上飞的三种。并且给每种动物都做了4帧动画,使其在游戏界面中动起来。

第二个是:换装(皮肤)可以在商城里面进行购买,总共9套服装,普通款4套;豪华款4套;隐藏款1套(彩蛋)。

第三个是:彩蛋,女儿觉得光玩这个游戏也蛮无聊的,需要有意外的惊喜,所以想要在里面设计几个彩蛋。

所以我们就放了四个彩蛋:

第一个就是游戏过程中,在键盘上输入wuxiaobo,即可自动赠送520个铜币,可以用于在商城中购物。

第二个就是游戏过程中,在键盘上输入jiatong,即可解锁隐藏款皮肤,这套皮肤非常奢华,如下图所示。如果第一套是邻家女孩型(朴素)的,那么这套就是大家闺秀型(精致)的。当然,如果你想换回原来的皮肤,也可以在键盘上输入xitang就可以了。

第三个就是如果你觉得这款游戏太难了(因为这款游戏的初始用户是小学二年级学生),还可以在右下角的开发者板块中,找到“一键通关”就可以直接进入通关界面了,此时你就可以在通关界面阅读西塘这6个著名景点的详细介绍了(也就是游戏中对应的6个场景)。

最后,由于游戏使用了很多精美的图片,导致整个网站文件夹非常大,如果发布成在线版,打开会很卡,使用体验会很差。所以,第一版大家可以在线玩(网址:http://game.5xiaobo.com 其实第一版也已经很卡了),而最终版则是打包成了exe文件,供大家下载体验。

下载下来的.exe文件直接双击打开即可玩了。下载地址:http://img.5xiaobo.com/soft/jiatong-run.exe

好了,大致是情况就是这样,下面的内容是我整个游戏的开发日志(游戏说明书),大家有兴趣的可以耐心阅读。

----------------------------------------

# 《烟雨西塘:嘉桐快跑》游戏介绍

整理日期:2026-06-13


## 一、游戏基本信息

《烟雨西塘:嘉桐快跑》是一款以嘉善西塘古镇为主题的横版 2D/2.5D 古风跑酷游戏。玩家操控汉服少女“嘉桐”,在烟雨长廊、石皮弄、三桥水影、西街与塘东街、西园与醉园、夜游水巷等西塘代表性场景中奔跑、跳跃、滑铲、冲刺,收集铜板和西塘小吃,解锁人文历史知识卡。 游戏设计:吴嘉桐 游戏开发:吴晓波 开发工具:Codex + ChatGPT 5.5 + DeepSeek V4 开发时间:2026.06.10 - 2026.06.14


## 二、设计初衷

这款游戏最特别的地方,不只是“做了一个跑酷游戏”,而是它来自一次亲子共创。 最初的想法源于女儿吴嘉桐想要设计一款属于自己的游戏。她负责提出玩法想法和游戏方向,而我负责借助 Codex 把想法一步步开发出来。嘉桐本身又是西塘人,于是游戏的主题很自然地落在了自己的家乡西塘上:希望通过一个孩子也能理解、也愿意反复玩的游戏,让更多人认识西塘的风景、人文、历史、民俗和烟火气。 这款游戏的目标不是把文化内容做成生硬的介绍页,而是把它藏进奔跑、收集、换装、通关、彩蛋和知识卡里。玩家在躲避障碍、收集小吃、解锁汉服和宠物的过程中,会慢慢知道西塘为什么有“桥多、弄多、廊棚多”的特色,也会接触到吴越文化、民俗信仰、汉服文化周、盘扣与纽扣等地方文化线索。 所以,《烟雨西塘:嘉桐快跑》本质上是一款“寓教于乐”的家乡宣传游戏:它用轻松的跑酷玩法承载西塘记忆,用孩子的视角重新讲述家乡。


## 三、核心定位

游戏定位为“古风精细跑酷 + 西塘文化游记 + 亲子共创作品”。 它面向的玩家包括小学生、亲子家庭、西塘本地孩子、游客,以及对江南古镇和国风游戏感兴趣的人。游戏不追求复杂操作门槛,而是让玩家一开始就能跑起来,再通过铜板、道具、知识卡、皮肤、宠物和彩蛋逐渐获得探索感。 画面风格采用江南水乡、国风绘本和横版游戏关卡结合的方向。核心视觉元素包括白墙黛瓦、青石板路、临河廊棚、窄巷光影、石桥倒影、红灯笼、乌篷船、水面反光、雨丝、雾气、小吃摊、园林月洞门和夜游灯影。


## 四、世界与关卡设计

游戏当前采用 6 个主题场景。每关目标距离为 500 米,完成后进入下一关。全部 6 关完成后,进入“烟雨西塘通关纪念”页面。 1. **烟雨长廊** 开局场景,以临河廊棚、檐雨、青石板和右侧水巷为核心意象。这里像是玩家第一次走进西塘,节奏相对友好,适合熟悉跳跃、滑铲和收集。 2. **石皮弄** 以窄巷、高墙、转角和压缩空间为主题。画面更紧凑,强调西塘“弄多”的空间特色,也让玩家感受到古镇里从热闹街市转入幽深小巷的变化。 3. **三桥水影** 结合送子来凤桥、卧龙桥、永宁桥等石桥意象。桥与水影让关卡更有起伏感,跑酷节奏也更偏跳跃和空中路线判断。 4. **西街与塘东街** 这是小吃和街市氛围最浓的场景。灯笼、蒸汽、小摊、铜板和补给出现更频繁,适合做连击、补能量和获得商城资源。 5. **西园与醉园** 从街巷切入江南庭院。月洞门、竹影、池塘、假山和园林平台让关卡气质变得更安静,也更考验精准操作。 6. **夜游水巷** 后期高难度场景,以夜色、灯影、水面反光和短平台为特色。这里的氛围最华丽,也最像一次通关前的古镇夜游。 通关后,“六景游记”会按这 6 个场景生成回顾卡片,让玩家把跑过的路线重新看成一次西塘游览。


## 五、核心玩法

玩家控制嘉桐自动向前奔跑,目标是在有限生命内跑完当前关卡。 **基础操作** - 跳跃 / 二段跳:空格或方向上键 - 滑铲:方向下键 - 冲刺:Shift 或方向右键 - 触屏操作:画面下方提供跳跃、滑铲、冲刺按钮

**核心系统** - 生命系统:初始 5 条命,以莲花生命标识呈现。撞到障碍扣 1 条命,生命耗尽进入游记结算页。 - 里程系统:每关目标 500 米。跑满距离即过关。 - 铜板系统:铜板既是本局收集物,也是持久化货币,可用于购买汉服和灵宠。 - 烟雨能量:收集特定小吃可补充能量,满 100% 后触发“烟雨轻功”。 - 烟雨轻功:短时间提升表现,吸附附近道具,并可化解一次危险。 - 连击系统:连续收集铜板、道具和书页会提高连击,分数倍率最高可叠到 5 倍。 - 游记知识卡:收集 3 张游记书页可解锁 1 张西塘知识卡。


## 六、道具介绍

- **铜板**:主要收集物。每收集 1 枚铜板,本局铜板和钱包余额都会增加。铜板可用于兑换汉服衣装和灵宠伙伴。 - **芡实糕**:西塘小吃补给,增加少量烟雨能量。适合在跑酷节奏中稳定续航。 - **管老太臭豆腐**:触发短时间冲刺效果。冲刺期间可以撞开木箱、小摊等小型可破坏障碍,是兼具补给和攻击感的道具。 - **蝉衣包圆**:获得一次护盾。下一次受伤会被护盾抵消,适合在障碍密集或夜游场景中救急。 - **荷叶粉蒸肉**:大量补充烟雨能量,出现频率相对较低,是冲向“烟雨轻功”的关键补给。 - **莲心护符**:恢复 1 条生命,最高恢复到 5 条。生命满时拾取会提示“生命已满”。 - **游记书页**:知识卡系统的核心收集物。每 3 张书页解锁 1 张完整知识卡,让玩家在跑酷之外获得西塘人文知识。


## 七、障碍与应对方式

游戏中的障碍会根据场景变化组合出现。 - 木箱:地面障碍,可跳过,也可在冲刺状态下撞开。 - 小摊:市街场景常见障碍,可用冲刺撞开。 - 灯笼 / 夜灯笼:高位障碍,适合用滑铲躲避。 - 低廊棚:高位压迫障碍,需要滑铲或选择合适路线。 - 石阶:低位地形障碍,需要提前起跳。 - 岩石:桥与园林场景常见障碍,需要跳过。 - 竹障:园林场景障碍,考验反应和路线判断。 - 月洞门:庭院特色障碍,强化西园与醉园的场景辨识度。 这些障碍让不同场景不只是换背景,而是拥有各自的操作节奏。


## 八、知识卡系统

游戏当前包含 6 张西塘知识卡。未解锁时显示提示,解锁后展示完整内容。 1. **生活着的千年古镇**:强调西塘不是静态布景,而是仍然保留生活气息的江南古镇。 2. **桥多、弄多、廊棚多**:解释桥、弄堂、沿河廊棚如何构成西塘独特的空间节奏。 3. **吴根越角**:介绍西塘位于吴越文化交汇地带,地方文化具有历史层次。 4. **护国随粮王信俗会**:体现地方信仰、巡游仪式和社区共同记忆,提示西塘有活态民俗文化。 5. **西塘汉服文化周**:把传统服饰、古镇街巷和当代旅行体验联系起来,也呼应游戏中的汉服商城。 6. **纽扣与盘扣**:通过服饰细节和手工艺,让玩家理解小小盘扣背后的纹样、结构和审美。


## 九、商城、汉服与灵宠

游戏设置了“西塘商城”,包括“嘉桐衣柜”和“灵宠铺”。铜板不会只停留在分数层面,而会变成可持续积累的养成资源。 ### 汉服衣装 - 烟雨青裙:默认衣装,青绿比甲配粉色飘带。 - 桃夭绛罗:30 铜板,粉绛襦裙、桃花袖缘和柔色飘带。 - 月白云肩:60 铜板,月白蓝裙身、金线云肩和浅色袖面。 - 夜航金纹:90 铜板,深靛衣身与灯影金纹,适合夜游水巷。 - 霓裳流云:150 铜板,豪华衣装,紫霞渐染、珠光云纹和粉色披帛。 - 凤栖金阙:220 铜板,豪华衣装,绛红织金、凤羽袖缘和宫阙金色飘带。 - 星河织锦:320 铜板,豪华衣装,深蓝星纹、银白袖光和银河流苏。 - 龙雀天衣:450 铜板,豪华衣装,玄青织金、孔雀青披帛和鎏金纹样。 ### 灵宠伙伴 - 团团小狗:80 铜板 - 月耳小兔:120 铜板 - 花铃小猫:180 铜板 - 金蜜小蜂:220 铜板 - 流彩蝶灵:260 铜板 - 赤羽小凤:320 铜板 灵宠装备后会跟随嘉桐,并自动吸附附近铜板。小狗、小兔、小猫偏地面跟随,小蜂、小凤、蝶灵带有飞行动作,让跑酷画面更热闹,也提高铜板收集效率。


## 十、隐藏彩蛋

游戏内置了几个键盘暗号和彩蛋机制。 - 输入 `wuxiaobo`:触发“吴晓波彩蛋 +520 铜板”。奖励会同时进入本局铜板和持久化钱包余额,刷新页面后余额仍保留。 - 输入 `jiatong`:解锁并切换到隐藏角色“月华嘉桐”。该角色拥有独立的 4 帧奔跑图和 6 帧动作图,视觉上更接近华丽概念图。 - 输入 `xitang`:恢复并切回默认角色,用于从彩蛋角色回到原始嘉桐形象。 - 开发者面板“一键通关”:页面保留了开发调试入口,可直接预览通关纪念页。它既方便测试,也像一个藏在开发者信息里的幕后按钮。 这些彩蛋让游戏保留了一点“自己家做的游戏”的亲密感:玩家不一定一开始知道,但发现之后会觉得这个作品有个人记忆和小秘密。


## 十一、通关与结算

普通失败时,玩家进入“游记结算页”,查看本局距离、铜板、钱包余额、知识卡数量、最高连击和经过景点。 完成 6 关后,游戏进入“烟雨西塘通关纪念”页面。通关页后来从普通结算表重新设计成宣传海报式界面:西塘主视觉、大标题、古镇介绍、重开按钮和“六景游记”回顾共同构成一次完整的西塘旅行收束。 这使游戏的结尾不只是“你赢了”,而是“你完成了一次西塘游记”。


## 十二、美术与技术实现

当前项目是一个轻量网页游戏,核心文件包括: - `index.html`:页面结构、弹窗、HUD、商城、知识图鉴和开发者信息。 - `styles.css`:整体布局、弹窗、商城、通关页、移动端适配和 UI 风格。 - `game.js`:Canvas 游戏循环、碰撞、关卡、道具、商城、宠物、音效、彩蛋和绘制逻辑。 - `images/`:角色、皮肤、宠物、道具、障碍、背景和 UI 图片。 - `tools/`:用于生成背景、汉服、宠物图集、按钮、通关标题和彩蛋角色的脚本。 - `originals/`:保存原图、源素材和未直接调用的历史素材。 技术上,游戏使用 Canvas 绘制跑酷画面,通过 JavaScript 管理角色物理、障碍生成、道具收集、商店购买、本地存档和键盘暗号。音乐和音效由 Web Audio API 生成,包含开始、跳跃、滑铲、冲刺、收集铜板、获得道具、受伤、破坏障碍、烟雨轻功、通关等反馈。


## 十三、开发历程回顾

根据当前项目文件、生成脚本以及已读取到的相关 Codex 线程提示词,这款游戏大致经历了以下阶段。 1. **教育游戏的原始想法** 最早的提示词是希望开发一个以吴嘉桐为主角、面向小学二年级学生的网页游戏,结合嘉善本地特色,让学生在玩的时候学习嘉善人文和非遗知识。这一阶段奠定了“孩子主角 + 地方文化 + 学习”的底层方向。 2. **推翻旧方案,转向横版跑酷** 早期版本曾被评价为“非常傻,不喜欢”,随后明确改成类似经典横版平台跳跃的跑酷方向。这个转折很关键:游戏从偏展示、偏面板的教育产品,变成了真正以操作体验为核心的横版游戏。 3. **聚焦西塘,形成《烟雨西塘:嘉桐快跑》** 后续提示词明确了古风跑酷定位:主角是可爱的汉服女生嘉桐,主题围绕嘉善西塘旅游展开,地图是西塘水乡街角,跑酷过程中收集西塘特色小吃补能量,并解锁西塘人文历史知识。这个阶段确定了现在游戏最核心的世界观和玩法结构。 4. **设计 6 个西塘主题场景** 进一步提出已有 6 个场景,需要为 AI 生成背景设计提示词。提示词强调横版跑酷、无缝拼接、分层视差、前景保留跑道、不出现文字和 UI。这直接推动了烟雨长廊、石皮弄、水乡石桥、小吃街、古典庭院、夜游西塘等场景的视觉方向。 5. **网页版核心实现** 项目落地为 HTML + CSS + Canvas 的网页游戏,实现了生命、能量、铜板、连击、关卡距离、场景切换、障碍生成、小吃补给、知识卡、结算页和通关页。后续又不断调整主角大小、弹窗比例、按钮位置和移动端适配,让它更像可玩的完整游戏。 6. **商城与养成系统** 游戏加入了西塘商城、汉服衣柜和灵宠铺。普通汉服、豪华汉服、宠物吸币和持久化钱包,让跑酷收集有了长期目标。还要求豪华汉服不只是商城预览图,而是购买后要同步到游戏实际角色贴图,这推动了角色跑步帧和动作帧的完整生成。 7. **UI 视觉持续打磨** 陆续提出标题图替换、商城按钮重做、下一关和进入商城按钮重绘、通关标题图统一无衬字体、通关页改成大气宣传海报等要求。游戏因此从“功能能用”逐渐变成“视觉统一、主题完整”的作品。 8. **隐藏彩蛋加入** 先询问可以加入哪些彩蛋,随后指定了 `wuxiaobo` 暗号奖励 520 铜板。后来又加入 `jiatong` 解锁隐藏角色“月华嘉桐”,以及 `xitang` 切回默认角色。彩蛋系统让游戏有了更强的个人印记。 9. **整理素材与收束项目** 后期开始清理根目录文件,把未使用图片迁入 `originals/`,并扩写“六景游记”的景点文案。项目从单次实验逐渐整理成一个可展示、可维护、可继续扩展的作品。


## 十四、提示词脉络归纳

从已经读取到的相关提示词来看,设计思路并不是一次写完的,而是一步步变清楚的。 最初方向: > 主角是吴嘉桐,面向小学二年级学生,结合嘉善本地特色,学习人文知识和非遗知识。 调整玩法: > 喜欢类似超级玛丽的跑酷风格,需要全部推翻重新设计。 确定主题: > 横版古风跑酷、画面精细、主角是可爱女生、主题围绕嘉善西塘旅游、跑酷地图是西塘水乡街角、吃西塘小吃补能量、解锁人文历史知识、5 条命结束。 视觉要求: > 横版 2D/2.5D、精细国风绘本、多层视差、青石板、白墙黛瓦、河面倒影、雨丝、灯笼、乌篷船、左右可无缝拼接、不要文字、不要 UI、不要角色。 后期打磨: > 人物尺寸再大一点、标题字换成图片、豪华汉服要重新设计并同步游戏贴图、商城按钮要和右侧图标统一、通关页不要像结算表,要像宣传海报、输入暗号触发彩蛋、输入 xitang 切回默认角色。 这条提示词变化线非常清楚:从教育目标,到玩法方向,到西塘主题,到美术资产,再到商城、彩蛋和通关包装。它也是这款游戏真正的开发历程。


## 十五、后续可扩展方向

这款游戏还可以继续扩展(当然,后期也不再更新了): - 增加“无伤过关”称号,例如“嘉桐踏雨无痕”。 - 给每个场景加入一张专属隐藏知识卡。 - 夜游水巷中加入灯谜书页或汉服限定彩蛋。 - 增加更多西塘小吃,例如粽子、熏青豆、小馄饨等。 - 加入亲子模式或课堂模式,让老师可以直接展示知识卡。 - 增加成就系统,例如“收集 100 枚铜板”“解锁全部汉服”“带灵宠跑完夜游水巷”。 - 制作正式 README、发布页和 Windows 打包版本,方便传播给更多人试玩。


## 十六、总结

《烟雨西塘:嘉桐快跑》是一款从孩子想象力出发,由家长借助 Codex 实现的家乡主题游戏。它把西塘的桥、弄、廊棚、小吃、汉服、民俗、园林和夜游风景,转化成可以奔跑、可以收集、可以解锁、可以发现彩蛋的互动体验。它既是一款小游戏,也是一份家乡介绍;既是一次技术实践,也是一段父女共创的记录。

2026-06-14 0 /
分类:人文知识
/

评论回复 · 倒序排列

回到顶部