《Godot 4.6 游戏开发实战：从零打造国风酿酒战斗游戏〈酒魂〉》目录

第一部分：认知与准备（第1-3章）

定位： 动手之前，先建立正确认知。读完这部分，你清楚"我要做什么"和"我该怎么做"。

第1章　从零开始：破除迷茫，建立认知

解决什么问题： 把"我也想做游戏"的冲动变成可执行的起点。

• 1.1 游戏开发到底难不难？
• 1.2 你需要什么基础？（诚实自测）
• 1.3 学习路径规划
• 1.4 为什么选择Godot？
• 1.5 工具箱安装（Godot 4.6 + Git + Gitee）
• 1.6 验证安装：第一个"Hello, 酒魂"
• 1.7 《酒魂》的素材准备清单（瓦片 / 帧动画 / 字体 / 音频 / BGM，含 CC0 来源与版权速查）
• 1.8 配套源码仓库与每章 diff 摘要说明（Tag 对照法）
• 1.9 本章小结

第2章　方法论：高效学习与调试

• 2.1 「完成」比「完美」更重要——独立开发者的生存法则
• 2.2 如何看懂代码示例——从「被动阅读」到「主动学习」
• 2.3 新手调试五步法——把 Bug 变成成长的机会
• 2.4 社区资源与求助指南——你不是一个人在战斗
• 2.5 本章小结

第3章　《酒魂》的五维设计蓝图

解决什么问题： 在动手写代码之前，把《酒魂》的设计想清楚——避免做到一半发现"不好玩"。

• 3.1 游戏的五个维度：数据、规则、设定、剧情、体验
• 3.2 《酒魂》完整设计总览（附GDD核心内容）
• 3.3 从设计到代码：翻译的艺术
• 3.4 从设计到代码：一个完整的翻译案例（醉意值→攻击力）
• 3.5 三条设计法则：有意义的选择、可读性优先、失败也要有趣
• 3.6 本章小结：《酒魂》的设计蓝图

第二部分：项目骨架与数据驱动（第4-7章）

定位： 搭起工程、规划场景树、用数据驱动打底。读完这部分，你的项目骨架 + 全局数据管理器已经就位，后续系统直接挂上去即可。

第4章　创建《酒魂》项目与场景结构

解决什么问题： 把《酒魂》的工程搭起来，规划好场景树，避免写到后面推倒重来。

• 4.1 创建项目，规划文件夹结构
• 4.2 《酒魂》的场景树设计：主场景 → 战斗场景 → 酒坊场景 → UI层
• 4.3 节点与场景的核心概念（用《酒魂》的节点举例）
• 4.4 动手： 创建项目根场景，配置自动加载脚本
• 4.5 本章产出：《酒魂》的项目骨架
• 4.6 新增 GDScript 风格指南（命名/缩进/注释，全书执行）
• 4.7 新增 数据驱动基础：JSON / ConfigFile / Resource 选型
• 4.8 新增 DataManager 单例：把所有配置集中加载（参见附录A.6）
• 4.9 本章产出（含数据驱动完成度：5%）

第5章　让主角动起来：玩家角色创建

解决什么问题： 创建《酒魂》的主角，让她能在江南小镇上走路。

• 5.1 给主角一个"身体"：CharacterBody2D
• 5.2 添加动画：先从待机开始（八方向待机帧）
• 5.3 添加行走动画和移动控制（输入映射、_physics_process、向量与弧度）
• 5.4 动手： 让主角在场景中能走
• 5.5 本章产出：《酒魂》的可控主角（完成度：10%）

第6章　画出江南小镇：TileMap地图与摄像机

解决什么问题： 为《酒魂》绘制第一张地图，让摄像机跟随主角，并解决多地图叠加的内存问题与深度遮挡 BUG。

• 6.1 重构主场景 main.tscn（全局永久根场景）
• 6.2 创建独立关卡目录与小镇关卡场景
• 6.3 瓦片地图核心原理与分层设计规范（TileSet / TileMapLayer / 物理分层）
• 6.4 国风瓦片素材导入与 TileSet 标准化制作
• 6.5 town.tscn 江南小镇分层绘制流程
• 6.6 Camera2D 平滑跟随摄像机（带地图边界锁定）
• 6.7 GameManager 全局管理器：关卡动态加载与内存释放
• 6.8 运行验收清单与常见故障排查
• 6.9 地图预留交互点位（适配后续全章节开发）
• 6.10 修复 2D 场景深度遮挡 BUG（Y-Sort 动态排序）
• 6.11 修复遮挡轮廓残影问题（改为可选：Shader 残影修复，独立 2D RPG 不一定需要，标注为"进阶-跳过不影响主线"）
• 6.12 本章产出与知识小结（完成度：15%）

第7章　投壶战斗：蓄力、抛物线、命中判定

