# 剧情架构
Confidence: high
Last verified: 2026-04-28
Generation: human_only


# 剧情架构

## 游戏剧情架构基础

### 剧情 vs 故事的区分
- **故事** — 事件的时间顺序排列（发生了什么）
- **剧情** — 事件的艺术性编排（如何讲述）

### 游戏剧情的特殊性
- 玩家的自主行动必须与预设剧情协调
- 剧情节奏受玩家游戏行为影响
- 需要为玩家的"失败"提供叙事解释

---

## 变量管理与状态追踪

### 传统方法的问题
- 全局 Flag 泛滥（30,000+ 变量噩梦）
- 变量之间冲突难以调试
- 新分支导致需要手动检查所有相关 Flag

### Etudes 系统（Owlcat Games GDC 2026 分享）
一个层级化的、基于优先级的任务管理系统替代全局 Flag：

**核心机制：**
- 层级化状态机（不是扁平的 Flag 列表）
- 优先级排序：高优先级任务覆盖低优先级
- 内置冲突检测：新条件不会与已存在的冲突
- 可视化调试：绿/橙/灰状态树，几分钟定位问题（之前需要数小时）

**关键教训：**
- 不要用布尔 Flag 做所有事——需要结构化状态管理
- 可视化调试是必需品，不是奢侈品
- 预计算冲突比事后调试高效得多

---

## 分支剧情设计

### 设计原则
1. **有意义的选择** — 玩家能预见选择的大致后果
2. **成本控制** — 分支不要无限制膨胀（使用"分支与合并"策略）
3. **后期回报** — 早期选择在后期产生回响
4. **伪装分支** — 看似不同但汇入同一点的剧情（节省成本）

### 分支管理策略

| 策略 | 说明 | 成本 |
|------|------|------|
| 完全分支 | 不同选择走向完全不同的剧情 | 极高 |
| 分支合并 | 分支最终汇合到主线 | 中 |
| 伪装分支 | 多个选择导向相似结果，但中间过程不同 | 低 |
| 延迟反馈 | 选择的影响在后期才显现 | 中 |
| 调色板 | 不同选择只影响对话风格而非剧情走向 | 极低 |

---

## 角色设计

### 游戏角色的特殊性
- 玩家化身（Avatar）—— 玩家的游戏内代表
- 旁观者角色 —— 玩家通过其眼睛观察
- NPC 角色 —— 推动剧情或提供功能

### 角色弧线
1. **静态弧线** — 角色不变，改变的是周围世界
2. **变化弧线** — 角色随剧情发展改变信念
3. **堕落弧线** — 角色从好变坏
4. **救赎弧线** — 角色从坏变好

### 游戏角色设计技巧
- 通过玩法展现性格（不只是对话）
- 角色能力与背景故事一致
- 同伴系统：NPC 在战斗中展现性格
- 角色关系网：角色之间的动态关系

---

## 场景与任务设计

### 叙事场景构成
- 设置（时间、地点、情境）
- 冲突目标
- 互动玩法
- 剧情推进点
- 奖励与后果

### 任务叙事结构
1. 任务简报（触发动机）
2. 任务过程（玩法+环境叙事）
3. 任务完成（剧情推进+奖励）

### 节奏把控
- 高峰与低谷交替（紧张战斗 > 探索 > 剧情对话）
- 大高潮之间安排小高潮
- 给玩家"喘口气"的空间

---

## 叙事工具

| 工具 | 说明 | 适用引擎 |
|------|------|----------|
| **articy:draft X** | 叙事设计专用工具，API 集成，本地化支持 | Unity / Unreal |
| **StoryFlow Editor** | 可视化节点编辑器，80+ 节点类型，运行时调试 | Unity / Unreal / Godot |
| **Twine** | 轻量级分支叙事工具，适合原型 | 通用 |
| **ink (Inkle)** | 叙事脚本语言，分支+变量管理 | Unity / 通用 |
| **Yarn Spinner** | 对话系统框架 | Unity / Godot |

---

## 叙事数据架构

### 叙事数据库设计

```
关系型方案（适合简单项目）：

Tables:
├── Dialogues
│   ├── id, speaker_id, text_key, next_id, conditions
│   └── conditions: JSON {flag: value, min_reputation: 50}
├── Choices
│   ├── id, dialogue_id, text_key, next_id, effects
│   └── effects: JSON {set_flag: value, reputation_change: +10}
├── Characters
│   ├── id, name, default_mood, voice_id
├── Variables (Flags)
│   ├── id, name, type, default_value, scope
│   └── scope: GLOBAL / CHAPTER / SCENE
└── Quests
    ├── id, title, status, prerequisites, rewards

文档型方案（适合复杂分支）：
├── 每个"剧情块"是一个自包含文档
├── 包含：文本、条件、效果、跳转
├── 优势：无需 JOIN，读取快
└── 劣势：数据一致性靠自己维护
```

### 变量作用域设计

| 作用域 | 生命周期 | 用途 | 示例 |
|--------|----------|------|------|
| **GLOBAL** | 整个游戏 | 主线进度、重大选择 | `MAIN_QUEST_COMPLETED` |
| **CHAPTER** | 当前章节 | 章节内状态 | `CH2_ENEMY_SPARED` |
| **SCENE** | 当前场景 | 临时状态 | `DIALOGUE_REPEAT_COUNT` |
| **CHARACTER** | 绑定角色 | 角色关系、好感度 | `NPC_ALICE_FRIENDSHIP` |
| **PLAYER** | 绑定存档 | 玩家偏好 | `DIALOGUE_SPEED` |

