trpg-module-prep

name	trpg-module-prep
description	用于TRPG 备团准备，而不是正式跑团主持。根据模组正文、章节文本、世界设定、规则资料或角色信息，提炼出当前章节/场景可供 DM 使用的备团内容，包括：核心事件、剧情推进条件、NPC 动机与关系、可交互点、可能发生的战斗与遭遇、线索与伏笔、地图/插图使用时机、资源压力、节奏分段，以及需要特别注意的规则或判定。适用于开团前准备、章节开始前整理、复盘后更新下一章节备团资料。触发场景包括：备团、章节整理、模组提炼、DM 准备、跑团前总结、遭遇设计、NPC 整理、地图使用规划。触发词：备团、模组备团、章节备团、TRPG备团、DND备团、COC备团、DM准备、开团前整理、剧情提炼、章节简报、module prep、session prep、dm prep.

第一部分：如何备团

1.1 备团文件结构

trpg-module-prep/dnd_campaigns/<module name 根据模组分开管理>
├── module/  
│   ├── prep/
│   │   ├── chapter_01_prep.md    ← 之前章节
│   │   ├── chapter_02_prep.md    ← 目前的章节
│   │   └── event_triggers.md     ← 事件图片触发注册表
│   ├── maps/
│   │   └── *.jpg                 ← 地图
│   ├── monsters/
│   │   └── part1_monsters.md     ← 怪物数据（集中管理）
│   └── npcs/
│   │   └── npc_xxx.md            ← NPC档案（纯剧情，不含战斗数据）
│   └── companions/
│       └── xxx.md                ← 同伴NPC
└────── <module name>.pdf         ← 模组设定集
│   
├── session_notes/
│   ├── session_progress.md       ← 当前位置
│   └── s01.md                    ← 会话记录
├── state/
│   ├── world_state.md            ← 世界发生了什么
│   ├── quest_state.md            ← 任务追踪
│   ├── npc_relationships.md      ← NPC关系
│   └── loot_registry.md          ← 战利品追踪
└── README.md

1.2 备团资料怎么写

备团资料是你的剧情圣经，必须包含以下内容：

备团流程（8步）

在 /module/prep/chapter_0x_prep.md 生成当前章节的备团文档。

① 去state/目录查询当前剧情已经发生了什么（世界状态/任务/NPC关系/战利品），建立上下文
② 读PDF/模组资料 → 提取本章内容
③ 写备团资料 → 结合当前 state/目录中的剧情进度与模组章节内容，生成本次会话可直接使用的备团资料。内容应包括：
   1. 准备关键 NPC 动机、秘密和反应，不要只准备台词。->结合module/npcs state/npc_relationships.md的目录下的该章节会出现的npc的背景内容
   2. 所有剧情信息都要区分为：DM内部信息 / 玩家可见表述。
   3. 每个关键推进点至少准备两个可替代入口，避免单线索卡死。
   4.规则术语、DC、检定、豁免、隐藏机制只保留在DM内部备注中；玩家表述必须写成世界内可感知的信息。
④ 写战斗遭遇资料 → 向玩家索取本章所有战斗地图后，读PDF内容按“区域”分析遭遇。
⑤ 写主持资料文件 → 整理本章可直接使用的主持文本，包括：场景初见描述、关键 NPC 的说话风格与示例台词、重要事件的触发分支、以及必要时可直接朗读的文本片段。不得将整章写成固定剧本，不得预设玩家唯一行动路线。
⑥ 创建/更新单独的NPC档案->目录位置<module name>/npcs → 属性/背景/战斗策略
⑦ 创建该章节的monster档案->目录位置<module name>/monsters → 属性/背景/战斗行为
⑧ 更新event_triggers.md → 按剧情推进顺序列出事件触发节点
⑧ 该章节结束时更新state/目录 → session_progress.md + world_state.md + quest_state.md

⚠️ 剧本完整性检查（强制）

写完剧本后，必须确认以下内容全部存在：

检查项	有没有？
DM朗读文本（开场白/场景描述原文）	❌/✅
NPC台词（每个关键NPC至少1句对话）	❌/✅
背景故事（为什么这里会发生这些事）	❌/✅
玩家选择+后果分支	❌/✅
发展分支（被打败/逃跑/谈判成功怎么办）	❌/✅
氛围描写（气味/声音/光线/触感）	❌/✅
战斗数据（AC/HP/伤害/DC）	❌/✅
防剧透处理（隐藏信息需调查/交涉才能获取）	❌/✅