解决什么问题： 实现《酒魂》的核心战斗玩法——投壶。

• 7.1 投壶玩法设计（核心理念 + 四大核心机制）
• 7.2 全局醉意值与走位输入
• 7.3 搭建投壶战斗场景（实体 → UI → 逻辑三阶段，详见 7.3.1-7.3.9）
• 7.4 集成到主游戏（触发区域 + BattleArena）
• 7.5 本章总结（交付物 + 知识点 + 玩法设计心得）
• 7.6 本章产出：《酒魂》的可玩战斗原型（完成度：25%）
• 7.7 下一章预告与延伸阅读

第三部分：酒魂的战斗系统（第8-12章）

定位： 投壶 → 动作战斗 → 敌人 → 醉意 → 大招。读完这部分，你有一个完整的战斗原型——能打、能放技能、有敌人。

第8章　战斗升级：状态机与攻击动画

解决什么问题： 把投壶升级为动作战斗——主角可以近战攻击，有不同状态。

• 8.1 为什么需要状态机？——待机/移动/攻击/受击/死亡
• 8.2 用枚举+match实现简单状态机（含 take_damage 与调试键 H，参见附录A.7）
• 8.3 攻击判定：Hitbox/Hurtbox 体系（阵营免伤 + 同挥击去重）
• 8.4 AnimationTree 进阶：用混合空间控制动画（可选升级）
• 8.5 动手： 完成主角的战斗状态机（投壶收编为远程技能）
• 8.6 本章产出：有状态切换、有攻击动画的主角（完成度：30%）
• 8.7 下一章预告与延伸阅读

第9章　敌人AI：会追逐、会攻击的对手

解决什么问题： 为《酒魂》添加敌人——让战斗有对手。

• 9.1 敌人基类设计（生命、攻击、死亡特效）
• 9.2 有限状态机实现AI：待机→追逐→攻击（参见附录A.7）
• 9.3 NavigationAgent2D：敌人自动寻路
• 9.4 感知系统：视野锥与听觉信号
• 9.5 动手： 完成近战敌人和远程敌人
• 9.6 本章产出：《酒魂》的AI敌人系统（完成度：40%）

第10章　醉意值系统：《酒魂》的核心特色

解决什么问题： 实现《酒魂》最具特色的机制——喝酒影响战斗。

• 10.1 醉意值设计：范围0~1、增减规则、4个阶段
• 10.2 醉意对战斗属性的影响（攻击力加成、移动速度惩罚、打滑效果，参见附录A.1 策略模式）
• 10.3 醉意阶段变化的视觉反馈
• 10.4 动手： 完成醉意值与战斗属性的联动
• 10.5 本章产出：喝酒影响战斗的醉意系统（完成度：45%）

第11章　酒魂技与特效：大招的爽感

解决什么问题： 实现《酒魂》的大招系统——醉意够了就能放酷炫技能。

• 11.1 酒魂技：醉意≥阈值时解锁
• 11.2 工厂模式：根据当前酒品生成不同技能（参见附录A.2）
• 11.3 屏幕震动 + GPUParticles2D特效
• 11.4 诗号系统：大招触发时浮现诗词
• 11.5 动手： 完成3种酒魂技
• 11.6 本章产出：《酒魂》的必杀技系统（完成度：55%）

第12章　战斗UI：血条、醉意条、技能图标

解决什么问题： 让玩家能看到自己的状态。

• 12.1 Control节点体系：Panel、ProgressBar、TextureRect
• 12.2 用信号更新UI（醉意变化 → 醉意条更新）
• 12.3 技能冷却遮罩（TextureProgressBar）
• 12.4 新增 伤害飘字与暴击特效
• 12.5 动手： 完成战斗界面的所有UI
• 12.6 本章产出：《酒魂》的战斗HUD（完成度：60%）

第四部分：酒魂的UI基础（第13-14章）

定位： 把通用的 UI 技术集中讲清楚。后续业务章节（酿造/对话/商店）直接复用本章的组件，不重复造轮子。

第13章　UI基础：CanvasLayer、控件、信号与动画（原13章改造）

解决什么问题： 把 Control、CanvasLayer、信号通信、UI 动效这些通用技术一次讲清，让酿造/对话/背包/商店都能复用。

• 13.1 CanvasLayer：UI与游戏世界分离
• 13.2 Control 节点的锚点与边距
• 13.3 Theme 与 StyleBox：让 UI 有国风质感
• 13.4 信号驱动 UI 更新
• 13.5 Tween 与 AnimationPlayer：UI 动效
• 13.6 新增 弹窗、Toast、对话框三种复用模式
• 13.7 动手： 搭建通用 UI 框架
• 13.8 本章产出

第14章　背包与物品格子（原14章改造）