---

## 分支管理进阶

### 分支复杂度控制

```
成本控制公式：

总内容量 = 主线内容 × (1 + 分支深度 × 分支宽度 × 合并效率)

变量说明：
- 分支深度：最多连续选择几次（推荐 ≤ 3）
- 分支宽度：每个节点选择数量（推荐 2-4）
- 合并效率：分支后多久回归主线（0=永不合并，1=立即合并）

示例计算：
- 主线：100 分钟
- 分支深度：2，宽度：3，合并效率：0.5
- 总内容 = 100 × (1 + 2 × 3 × 0.5) = 100 × 4 = 400 分钟

推荐参数：
├── 小型游戏：深度 1-2，宽度 2-3
├── 中型 RPG：深度 2-3，宽度 2-4
└── 大型叙事：深度 3+，宽度 3-5（需大量资源）
```

### 分支热图分析

```
用数据优化分支设计：

1. 追踪每个分支的选择率
   ├── 如果某选项 < 5% 选择率 → 考虑删除或改进
   ├── 如果某选项 > 90% 选择率 → 另一个选项可能有问题
   └── 理想分布：40-60%（两个选项都吸引人）

2. 追踪分支完成率
   ├── 某分支 50%+ 玩家中途退出 → 内容质量问题
   └── 某分支完成时间远超预期 → 可能太冗长

3. 热力图可视化
   └── 节点颜色 = 通过该节点的玩家比例
   └── 快速识别"冷分支"和"主干道"
```

---

- Owlcat Games: GDC 2026 — Managing 30,000+ Narrative Variables
- StoryFlow Editor (Steam, 2026)
- articy:draft X 官方文档
- 传统叙事设计理论：三幕结构、英雄之旅、角色弧线

---

## 参见

- [narrative-design.md#叙事结构类型] — 叙事结构详细对比
- [narrative-design.md#对话系统设计] — 对话系统设计方法
- [narrative-design.md#环境叙事] — 环境叙事技巧
- [templates/gdd-template.md] — GDD 模板中的叙事部分

---

## 叙事工具详细对比

| 工具 | 价格 | 学习曲线 | 协作 | 脚本能力 | 运行时 | 推荐场景 |
|------|------|----------|------|----------|--------|----------|
| **articy:draft X** | 订阅 [待验证] | 中 | ✅ 实时 | 中（条件逻辑） | Unity/Unreal 插件 | 大型叙事项目 |
| **ink** | 免费开源 | 低 | ⚠️ Git | 高（完整脚本语言） | 所有平台 | 文本驱动叙事 |
| **Yarn Spinner** | 免费开源 | 低 | ⚠️ Git | 中 | Unity/Godot | 对话系统 |
| **Twine** | 免费 | 极低 | ❌ | 低（基础变量） | 浏览器 | 原型/视觉小说 |
| **StoryFlow Editor** | 付费 [待验证] | 低 | ❌ | 高（80+节点） | Unity/Unreal/Godot | 可视化叙事 |
| **Notion/Obsidian** | 免费-低 | 极低 | ✅ | 无 | 无（纯策划） | 早期策划 |
| **Excel/Google Sheets** | 免费 | 极低 | ✅ | 无（公式） | 无 | 数据驱动的叙事 |

### 工具选型决策树

```
项目规模？
├── 个人/原型 → Twine / Notion
├── 小型团队 → ink / Yarn Spinner
├── 中型团队 → StoryFlow / articy:draft
└── 大型团队 → articy:draft + 自研工具

技术栈？
├── Unity → Yarn Spinner / ink / StoryFlow
├── Unreal → articy:draft / ink / StoryFlow
├── Godot → Yarn Spinner / StoryFlow
├── 自定义引擎 → ink（最易集成）

叙事复杂度？
├── 简单对话树 → Twine / Yarn Spinner
├── 复杂分支 → ink / StoryFlow
├── 大量变量 → articy:draft / 自研工具
└── 与玩法深度耦合 → 自研工具
```

---

## 叙事系统性能优化

| 优化点 | 问题 | 方案 |
|--------|------|------|
| **文本加载** | 数万条对话导致启动慢 | 按需加载，分章节打包 |
| **变量查询** | 数千变量查询慢 | HashMap 索引，缓存常用变量 |
| **分支评估** | 复杂条件判断耗时 | 预编译条件表达式 |
| **本地化** | 多语言文本内存占用 | 运行时加载当前语言 |
| **存档大小** | 大量变量导致存档膨胀 | 只存"非默认值"变量 |

---

## 最佳实践

- [ ] **变量命名规范** — `AREA_NPC_STATE` 而非 `flag_127`
- [ ] **版本控制叙事数据** — diff 友好格式（JSON/YAML > 二进制）
- [ ] **自动化测试** — 遍历所有分支路径，检测死路和矛盾
- [ ] **从工具导出** — 策划在工具中编辑，导出为游戏可读格式
- [ ] **热更新叙事** — 允许不停机更新对话文本（Bug 修复）
- [ ] **备份分支** — 删除的分支保留在"废案"中，可能复活
- [ ] **玩家数据驱动** — 追踪分支选择率，指导后续内容
- [ ] **与玩法解耦** — 叙事系统不直接调用玩法代码，通过事件中介