附录E　《酒魂》完整设计蓝图

本附录是什么： 这是一份可以独立阅读的《酒魂》完整设计说明。第 3 章教你「怎么用五维框架做设计」，本附录给出「《酒魂》的设计长什么样」——它就是第 3 章那五份动手任务的完整答案。

怎么用（三种读法）：

• 读第 3 章时：每读完一维，翻到本附录对应小节对照，看看自己的填法和范例差在哪；
• 写代码卡住时：按需查表。写第 16 章品质计算 → 查 E.1.4；写第 12 章醉意 → 查 E.1.3；
• 最后通读：全部完成后回来读一遍，检验「我做出来的东西，还是不是当初设计的那个」。

⚠️ 一条纪律： 本附录是设计意图的权威，但不是数值的最终裁决。凡是文中标注「待定」的项，都以对应章节的实测结果为准——不要拿一个拍脑袋的数字去约束后面还没设计的系统。

目录

E.0　一页版 GDD（总纲）

对独立开发者来说，GDD 一页纸就够用了。《酒魂》的全部核心内容浓缩如下——这一页是其余五节的封面，每次开工前先看它。

E.0.1 设计支柱展开

三根支柱是《酒魂》所有决策的最终仲裁者。当你纠结「这个功能要不要做」时，问它服务于哪根支柱；一根都不沾的，砍掉。

E.1　📊 数据维度：所有「量」的定义

数据包括： 属性、数值、资源、概率、范围、增长曲线……一切可以量化的东西。 设计时问自己： 这个数值的范围合理吗？它的增长曲线让玩家感受到成长，还是感受到无聊？

E.1.1 设计口径（先看这六条）

在填任何数值之前，先把「什么数字该出现在《酒魂》里」定死。这六条决定了后面所有表格的边界：

1. 这是一款 2D 像素 ARPG，不是 RTS —— 没有单位、没有建筑队列、没有资源采集点。所有数值依附在「主角 · 酒品 · 素材 · 古人 · 酒坊」这五个实体上。
2. 战斗双轨 —— 第 7 章的投壶是「节奏预判型」玩法（无生命值对抗，比的是命中与评分）；第 11 章起升级为动作战斗（有生命值、有 Hitbox/Hurtbox）。投壶不会被删除，而是收编为一个远程技能。
3. 品质只有一套分级 —— F / D / C / B / A / S 六级，同时用于酒品、武器和装备，不再另设「普通→良酿→陈酿」第二套。
4. 货币只有两种 —— 铜钱（主要）+ 功德值（隐藏 / 稀有）。
5. 没有「诗意值」和「药性值」 —— 灵感只保留一个 poem_meter（触发诗号的积累条），药性并入「素材词缀」，不再单独成条。
6. 武器三系，但同时只装一把 —— 近战 / 远程 / 酒魂三系俱全（见 E.1.8），但不存在武器融合、双持、同时输出。三系是「三个时机」，不是「三份资源」。

这六条的作用是「防跑偏」。 独立开发者最容易犯的错，是每次设计新功能时都顺手造一套新数值系统。口径先定死，后面每加一个数字都能问一句：「它在不在这六条之内？」

E.1.2 主角属性

为什么 attack 之外还要一个 weapon_mult？ 前者是「主角有多强」，后者是「这一击用什么打的」。分开之后，换武器不会污染角色本体属性，三系的差异也集中在数值表里，调平衡时只改一处。

为什么生命值是 100200 而不是 50500？ 《酒魂》的战斗是「一屏内几秒解决」的小规模遭遇战，不是持久围攻。用 100 起步、200 封顶，能让一次普通敌人攻击打出「掉 12 血」这种一眼能读懂的数字，玩家不用心算百分比。这是第 3.5 节「可读性优先」法则的直接应用。

E.1.3 醉意系统参数（核心数值）

醉意是《酒魂》唯一贯穿「战斗 / 投壶 / 酿造」三条线的数值杠杆。它既是资源，也是风险。

（1）四个阶段与阈值

四阶段而不是连续的渐变，是为了让玩家能数得清。连续渐变的手感更细腻，但玩家无法建立预期；四档阈值让「再喝一口就到 0.8 了」变成一句可以思考的话。

（2）增减规则

（3）投壶准星漂移（醉意的第二种表达）

数据与体验的咬合： 180 px 这个上限不是随便定的。酒壶的钟摆振幅是 60 px、箭矢判定半径是 14 px，准星漂到 180 px 时，命中率会掉到大约三成——刚好是「很不爽，但偶尔能蒙中，蒙中时特别爽」的区间。这就是「数据调节体验」的意思（对应 E.6.2）。

E.1.4 酒品数据