解决什么问题： 背包是酿造、商店、任务奖励的共用 UI。提前做扎实，后面不返工。

• 14.1 背包数据结构（参见附录A.6 单例模式）
• 14.2 GridContainer + ItemSlot 网格布局
• 14.3 拖拽交换物品（Drag & Drop）
• 14.4 物品 Tooltip
• 14.5 动手： 完成背包界面
• 14.6 本章产出（对话气泡 UI 与业务整体下移到第19章）

第五部分：酒魂的酿造系统（第15-17章）

定位： 《酒魂》的特色玩法——做一坛有灵魂的酒。

第15章　配方系统与材料选择

解决什么问题： 让玩家选择配方、添加材料，准备酿造。配方 UI 完全在本章做（与原第13章解耦）。

• 15.1 配方数据结构（JSON/Resource，加载自第4章 DataManager）
• 15.2 配方选择界面与加载逻辑
• 15.3 材料槽位：点击→弹出背包（第14章复用）→选择→填入
• 15.4 动手： 完成配方选择与材料添加
• 15.5 本章产出：可交互的配方与材料系统（完成度：65%）

第16章　品质计算与随机词缀

解决什么问题： 每坛酒的品质不同，有随机属性，让酿造有惊喜。

• 16.1 四种酿造工艺（策略模式，参见附录A.1）
• 16.2 品质计算公式：基础品质 + 材料加成 + 工艺匹配度
• 16.3 品质分级：F~S级
• 16.4 随机词缀生成（工厂模式 + 组合模式，参见附录A.2 / A.3）
• 16.5 动手： 完成品质计算与词缀生成
• 16.6 本章产出：独一无二的酒品生成系统（完成度：70%）

第17章　陈化系统与意外产物

解决什么问题： 酒需要时间陈化，失败也可能有惊喜。

• 17.1 君臣佐使配伍规则（组合模式，参见附录A.3）
• 17.2 陈化系统：Timer 驱动的品质演化（观察者模式，参见附录A.4）
• 17.3 失败变体：酿造失败可能产出特殊酒品
• 17.4 动手： 完成完整的酿造→陈化流程
• 17.5 本章产出：《酒魂》的完整酿造系统（完成度：75%）

第六部分：酒魂的剧情与人际（第18-21章）

定位： 让《酒魂》的世界有故事——NPC、对话、任务、存档。

第18章　古人交互：与李白对饮

解决什么问题： 实现《酒魂》的历史人物交互系统。

• 18.1 古人数据结构与好感度
• 18.2 赠酒增加好感度
• 18.3 对饮小游戏（拼酒QTE / 诗词接龙）
• 18.4 好感度解锁新对话、新配方
• 18.5 动手： 完成与李白的完整交互
• 18.6 本章产出：可对话、可赠酒、有好感度的NPC（完成度：80%）

第19章　对话树系统（吸收原14.3对话气泡业务）

解决什么问题： 让NPC的对话有分支、有条件、有深度。对话气泡 UI 与对话树业务统一在本章实现。

• 19.1 对话气泡 UI（继承第13章的 CanvasLayer + Tween）
• 19.2 对话树的数据结构（组合模式，参见附录A.3）
• 19.3 用JSON配置对话：文本、选项、条件、跳转
• 19.4 对话系统的代码实现
• 19.5 动手： 完成杜甫的对话树
• 19.6 本章产出：《酒魂》的对话树系统（完成度：83%）

第20章　任务系统：主线与支线

解决什么问题： 给玩家目标——酿出某款酒、击败某个敌人、与某人对话。

• 20.1 任务数据结构与任务类型
• 20.2 命令模式：封装任务目标检测（参见附录A.5）
• 20.3 任务管理器与事件监听
• 20.4 任务奖励与任务链
• 20.5 动手： 完成"找回失传酒谱"任务链
• 20.6 本章产出：《酒魂》的任务系统（完成度：86%）

第21章　存档系统：保存你的酒坊（原22章前移）

解决什么问题： 玩家下次打开游戏，还能继续经营酒坊。前面所有系统必须可序列化。

• 21.1 新增 存档接口规范：每个系统预留 to_dict() / from_dict()（参见第5/14/18/20章）
• 21.2 存档内容设计：玩家属性、背包、酒坊等级、好感度、任务进度
• 21.3 多存档位实现（SQLite / ConfigFile）
• 21.4 自动存档与手动存档
• 21.5 动手： 完成《酒魂》的存档/读档
• 21.6 本章产出：进度不丢失的《酒魂》（完成度：88%）

第七部分：酒魂的酒坊经营（第22-24章）

定位： 把酒魂的核心循环跑通——酿造 → 卖酒 → 升级 → 新内容。这是闭环验证的关键三章。

第22章　货币系统：铜钱与功德（原23章前半拆出）