8项全✅才算备团完成。只有战斗数据=不合格。

必备章节

# [模组名] 备团文档

## 一、当前队伍状态
| 角色 | 种族 | 职业 | AC | HP | 状态 | 备注 |
|------|------|------|-----|-----|------|------|

## 二、当前场景
[这次开场时，玩家正处于什么局面，眼前有什么，马上会面对什么。]

## 三、NPC导航指引
[哪些NPC能带路？各有什么目的？]

## 四、旅行规则
[步调、时间、导航、觅食、遭遇设定]

## 五、预设遭遇
### 遭遇1：[名称]
- 触发条件
- 敌人数据
- 宝藏
- RP提示

## 六、资源追踪
[食物、饮水、光源、金币、法术位]

备团铁律

1. 所有敌人必须有数据支撑——AC、HP、攻击、豁免
2. 预设遭遇必须有触发条件——不是想打就打
3. 宝藏必须预先设计——不能临时编造

1.2b 按章节备团法

章节结构

每章备团资料开头加一段上章梗概（给新会话/会话压缩后快速恢复上下文）：

## 上章梗概
- 队伍从[地点]出发，经历了[关键事件]
- 重要决策：[玩家做了什么选择]
- NPC状态变化：[谁的状态变了，变成什么样]
- 当前目标：[队伍要去哪/做什么]

NPC核心记忆更新

每章结束时，更新每个重要NPC档案的核心记忆部分：

## 核心记忆
- 与PC的关系：信任/中立/怀疑/敌对
- 记住的关键事件：[TA目睹了什么]
- 当前动机：[TA现在想做什么]
- 隐藏状态：[感染/疯狂/秘密有没有变化]

线路预备表

每章开始前，提前列出玩家可以走的所有线路（防止即兴编造）：

## 本章可选线路

| 线路 | 触发条件 | 主要内容 | 难度 | 关键NPC | 预设遭遇 |
|------|---------|---------|------|---------|---------|
| A线路 | 选择去X地 | 描述... | 内部评估 | NPC名 | 遭遇1→遭遇2 |
| B线路 | 选择去Y地 | 描述... | 内部评估 | NPC名 | 遭遇3→遭遇4 |
| C线路 | 说服Z NPC | 描述... | 内部评估 | NPC名 | 遭遇5 |

⚠️ 即兴发挥时，只能在本表线路范围内扩展，不能编造新线路。


### 图片清单（地图+NPC图片）

向玩家索取本章所有地图和NPC图片后，建立对应关系：

