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

版本： v3.0（工作版，全书写作以此为准） 结构： 8 部分 · 27 章 · 附录 A–G 主线： 认知准备 → 项目骨架 → UI 基础 → 战斗系统 → 酿造系统 → 剧情人际 → 酒坊经营 → 优化发布

第一部分：认知与准备（第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-8章）

定位： 搭工程、立规范、铺数据层。读完这部分，你的项目骨架 + 全局数据管理器 + 角色 + 地图 + 第一个可玩原型全部就位，后续系统直接挂上去即可。

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

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

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

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

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

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

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

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

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

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

解决什么问题： 实现《酒魂》的第一个可玩玩法——投壶。这是战斗系统的降维实现：目标静止、玩家位置固定，但"瞄准 → 蓄力 → 发射 → 命中判定"这条链路与后续动作战斗共用同一套 Hitbox 与 EventBus。

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

第8章　状态机与攻击动画：从投壶到动作战斗

解决什么问题： 把投壶升级为动作战斗——主角可以近战攻击，有不同状态。投壶在此收编为远程技能，两套玩法出自同一套战斗内核。

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

第三部分：UI 基础（第9-10章）

定位： 把通用的 UI 技术集中讲清楚，且必须放在战斗 UI 之前——后续业务章节（战斗 HUD / 酿造 / 对话 / 商店）全部复用本章的组件，不再重复造轮子。

第9章　UI 基础：CanvasLayer、控件、信号与动效

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

• 9.1 CanvasLayer：UI 与游戏世界分离
• 9.2 Control 节点的锚点与边距
• 9.3 Theme 与 StyleBox：让 UI 有国风质感
• 9.4 信号驱动 UI 更新
• 9.5 Tween 与 AnimationPlayer：UI 动效
• 9.6 三种复用模式：弹窗、Toast、对话框
• 9.7 动手： 搭建通用 UI 框架
• 9.8 本章产出：《酒魂》的通用 UI 框架（完成度：35%）

第10章　背包与物品格子

解决什么问题： 背包是酿造、商店、任务奖励的共用 UI。趁通用框架刚做好，一鼓作气做扎实，后面不返工。

• 10.1 背包数据结构（沿用第4章 DataManager 的 Autoload 模式，参见附录 A.6）
• 10.2 GridContainer + ItemSlot 网格布局
• 10.3 拖拽交换物品（Drag & Drop）
• 10.4 物品 Tooltip
• 10.5 背包的序列化接口：to_dict() / from_dict()
• 10.6 动手： 完成背包界面
• 10.7 本章产出：《酒魂》的背包系统（完成度：40%）

第四部分：战斗系统（第11-14章）

定位： 敌人 → 醉意 → 大招 → 战斗 HUD。读完这部分，你有一个完整的战斗系统——能打、能放技能、有敌人、看得见状态。

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

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

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

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

解决什么问题： 实现《酒魂》最具特色的机制——喝酒影响战斗。醉意值在此从"投壶的一个数值"升级为贯穿战斗的核心状态。

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

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

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

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

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

解决什么问题： 让玩家能看到自己的状态。本章直接复用第9章的通用 UI 框架与第10章的 ItemSlot，只写战斗专属的部分。

• 14.1 战斗 HUD 布局（基于第9章 CanvasLayer 框架）
• 14.2 用信号更新 UI（醉意变化 → 醉意条更新）
• 14.3 技能冷却遮罩（TextureProgressBar）
• 14.4 伤害飘字与暴击特效
• 14.5 动手： 完成战斗界面的所有 UI
• 14.6 本章产出：《酒魂》的战斗 HUD（完成度：60%）

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

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

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

解决什么问题： 让玩家选择配方、添加材料，准备酿造。配方 UI 复用第9章框架。

• 15.1 配方数据结构（JSON / Resource，加载自第4章 DataManager）
• 15.2 配方选择界面与加载逻辑
• 15.3 材料槽位：点击 → 弹出背包（第10章复用）→ 选择 → 填入
• 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-20章）

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

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

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

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

第19章　对话树系统

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

• 19.1 对话气泡 UI（复用第9章的 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 任务进度的序列化接口：to_dict() / from_dict()
• 20.6 动手： 完成"找回失传酒谱"任务链
• 20.7 本章产出：《酒魂》的任务系统（完成度：86%）

第七部分：酒坊经营（第21-24章）

定位： 把酒魂的核心循环跑通——存档 → 货币 → 升级 → 闭环验证。

第21章　存档系统：保存你的进度

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

• 21.1 存档接口规范：每个系统预留 to_dict() / from_dict()（第5 / 10 / 18 / 20 章已按此实现）
• 21.2 存档内容设计：玩家属性、背包、好感度、任务进度等当前已实现系统的字段总和
  • (注：酒坊等级等后续章节的系统，在各自章节实现后按同一规范追加字段，本章不预占)
• 21.3 多存档位实现（ConfigFile / SQLite）
• 21.4 自动存档与手动存档
• 21.5 动手： 完成《酒魂》的存档 / 读档
• 21.6 本章产出：进度不丢失的《酒魂》（完成度：88%）

第22章　货币系统：铜钱与功德

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

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

第23章　酒坊等级与设备升级

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

• 23.1 酒坊等级设计（1~5 级）
• 23.2 升级条件：铜钱 + 特定酒品 + 功德值
• 23.3 设备系统：窖池、蒸馏器、酒曲房（每级解锁）
• 23.4 升级解锁：新配方、新设备、新 NPC
• 23.5 酒坊状态的序列化：按第21章规范追加存档字段
• 23.6 动手： 完成酒坊升级系统
• 23.7 本章产出：经营内容层（完成度：93%）

第24章　经济循环与闭环验证

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

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

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

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

第25章　性能优化：让酒魂不卡顿

解决什么问题： 内容做完了，但帧率撑不住。这一章把性能拉回来。

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

第26章　多平台打包：发布你的游戏

解决什么问题： 把游戏导出成别人能双击运行的文件。

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

第27章　社区发布：让《酒魂》被玩到

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

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

附录

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

• 附录A　设计模式实战手册（集中讲，章节内不重复）
  • A.1 策略模式：第12章 12.2、第16章 16.1
  • A.2 工厂模式：第13章 13.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.7、第10章 10.1
  • A.7 状态机模式：第8章 8.2、第11章 11.2
• 附录B　《酒魂》素材清单与版权（瓦片 / 帧动画 / 字体 / 音频 / BGM，含 CC0 来源）
• 附录C　《酒魂》踩坑大全（性能 / 碰撞 / UI / 动画 / 存档五类，按问题汇总）
• 附录D　仓库地址与每章 diff 摘要（GitHub 仓库 + 各章代码 diff 索引 + FAQ）
• 附录E　《酒魂》完整 GDD（含所有数据结构、数值表）
• 附录F　GDScript API 速查表
• 附录G　向 AI 高效提问指南

目录结构总览（v3.0）

完成度里程碑（全书 19 个节点）

四个大关卡： 25%（第一章可玩原型）→ 60%（战斗可玩）→ 75%（酿造可玩）→ 100%（闭环可玩）。 每到一个大关卡，你手里都是一个"可以给别人试玩"的版本，而不是一堆半成品。

跨章设施索引