解决什么问题： 把虚拟经济的基础打通，所有"花钱/赚钱"的逻辑都依赖它。

• 22.1 货币类型：铜钱（主要）+ 功德值（隐藏）
• 22.2 货币获取：卖酒 / 完成任务 / 对饮获胜
• 22.3 货币消耗：买材料 / 升级设备 / 赠礼
• 22.4 新增 商店系统雏形：基于第13章通用 UI 框架的快速搭建
• 22.5 动手： 完成货币系统 + 商店雏形
• 22.6 本章产出：经济基础（完成度：90%）

第23章　酒坊等级与设备升级（原23章中段拆出）

解决什么问题： 让玩家有目标地升级酒坊，感受到"越做越大"。

• 23.1 酒坊等级设计（1~5级）
• 23.2 升级条件：铜钱 + 特定酒品 + 功德值
• 23.3 新增 设备系统：窖池、蒸馏器、酒曲房（每级解锁）
• 23.4 升级解锁：新配方、新设备、新NPC
• 23.5 动手： 完成酒坊升级系统
• 23.6 本章产出：经营内容层（完成度：93%）

第24章　经济循环与闭环验证（原23章后半 + 新增验证章）

解决什么问题： 验证游戏能完整跑起来——从新游戏一路玩到 5 级酒坊。

• 24.1 经济循环：卖酒 → 得钱 → 买材料 → 酿酒 → 卖更好的酒
• 24.2 内容解锁节奏：等级 / 好感度 / 任务三维门控
• 24.3 新增 闭环验证清单：从新游戏到 5 级酒坊的完整路径（10 个里程碑）
• 24.4 新增 调试工具：上帝模式与变量监视（debug 快捷键）
• 24.5 动手： 跑一遍完整闭环
• 24.6 本章产出：《酒魂》完整可玩（完成度：100%）

第八部分：优化与发布（第25-27章）

定位： 项目收尾——让《酒魂》跑得顺、发得出去、被玩到。

第25章　性能优化：让酒魂不卡顿（原24章）

• 25.1 性能分析工具（Godot Profiler）
• 25.2 对象池优化（箭矢、特效复用）
• 25.3 资源加载优化（预加载 vs 异步）
• 25.4 渲染优化（图集、合批）
• 25.5 动手： 优化《酒魂》的战斗性能
• 25.6 本章产出：流畅运行的《酒魂》

第26章　多平台打包：发布你的游戏（原25章）

• 26.1 导出模板配置
• 26.2 Windows/Linux/macOS打包
• 26.3 Android APK打包
• 26.4 平台差异处理
• 26.5 动手： 导出《酒魂》的Windows版本
• 26.6 本章产出：《酒魂》的可执行文件

第27章　社区发布：让《酒魂》被玩到（原26章改造）

解决什么问题： 把做好的游戏真正发出去。热更新对独立 2D 小游戏性价比极低，改为社区发布更实用。

• 27.1 独立游戏发行渠道对比（itch.io / Steam / B站 / 抖音 / 微信小游戏）
• 27.2 itch.io 发布完整流程（页面/截图/视频/定价）
• 27.3 B站 / 抖音 游戏发行与视频化运营
• 27.4 微信小游戏适配要点
• 27.5 玩家反馈收集与持续更新
• 27.6 本章产出：《酒魂》的发布与玩家反馈

附录

设计原则： 附录集中讲通用知识，章节正文只讲"在《酒魂》里怎么用"，避免重复。

• 附录A　设计模式实战手册（集中讲，章节内不再重复）
  • A.1 策略模式：第10章 10.2、第16章 16.1
  • A.2 工厂模式：第11章 11.2、第16章 16.4
  • A.3 组合模式：第16章 16.4、第17章 17.1、第19章 19.2
  • A.4 观察者模式：第17章 17.2
  • A.5 命令模式：第20章 20.2
  • A.6 单例模式：第4章 4.8、第14章 14.1、第22章 22.1
  • A.7 状态机模式：第8章 8.2、第9章 9.2
• 附录B　《酒魂》素材清单与版权（瓦片/帧动画/字体/音频/BGM，含 CC0 来源）
• 附录C　《酒魂》踩坑大全（性能/碰撞/UI/动画/存档五类，按问题汇总）
• 附录D　仓库地址与每章 diff 摘要（GitHub 仓库 + 各章代码 diff 索引 + FAQ）
• 附录E　《酒魂》完整 GDD（含所有数据结构、数值表）
• 附录F　GDScript API 速查表
• 附录G　向 AI 高效提问指南

目录结构总览（v2.0）

完成度里程碑： 完成第12章 = 60%（战斗可玩），完成第17章 = 75%（酿造可玩），完成第21章 = 88%（剧情可玩），完成第24章 = 100%（闭环可玩）。