（1）核心字段（对应 resources/recipes/*.tres 与背包物品）

（2）品质分级与分值

为什么是六档而不是三档？ 档位越多，玩家对「再酿一次会不会更好」的期待就越具体。但同时必须保证相邻档位的视觉差异足够大，否则六档就退化成「六个数字」。这是「可读性优先」法则的另一处应用。

（3）四种酿造工艺

四种工艺给了玩家四种不同的赌博方式：稳、疯、保底、加料。这是 E.2.9「有意义的选择」在酿造层的体现。

（4）词缀池（共 12 条，MVP 先做 5 条）

权重之和不必是 100。 代码里用「权重累加后取随机数」即可（第 16 章会讲），这样以后加词缀不用重算分母。

装备词缀复用同一个池 —— 不给装备另开一套词缀表。这样第 16 章只用写一次词缀生成器。这是「数据口径」第 3 条（品质只有一套分级）的延伸。

E.1.5 素材（酿造材料）

注意：这里没有「粮食 / 药引 / 诗魂」三资源条。 素材是背包里的物品（第 10 章），不是常驻屏幕右上角的资源计数器。你身上有多少黍米，去背包里看。

这个区分的意义是：素材是「东西」，货币才是「数字」。 混在一起会让玩家分不清「我该去哪儿看我的资源」。

E.1.6 货币与好感度

（1）货币

功德值为什么是隐藏的？ 它是「你有没有把这坛酒当江湖事做」的隐性记账。玩家不能主动刷，只能在关键抉择时累计——这样第 23 章「5 级酒坊需要 100 功德」就会变成一句「原来那些没白做」的回报，而不是一个刷取指标。

（2）古人好感度

• 单次赠酒的增益 = 酒品品质系数 × 2（F=2，S=24），每日每位古人上限 +30；
• 赠对口的酒（如给李白送「将进酒」）额外 +50%。

（3）三位主要古人

E.1.7 酒坊与装备

（1）酒坊等级

升级条件同时卡钱 + 酒 + 功德三样，缺一不可。这就是 E.2.10「三维内容门控」在数值层的落地——单卡钱会让人「刷钱冲级」，单卡酒会让人「囤货」，三样交错才能逼玩家完整地玩。

（2）装备栏位与词缀

• 装备品质复用 F~S 分级；
• 装备词缀复用 E.1.4（4）的同一个词缀池。

⚠ 修订记录： 原设计此处为「酒壶 slot_pot」。在补入三系武器系统后，slot_pot 被收编为武器的一个形制（酒魂系的默认武器），武器栏统一为 slot_weapon。这样「酒壶」既是身份象征，也是可替换的实战武器。

E.1.8 三系武器系统（近战 / 远程 / 酒魂）

设计来源： 主角已有 attack_32.png（8 方向 × 10 帧挥砍动画）与状态机 ATTACK 态，但「挥的是什么」此前未定义。本节补全。

（1）设计口径：三系同修，酒品决定倾向

（2）三系武器总表

三系的经济学意义： 近战是「不喝酒时的底牌」，远程是「可控的中间态」，酒魂是「喝到极致的爆发」。三条线刚好覆盖了醉意 0.0 → 1.0 的完整区间——玩家喝到哪个阶段，自然就该切到哪把武器。这是把 E.1.3 的醉意分档真正用起来。

（3）各系数值（MVP 基准）

近战系

远程系（投壶/弓）

酒魂系（术法）

数值平衡的一句话原则： 近战求稳（1.0）、远程求准（1.6）、酒魂求爆（2.2），但代价依次升高——近战无成本、远程要蓄力、酒魂要喝到 0.8。倍率与代价必须成正比，否则就有最优解，三系就白做了。

（4）武器品质与词缀

• 武器品质复用 F~S 六级（不加新分级），影响 attack 基础值；
• 武器词缀复用 E.1.4（4）的同一个词缀池，但部分词缀有系别倾向：

不给武器另开一套词缀表 —— 这是 E.1.1 口径第 3 条的延伸。三系共用池子，只有少数词缀带系别倾向，代码只需写一次词缀生成器。

（5）熟练度（MVP 简化版）

MVP 可先只做 1~3 级，甚至只记录不生效——但数据结构要留好，否则第 16/23 章的存档要改字段。

（6）存档字段（第 21 章复用）

# 武器系统进度
{
  "equipped_weapon": "melee_sword_01",   # 当前装备
  "weapon_prof": {                        # 三系熟练度
    "melee":  {"level": 1, "exp": 0},
    "ranged": {"level": 1, "exp": 0},
    "wine":   {"level": 1, "exp": 0}
  },
  "owned_weapons": ["melee_sword_01"]     # 已拥有武器 id 列表
}

E.1.9 失败相关的数据

这些数值存在的唯一目的，是让「失败」变成「意外惊喜」而不是「纯损失」。

一处已废弃的旧设计： 原草稿写「阵亡扣 20% 粮食和药引」，已废弃。因为素材是物品不是数字——从背包里随机抽走几件东西，玩家只会觉得莫名其妙、甚至不知道该补哪样。改成只扣铜钱，损失直观，且不破坏已完成的酿造计划。

E.1.10 待定项（后续章节回填）

留「待定」不是偷懒，是避免用一个拍脑袋的数字去约束后面还没设计的东西。 但每一项都必须写清「什么时候填」——否则「待定」就会变成「忘了」。

E.1.11 数据层一致性检查清单

第 3 章 3.1.1 的动手任务要求每份数据文档末尾附一份自查清单。以下是数据维度的完整范例版，与 E.6.3 汇总清单的数据层部分同源：

• 这个数字挂在五个实体（主角 / 酒品 / 素材 / 古人 / 酒坊）之一上吗？——不在这五者之内，就不该有这条数据
• 它是不是又造了一套品质分级？——必须复用 F~S（武器、装备同理，见 E.1.1 第 3 条）
• 它是不是又造了一种货币？——只有铜钱 + 功德值
• 它是不是又造了一条常驻「资源条」？——屏幕上只有生命值 + 醉意值；素材是背包里的物品，不是计数器（见 E.1.5）
• 玩家能否一眼读懂这个数字（不用心算百分比）？
• 围绕它的规则让玩家纠结了吗？不纠结的数字，删掉

E.2　📏 规则维度：所有「动词」的定义

规则包括： 什么能做，什么不能做，做了会怎样……一切关于「操作」和「反馈」的定义。 设计时问自己： 这条规则让游戏更有趣还是更繁琐？它是否给玩家留出了足够的决策空间？

E.2.1 设计口径（先删掉不该存在的动词）

1. 没有建造指令 —— 不存在「按 B 打开建造菜单」。酒坊升级是在第 23 章的菜单里花钱，不是在野外摆建筑。
2. 没有单位控制 —— 不存在「F 键集合」「框选单位」。主角一个人打，这是 ARPG 不是 RTS。
3. 没有采集进度条 —— 不存在「靠近资源点按 E 采集」。素材靠购买 + 战斗掉落 + 任务奖励获得。
4. 战斗分两段 —— 第 7 章的投壶（节奏预判）+ 第 11 章起的动作战斗（状态机近战）。投壶不会在升级后被删掉，而是被收编为远程系武器的一件形制。
5. 武器三系，但同时只装一把 —— 近战 / 远程 / 酒魂三系俱全，但战斗中是「切换」而不是「同时用」。没有武器融合、没有双持、没有技能连招系统（见 E.1.8）。

E.2.2 每个系统的一句话

「可读性优先」法则（第 3.5 节）的落地检验：任何一句超过 20 个字，就说明这个系统该简化了。

注意三系武器的三句话都是 12 个字，而且都说清了「优势 + 代价」。 如果某一把武器的一句话里说不出代价，说明它太强了，要削。

E.2.3 核心玩法一：投壶（第 7 章）

操作： 按住鼠标左键蓄力 → 松开投掷。左右走位调整角度。

四条福缘

为什么福缘必须改规则？ 「+100 分」这种奖励，玩家看一眼数字就忘了。而「总壶数 +3」是当场可感知的规则变化——玩家会立刻明白「刚才那一箭，把我的这局游戏变长了」。这是「有意义的选择」法则的示范，也是第 7 章 apply_random_bonus() 已经实现的机制。

E.2.4 核心玩法二：动作战斗（第 11 章）

投壶是「小游戏式」的独立对决；主线探索中的战斗是无缝动作战斗——遇到敌人在原地开打，不切场景。

（1）主角状态机

规则细节（这四条是新手最容易做错的地方）：

• 攻击期间不能移动 —— 让「出招」成为一个真实的时间成本；
• HURT 有 0.3 秒硬直，期间无敌 0.5 秒 —— 避免被连击锁死（这两个时间要错开，否则硬直期间无敌已结束，还是会被连）；
• 阵营免伤 —— 同阵营 Hitbox 打在自家 Hurtbox 上直接忽略；
• 同一次挥击去重 —— 一次攻击对同一目标只结算一次伤害（防止多帧重复扣血）。

（2）三系武器切换规则

主角 ATTACK 态的具体表现由当前装备的武器决定——同一个状态机，三种完全不同的手感。

三系的战斗手感对比：

切换的战术意义： 三系不是「换着玩」，而是对应三种战场处境。玩家会发现：被醉鬼贴脸时切近战、对面站着酒虫时切远程、被围住时喝到 0.8 切酒魂清场。这就是「有意义的选择」在战斗操作层的落地。

（3）三系与醉意的动态咬合（核心设计）

这是武器系统真正的设计价值——醉意阶段会自然引导玩家切换武器：

看清楚这个设计： 醉意越高，近战和远程越难受（移速降、准星飘），而酒魂越强。所以玩家不会纠结「该不该喝酒」——喝到最后自然会切到酒魂。这不是削弱近战远程，而是让三者有明确的时间窗口：

• 清醒/微醺 → 近战的高光时刻
• 微醺/半醉 → 远程的稳定期
• 大醉 → 酒魂的爆发期

一套醉意数值，自动调度三把武器。 这就是 E.1.1 口径「醉意是核心杠杆」在武器层的兑现。

（4）敌人 AI

三种敌人（MVP）：

敌人不是「数值变体」而是「行为变体」 —— 三种敌人共用同一个状态机代码，只在参数（视野半径、移动速度、是否呼叫支援）上分叉。这是第 11 章 11.5 节的实现方式，也是「用少数行为模式扩展出更多敌人」的具体落地。

E.2.5 核心玩法三：醉意（第 12 章）

操作： 按 E 喝酒。

决策点： 现在喝（提升战力但有打滑风险）还是留到关键时刻喝？

关键规则约束： 醉意值不是只属于战斗的数值。它同时是投壶准星的漂移源（E.2.3）和酒魂技的解锁条件（E.2.6）。一个数值，三处使用——这是《酒魂》最核心的设计剪影，也是「规则决定体验」的最佳例证。

E.2.6 核心玩法四：酒魂技（第 13 章）

三种酒魂技（MVP 只做第 1 种）：

诗号不是装饰。 诗号文本由当前酒品名 + 词缀决定（第 13 章 13.4），所以「你酿了什么酒」会直接决定「你放大招时喊哪句诗」。这让第 15~17 章的酿造系统，在战斗里有了可见的回声。

E.2.7 核心玩法五：酿造（第 15~17 章）

（1）酿造流程

进入酒坊 → 按 F 打开酿造面板（弹出 UI，暂停世界）
  → 选择配方
  → 素材槽（点击 → 弹出背包 → 选择 → 填入）
  → 选择工艺（煎酒 / 蒸酒 / 酿制 / 浸酒）
  → 点击「开酿」
  → 结算品质（F~S）→ 生成词缀
  → 成品入背包 / 送入窖池陈化

决策点： 用稀有素材赌 S 级，还是用普通素材求稳？

（2）品质计算规则（第 16 章）

quality_score = 基础分(配方) + Σ素材加成 + 工艺匹配度 + 随机波动

工艺匹配度惩罚： 素材与工艺不匹配时 −6 / 个——不是不能酿，只是会酿得差。

（3）词缀生成规则（第 16 章）

• 按 quality 档位决定词缀条数上限（F=0 … S=3）；
• 按 E.1.4（4）的权重池抽取，不重复；
• 同族词缀互斥（如已抽到「烈」，不再抽到「剑」）。

（4）陈化规则（第 17 章）

决策点： 立刻卖（快速回款）还是存着（更高售价，但占用窖池且可能溢期）？

（5）君臣佐使配伍（第 17 章，MVP 不实现）

四种工艺各有「君臣佐使」四位素材槽。填入符合配伍的素材组合可触发配方外效果：

配伍系统在 MVP 中不实现，但结构先留好 —— 第 17 章实现时只需填规则，不用改数据结构。这是「先留钩子、后填内容」的典型做法。

E.2.8 核心玩法六：人际与经营（第 18~23 章）

（1）古人交互（第 18 章）

（2）对话树（第 19 章）

• 数据结构：组合模式（节点 = 文本 + 选项列表 + 条件 + 跳转）；
• 条件可引用任意数据：fav_libai >= 60、quality >= "A"、quest_completed("find_recipe")；
• 对话配置写 JSON，从第 4 章的 DataManager 加载；
• 对话不是看板 —— 选项必须能改变数值（好感、拿配方、触发任务），否则该选项删掉。

（3）任务系统（第 20 章）

• 用命令模式封装目标检测（附录 A.5），任务定义写 JSON；
• 主线任务链「找回失传酒谱」——由 5 个任务串联，每完成一个解开下一环。

（4）存档（第 21 章）

• 硬性规范 —— 每个系统必须提供 to_dict() / from_dict()；
• 存档内容：主角属性、背包、酒坊等级、好感度、任务进度、已解锁配方、当前醉意值；
• 多存档位，格式用 ConfigFile（轻量）或 SQLite（第 21 章对比选型）；
• 自动存档触发点：酿造完成 / 关卡切换 / 任务完成。

（5）经济与升级（第 22~23 章）

（6）内容解锁门控（第 24 章）

所有内容解锁都必须挂在三维门控上，缺一不可：

为什么要三个维度同时卡？ 单靠等级门控，玩家会「刷钱冲级」；单靠好感度，玩家会「只送礼不打怪」。三条线交错，玩家才必须完整地玩这个游戏——这正是第 24 章闭环验证要检查的东西。

E.2.9 「有意义的选择」设计

检验方法：闭上眼睛选 A，你会后悔没选 B 吗？不会？那这个选择删掉。

E.2.10 MVP 版本范围

以下清单为待办勾选框。每项后标注实现章节。

战斗系统

• 投壶核心玩法：蓄力 + 抛物线 + 命中判定（第 7 章）
• 状态机：待机 / 移动 / 攻击 / 受击 / 死亡（第 8 章）
• 三系武器框架：切换机制 + 三系 ATTACK 分支（第 8 章）
• 近战系完整实现：长剑 + attack_32.png 挥砍（第 8 章）
• 远程系完整实现：复用第 7 章投壶/箭矢（第 8 章）
• 酒魂系基础实现：1 个术法（与「将进酒」共用，第 13 章）
• 3 种敌人：醉鬼 / 酒虫 / 巡夜人（第 11 章）
• 醉意系统：0~1 数值，影响攻击力与移速（第 12 章）
• 1 种酒魂技：「将进酒」（第 13 章）
• 战斗 HUD：血条 + 醉意条 + 技能图标 + 伤害飘字（第 14 章）

武器系统的 MVP 边界： 三系框架 + 各 1 把基础武器必须做（第 8 章），因为切换机制是理解「三系」的关键；但熟练度可先只记录不生效（见 E.1.8 第 5 条），武器数量也可先各只有 1 把。

酿造系统

• 3 种基础配方（第 15 章）
• 品质计算 F~S 六级（第 16 章）
• 随机词缀：5 个固定词缀（第 16 章）
• 陈化系统基础版（第 17 章）

UI 与背包

• 通用 UI 框架：弹窗 / Toast / 对话框（第 9 章）
• 背包 + 物品格子 + 拖拽（第 10 章）
• 武器栏位与切换提示（第 10 章）

剧情与人际

• 开场：继承酒坊（第 18 章）
• 邂逅李白 + 好感度系统（第 18 章）
• 李白好感度 60 的剧情（第 18 章）
• 对话树基础版（第 19 章）
• 一条支线任务链（第 20 章）
• 存档 / 读档（第 21 章，含武器进度字段）

经营

• 货币系统 + 商店雏形（第 22 章）
• 酒坊 1~3 级升级（第 23 章）

暂不实现（放到后续版本）

• 全语音对话
• 君臣佐使完整配伍系统（第 17 章先留结构，不填规则）
• 四种工艺的完整差异化（MVP 只做蒸酒 + 煎酒）
• 程序化地图生成
• 多结局分支（先做单一结局）
• 多语言支持
• 酒坊 4~5 级与设备系统（第 23 章后半）
• 武器熟练度生效（第 8 章先记录数据，后续版本再影响数值）
• 武器打造 / 强化系统（MVP 武器靠购买与剧情获得）
• 武器专属连招（MVP 每系只有一种攻击模式）

E.3　🌄 设定维度：世界的容器

设定包括： 发生在什么时代？什么地点？什么画风？什么音乐？……一切关于「世界是什么样」的定义。 设计时问自己： 这个设定是否给规则和剧情提供了一个自洽的容器？玩家相信这个世界吗？

E.3.1 时代与地点

为什么是「天宝年间」而不是模糊的「唐代末年」？ 因为李白（701—762）、杜甫（712—770）、王维（699—761）三人都活跃于天宝年间。把时间锁死在这个窗口，才能让三位古人同框出现且不违和——李白和杜甫的相遇本身就是天宝三载（744 年）的事。

而「唐代末年」会让王维已故百年，这在设定层面就崩了。时代不是氛围词，是逻辑约束。

E.3.2 视觉风格

2D 像素 · 水墨江南 · 微光酒色

这是一款像素游戏，不是水墨渲染游戏。「水墨青绿 + 宣纸纹理」是颜色倾向，不是渲染方式——两者必须分开说清楚，否则第 6 章做瓦片时会走错路。

为什么分辨率定 640×480？ 因为它是 32 的整数倍（20 格 × 15 格），且 ×2 = 1280×960 是常见屏幕尺寸。像素游戏最忌讳非整数倍缩放——0.7 倍缩放会让每个像素变成 0.7 个屏幕像素，边缘出现「有的清楚有的糊」的脏感。这是新手最容易踩的坑（详见第 6 章）。

色板（15 色，全书统一）

用色三原则：

1. 每张图不超过 8 色 —— 像素画靠限制而不是靠丰富取胜；
2. 酒红是唯一的高饱和色，且只用在「酒」相关的地方。玩家看到红色，就知道那里有酒；
3. 永远不用纯黑，最暗用焦墨 #1E1C1A —— 纯黑在像素画里会形成死板空洞。

E.3.3 场景清单

E.3.4 角色设计

剪影测试： 把上面任何一个角色填成纯黑，玩家应该还能认出他是谁。如果认不出，就是设计失败了——这是像素角色的第一原则。

E.3.5 可出现的元素

三系武器的设定依据（对应 E.1.8）

三系武器全部取自唐代真实器物，没有一个需要虚构：

⚠ 关于「魔法」这个词： 《酒魂》不使用「魔法 / magic」作为系统名。原因是双重的：① 「魔法」是西方奇幻的词汇体系，撞 E.3.6 禁止清单第 2 条；② 它本身是现代汉语借词，撞 E.4.7 写作规范第 2 条（不用现代词汇）。

书中统一称 「酒魂系」（或「术法」）。这不是换皮，而是选择了一个更贴合唐代、且与书名同源的表达 —— 玩家的法术力量来源就是「酒」，与第 13 章的酒魂技、E.4 的酒魂谱完全一脉相承。

诗词使用规范

• 只用唐代及以前的诗文（含《诗经》《楚辞》与唐诗）；
• 诗句必须可考，不杜撰。若需原创，明确标注为「酒魂的句子」并在文本上做区分（如倾斜 / 异色）；
• 酒魂技的诗号直接从上述篇目取句：
  • 将进酒 → 「人生得意须尽欢」
  • 月下独酌 → 「举杯邀明月」
  • 醉里挑灯 → 原拟「醉里挑灯看剑」是**辛弃疾（南宋）**的词，超出天宝年间的设定容器，已改用「醉卧沙场君莫笑」（王翰《凉州词》）

上面这条修正本身就是范例。 原草稿的「诗魂战士暴击显示『十步杀一人』」来自李白《侠客行》，可用；但「醉里挑灯看剑」越界了。在时代锁定之后，这类越界元素会立刻现形 —— 这就是「设定是容器」的实际作用。

E.3.6 绝对禁止出现的元素

（1）世界观层面

• ❌ 任何唐代以后的人物与诗文（苏轼、李清照、辛弃疾、《红楼梦》）
• ❌ 任何西方 / 异域元素（和服、西式建筑、十字架、骑士甲）
• ❌ 任何现代 / 近现代元素（手机、电器、枪炮、机械齿轮、蒸汽朋克）
• ❌ 西方式魔法符号 —— 法杖、魔杖、水晶球、六芒星、咒语吟唱。第三系是酒魂系（以诗为咒、以酒为引），不是巫师（见 E.3.5 武器设定依据）

（2）美术层面

• ❌ 非像素化的写实贴图 —— 不能中途混入手绘高清图，风格会撕裂
• ❌ 纯黑描边（用焦墨 #1E1C1A）
• ❌ 渐变与柔光 —— 像素画靠明暗跳色，不靠渐变（唯一例外：醉意红滤镜，它属于后处理层，不是贴图）
• ❌ 非整数倍缩放（会破坏像素网格）

（3）玩法层面

• ❌ 采矿、伐木、农田种植（《酒魂》的素材靠购买 + 掉落 + 任务）
• ❌ 单位生产、建筑摆放、资源采集进度条（这是 RTS，不是本作）
• ❌ 枪械、炸弹等远程热兵器（投壶与剑气是仅有的远程手段）

E.3.7 听觉设定

BGM 的三段结构不是随便分的： 它让玩家闭着眼睛也知道自己在哪。这是第 6 章做场景切换、第 25 章做音频优化时的判断依据。

E.3.8 一致性检查清单

在设计任何新功能之前，逐条过一遍。

• 这个元素存在于天宝年间吗？（李白可以，苏轼不行）
• 命名是否符合唐代背景？（用「铜钱」不用「金币」，用「功德」不用「荣誉」）
• 规则是否贴合唐代工艺？（酿酒用古法，不用现代蒸馏设备）
• 视觉是否符合像素 + 水墨青绿 + 酒红点缀？
• 色彩是否控制在 8 色以内，酒红是否只用在酒相关处？
• 是否触犯了 E.3.6 的任何一条禁止项？
• 音效是否在古琴 / 箫 / 筝的器乐范围内？
• 这个元素是「容器里的东西」，还是「把容器撑破的东西」？

E.4　📖 剧情维度：事件序列

剧情包括： 主线、支线、角色弧光、情感节拍……一切关于「发生了什么故事」的定义。 设计时问自己： 玩家有没有理由在乎这些角色？剧情的节奏是否和游戏进度相互支撑？

E.4.1 主线（30 字版）

你继承了一座破酒坊，通过酿酒结识唐代诗人，找回失传的《酒魂谱》，复兴酒坊。

这是对外的一句话——用来回答「你这游戏讲什么」。

而故事的内里是这样的：

每一次酿酒时酒汽氤氲，你都会看见不属于你的记忆。手背上那道符文，是三年前酒坛自裂那晚留下的。 镇子记不清你的父亲是怎么死的，你也是。 但你酿的每一坛酒，都在替一个不在了的人，把话说完。

外层是经营，内里是寻父。 玩家为了「酿出更好的酒」而玩，最后发现自己是为了「知道父亲最后酿的是什么酒」而玩。

E.4.2 三境界叙事框架

叙事分三层境界，逐境递进——不是割裂的章节，而是同一世界逐步展开的三重认知维度：从「活下去」，到「为何活」，再到「如何才算活过」。

三境界与目录的对齐：

• 「人间·忘忧境」的入口就是第 18 章的「与李白对饮」——那一章的定位不变，只是赋予了它更深的内核；
• 「草木·渡厄境」落在第 19 章的对话树上（杜甫的对话树是第 19 章的动手任务）；
• 「诗酒·归真境」落在第 20 章的「找回失传酒谱」任务链上——「酒谱」就是父亲未完的那坛酒。

换句话说：目录的章节骨架不动，三境界是给骨架注入的血肉。

为什么主导古人是李白 → 杜甫 → 王维？ 因为这三人的气质刚好对应三重命题：李白是「问」（揭谜的人）、杜甫是「债」（拷问的人）、王维是「答」（放下的人）。

而父亲从不以活人身份出场 —— 他只出现在酒气、井水、回忆和别人的话里。这是让「未完的酒」这个核心意象成立的前提。

E.4.3 剧情与玩法绑定

原则： 每个剧情事件都由系统数值触发。不玩到那一步，就看不到那层真相。 剧情不是播片，是玩法的奖励。

E.4.4 MVP 剧情范围

只实现：开场 → 首次酿造 → 李白出现 → 李白好感度 60 → 解锁第一个酒魂技。

全流程一览（完整版）

第一境 · 人间·忘忧境 被坛裂之声惊醒，酒液渗地成字。手背首次出现不明符文。小镇寂静如常——它已替你习惯了许多事。悬念种下：裂坛、符文、被隐瞒的真相。

第二境 · 草木·渡厄境 杜甫登场，他说出「你父亲欠我最后一笔」。记忆碎片拼出残谱，指向酒窖深处。情感基调由悬疑转向悲悯：被赋予的因果，能不能不接。

第三境 · 诗酒·归真境 王维揭开真相：父亲饮下浊气，替镇子封了一道。两条路不是「好结局 / 坏结局」，而是：

• 完成父亲的酒 → 把《酒魂谱》酿完，酒入井中，父亲得以安息，你继承酒坊，一世凡人；
• 另起一坛 → 不接这笔债，把父亲的配方封进窖池，自己从头酿属于自己的酒。

两条路都不是圆满的。 第一条路你失去了父亲最后的痕迹；第二条路镇子的债永远悬着。

这正是《酒魂》对「失败也要有趣」的最终回答：结局不该有对错，只该有代价。

E.4.5 剧情触发的代码条件

这张表是第 18~20 章写代码时的直接依据。写法参考第 4 章的 EventBus 与 GameManager。

存档字段（第 21 章复用）：

# 剧情进度必须全部可序列化
{
  "brew_count": 0,           # 累计酿造次数
  "winery_level": 1,         # 酒坊等级
  "fav_libai": 0,            # 李白好感度（0~100）
  "fav_dufu": 0,
  "fav_wangwei": 0,
  "fragment_count": 0,       # 记忆碎片数
  "skill_cast_count": 0,     # 酒魂技释放次数
  "awakening_level": 0,      # 前世觉醒度（隐藏）
  "quest_flags": {}          # 任务完成标记
}

E.4.6 关键意象速查

E.4.7 写作规范（给第 18~20 章的对话文本立规矩）

1. 每句台词不超过 30 字 —— 对话气泡（第 19 章）在 640×480 基准分辨率下，一行放不下更多；
2. 不用现代词汇 —— 「心理阴影」「状态」「系统」这类词一律不出现；
3. 古人说古人的话 —— 李白狂、杜甫沉、王维淡，三人的语气必须能盲听分辨；
4. 父亲从不说完整的话 —— 他的台词只出现在回忆和他人转述中，且总是被打断；
5. 悬念宁可少给，不要多给 —— 一个境界只揭开一层，玩家才有动力进入下一境；
6. 每个剧情节点必须绑定一个系统动作 —— 如果一句话不能换来一个配方、一个 NPC 或一个数值变化，那它就不该被写出来。

E.5　✨ 体验维度：情绪弧线

体验包括： 紧张、成就感、好奇、代入感、遗憾……一切关于「玩家感觉到什么」的定义。 设计时问自己： 我希望玩家在这个时刻感受到什么？我的设计是否在制造那种感受？

E.5.1 设计核心理念

《酒魂》以**「诗酒江湖」为核心体验锚点，通过醉意值**作为核心体验杠杆，在三个维度打造差异化体验：

所有体验设计均围绕核心意境展开： 「酒入豪肠，七分酿成月光，三分啸成剑气。」

E.5.2 关键体验节点

技术实现均已按 Godot 4.6 / 2D 像素项目的实际能力标注，不使用不存在的 API，也不依赖高清美术。

E.5.3 有趣的失败设计

核心原则： 失败不只是惩罚，而是「带有补偿的成长契机」。同时它必须贴合酒文化的「容错」「豁达」内核——输了也要输得体面。

关于失败设计的三条硬规则

1. 补偿收益 ≥ 惩罚损失 —— 否则玩家会开始「躲着玩」，不敢尝试任何高风险策略；
2. 永远不扣「已投入的时间」 —— 素材、配方进度、好感度一律不动；
3. 失败必须看得见 —— 任何惩罚都要在 HUD 上有明确反馈，绝不偷偷扣数值。

E.5.4 MVP 优先实现的体验

按「落地难度 ÷ 体验收益」排序。三项全部可以用最少的代码换来最大的感知差异。

优先级 1：饮酒后攻击力提升的视觉反馈

• 简化实现：CanvasLayer 叠一层半透明酒红 ColorRect（透明度仅随醉意变化）+ 攻击力数字弹窗（Label，显示「攻击 ×1.5」+ 缩放动画）；
• 核心目标：让玩家直观感知「饮酒 = 变强」。优先保证数值变化与视觉反馈同步（差 1 帧都会削弱感知）。

优先级 2：第一次酿出酒的成就感

• 简化实现：Camera2D 聚焦酒坛 + 品质弹窗（F~S 色块 + 词缀文字）+ 开坛音效；
• 核心目标：这是整个酿造系统的第一印象。玩家如果在这里感到「值了」，后面 3 章的酿造玩法才有耐心玩下去。

优先级 3：释放酒魂技的痛快

• 简化实现：Camera2D 震动 + GPUParticles2D 单层粒子 + 一句固定诗号 + 高伤害数字；
• 核心目标：这是最核心的爽点，也是《酒魂》与普通 ARPG 的分界线。哪怕只有一种酒魂技、只有一句诗号，也必须做出来。

MVP 阶段暂不做（降本聚焦核心）：

E.5.5 体验的节奏原则

E.5.6 文化统一原则

所有视觉、音效、文字反馈都必须贴合唐代酒文化，任何现代元素都会让玩家出戏：

一个可执行的检查方法： 把界面截图给一个完全不懂游戏的人看，问他「这是什么朝代的东西」。如果他说不出「古代中国」，就是出戏了。

E.5.7 后续迭代方向

1. 体验节点拓展 —— 酒坊升级的完整庆典演出（E.5.2 的升级反馈扩展为全场仪式）、诗会夺冠、跨镇斗酒；
2. 失败设计深化 —— 为「醉卧」做 3 种不同姿势（按当时动作随机），让失败本身成为内容；
3. 文化沉浸强化 —— 把诗句与玩家当前场景绑定（雨天打怪 → 「空山新雨后」），让诗号真正「看天吃饭」；
4. 无障碍与体验保障 —— 镜头震动强度可调、闪烁频率可关（第 25 章统一处理）。

E.6　五维咬合总表与一致性检查

五个维度不是平行的，它们之间有方向性的影响关系。理解这些关系，能让你在设计时少走弯路。

E.6.1 五维 × 全书章节映射表

五个维度分别长在书里的哪些章？这张表是全书的施工索引：

写第 7 章投壶之前，先查 E.2.3；写第 16 章品质计算之前，先查 E.1.4。

E.6.2 五维之间的咬合关系

（1）设定是容器，其他四维在里面生长

设定决定了什么东西在这个游戏世界里是合理的，是所有设计的基础。

《酒魂》的设定是唐代中国，这意味着：

用法： 当你设计一个新功能，先问「它落在哪个维度」，再看那个维度被设定约束了什么。 约束不是限制，是免于返工的护栏。

（1.5）武器三系是五维「咬合最紧」的一次示范

三系武器系统横跨了全部五个维度，正好可以拿来检验框架好不好用：

这张表是全书的微缩模型。 如果你能说清「三系武器为什么必须是这三种、为什么必须靠醉意咬合、为什么不能叫魔法」，你就理解了五维框架的用法。

（2）规则决定体验，数据调节体验

这是五维框架里最重要的一对关系。

以醉意系统为例：

数据的作用是：在规则确定之后，把体验调节到「刚好好玩」的程度。

（3）剧情借设定生根，借规则推进

《酒魂》的剧情不是独立于系统之外的「看板」，而是通过游戏规则自然流露的。

• 玩家酿出特定酒品（酿造规则）→ 触发对应古人的好感度（数据）→ 解锁对饮事件（剧情）
• 玩家在投壶小游戏中获胜（战斗规则）→ 获得古人赠送的酿酒配方（数据 + 规则）→ 解锁新的剧情对话（剧情）

最重要的一条原则： 如果玩家可以不玩酿造就解锁剧情，剧情就成了「额外的负担」，而不是「玩法的奖励」。 所以 E.4.3 的每一个触发条件，都必须是一个玩家主动做出的玩法动作——而不是「走到某个坐标自动播片」。

E.6.3 总一致性检查清单

新增任何内容前，逐条过一遍。 这一份是 E.1.1 / E.2.1 / E.3.8 / E.4.7 / E.5.6 五份分项清单的汇总入口。

数据层

• 这个数字挂在哪五个实体上？（主角 / 酒品 / 素材 / 古人 / 酒坊）——不在这五者之内，就不该有这条数据
• 它是不是又造了一套品质分级？——必须复用 F~S（武器同理）
• 它是不是又造了一种货币？——只有铜钱 + 功德
• 它是不是又造了一种「资源条」？——只有生命值 + 醉意值，武器不额外带能量条
• 玩家能否一眼看懂这个数字在变大还是变小？
• 它让玩家纠结了吗？如果不纠结，删掉

规则层

• 这条规则里有没有出现单位 / 建筑 / 采集？（有就是 RTS 残留，删）
• 它是否引用了一个已存在的系统，还是偷偷造了新系统？
• 它的数值是否都能在 E.1 里找到出处？
• 它的失败结果有趣吗？还是只是「重来一次」？
• 它用一句话说得清吗？（超过 20 字就该拆）
• 武器相关：三系是否共享同一套醉意与品质体系？有没有偷偷给某一系开小灶（独立资源、独立升级线）？

设定层

• 这个元素存在于天宝年间吗？
• 命名是否符合唐代背景？——特别检查：不出现「魔法 / 法术 / 蓝条 / 技能点」
• 视觉是否符合像素 + 水墨青绿 + 酒红点缀？
• 音效是否在古琴 / 箫 / 筝的器乐范围内？
• 它是「容器里的东西」，还是「把容器撑破的东西」？

剧情层

• 每个剧情节点是否绑定了一个系统动作？
• 台词是否超过 30 字？是否混入了现代词汇？
• 三位古人的语气能否盲听分辨？
• 这一步是否只揭开一层悬念？

体验层

• 反馈时长是否在 0.5 ~ 2 秒？
• 是否首次加重、之后减半？
• 失败是否有补偿，且补偿 ≥ 损失？
• 界面截图给人看，他能说出「古代中国」吗？

延伸阅读

• 《游戏设计艺术》（Jesse Schell）—— 五维框架的灵感来源，书中一个个「透镜」就是一套设计自查清单，用法与第 3.5 节的三条法则相同。重点阅读第 1~5 章。
• 《游戏编程模式》（Robert Nystrom，中文版免费在线阅读）—— 理解「设计模式是解决什么问题的」；本书**附录 A「设计模式实战手册」**会系统用到书中的知识点。