```markdown
## 📐 图片清单

| 图片 | 类型 | 对应事件/NPC | 发送时机 |
|------|------|-------------|---------|
| goblin_cave.jpg | 地图 | 遭遇1：地精巢穴 | 发现洞穴入口时 |
| blacksmith.jpg | NPC | 铁匠老托比 | 第一次对话时 |
| boss_room.jpg | 地图 | BOSS战 | 进入最终房间时 |
| npc_villain.jpg | NPC | 反派XXX | 揭露真面目时 |

⚠️ 发送规则：
1. 不要提前发——等触发条件满足才发
2. 先口述环境，再发地图
3. NPC图片在首次描述外貌时发送

战斗遭遇图片

向玩家索取本章所有战斗地图后，读取pdf建立对应关系：

DM版本

每个区域单独写：

Area X：名称

• 当前情境：
• 玩家初见描述：
• 敌人 / NPC：
• 环境要素：
• 隐藏信息：
• 触发事件：
• 相邻区域联动：
• 战斗战术备注：

1.这里当前的情境、玩家初见描述。 2.敌人/NPC及其当前行为、可直接互动或影响战局的环境元素、 3.需要隐藏的情报、可能触发的事件， 4.以及与相邻区域的反应关系（警报、支援、追击、封锁、撤退）。 5.若战斗爆发，额外备注该区域的战术特点与敌人常见反应。

玩家版本

区域	名称	连接的区域	当前认知	危险度	探索状态	备注
Area 1	困境	2, 4, 5	小队从裂缝进入，这里是目前已知入口	低	已经过	返回路线
Area 2	滴落的死亡	3	曾遭遇灰泥怪，现已清除，但环境仍令人不安	中	已清理	可安全通过
Area 3	格拉巴古	2	这里有格拉巴古（胶质方块 NPC），目前正在此处停留	未知	进行中	当前所在区域

玩家决策记录

每章结束时，在备团资料末尾记录玩家的实际选择，同时更新 state/world_state.md：

## 玩家决策记录（本章）

| 时间 | 决策 | 结果 | 影响 |
|------|------|------|------|
| 第1次会话 | 选择走北边山路 | 遇到豺狼人，战斗 | NPC-A受伤 |
| 第2次会话 | 说服商人指路 | 成功，节省2天 | 商人记住队伍，可能告密 |
| 第3次会话 | 不去拯救村民 | 村民死亡 | NPC-B对队伍失去信任 |

### 下章备团参考
- 本章未触发的遭遇：[列表]
- NPC关系变化：[列表]
- 玩家可能的下一步：[预测]

决策影响同步更新到 state/world_state.md、state/quest_state.md、state/npc_relationships.md。

1.3 NPC管理

NPC档案位置

所有NPC档案存放在 module/npcs/ 目录下，战斗数据统一在 module/monsters/，NPC文件只保留剧情内容（性格/背景/对话/动机）。

NPC档案格式

# [NPC名称]

## 基本信息
- 种族/身份
- AC/HP（如果有战斗数据）
- 阵营
- 性格关键词

## 属性值（简表）
| 力量 | 敏捷 | 体质 | 智力 | 感知 | 魅力 |
|------|------|------|------|------|------|
| +x | +x | +x | +x | +x | +x |

## 背景
[详细背景]

## 战斗行为
[遇到战斗时怎么行动]

## 目前举动
- [日期] 发生了什么

NPC更新规则

当以下情况发生时，必须更新NPC档案：

• 性格或行为模式改变
• 重大事件经历（战斗、对话、决策）
• 隐藏秘密被揭露
• 与PC的关系变化
• 战斗状态变化（受伤、死亡、装备变更）

NPC互动铁律

1. 怪物遭遇必须骰隐匿/察觉

   • 进入有怪物的区域时，必须骰隐匿检定（vs 怪物被动察觉）
   • 隐匿失败或未骰隐匿 → 必定触发战斗/敌对反应
   • 不允许无骰跳过怪物遭遇

2. NPC之间必须有互动对话

   • 每次剧情推进至少包含1-2句NPC之间的对话
   • NPC会主动与其他NPC聊天、争论、开玩笑、表达情绪

3. NPC有独立行动

   • NPC会主动做决定、表达意见、推动剧情
   • 不是被动等待PC指令的花瓶

1.4 剧情更新

会话进度文件

每次跑团必须维护 session_progress.md：

# [模组名] — 会话进度

## 当前位置
- 区域：[玩家在哪]
- 队伍：[谁在队伍里]
- 旅行状态：[步行/宿营/遭遇]

## 已完成的预设遭遇
- [x] 遭遇1
- [ ] 遭遇2 — 待触发

## 下一个预设遭遇
[下一次应该发生什么]

## 资源状态
- 食物：x
- 饮水：x
- 光源：x
- 治疗药水：x

## NPC状态
- NPC1：当前状态
- NPC2：当前状态

更新时机

• 每次会话结束时：更新当前位置和状态
• 每次重大事件后：更新NPC状态、剧情进展
• 会话压缩后：重新读取并确认进度

1.5 地图与事件对应

地图文件夹结构

maps/
├── encounter1.jpg    ← 遭遇1的地图
├── encounter2.jpg    ← 遭遇2的地图
└── encounter3.jpg    ← 遭遇3的地图

在备团资料中标注发送时机

### 遭遇1：地精巢穴
**📐 地图**：`maps/goblin_cave.jpg`
**发送时机**：玩家发现洞穴入口时

地图发送规则

1. 不要提前发地图——等玩家进入该区域才发
2. 发送时机要自然——在描述完环境后再发
3. 配合描述——先口述环境，再发地图让玩家看
4. 战斗时使用combat_manager渲染——不要用原图代替战斗网格