mcpField
D
dndtale

dndtale

github.com/mickume创意与媒体067 次安装27 周前更新
代码仓库

关于 dndtale

Dndtale 是面向 Dungeon Master 和创作者的 Dungeons & Dragons 战役与冒险创作技能。它通过结构化工作流、模板和检查清单,支持从剧情主线到 NPC、遭遇和玩家资料的创作。

主要功能

  1. 01多场次战役与单次冒险
  2. 02NPC、地点与遭遇设计
  3. 03战役模板与工作流
  4. 04一致性与质量检查清单
  5. 05玩家资料与 DM 内容
  6. 06AI 图像生成提示词

适用场景

  1. 01从故事构想规划完整战役
  2. 02编写单场游戏冒险
  3. 03创建 NPC 与均衡遭遇
  4. 04修改战役文件并保持内容连贯

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mickume/dndtale --skill dndtale

安装后在 Claude Code 中输入/dndtale确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

STRUCTURE.md
checklists/
campaign-quality-checklist.md
campaign-research-checklist.md
consistency-checklist.md
examples/the-stolen-flame/
briefing.md
campaign-overview.md
chapter-01.md
locations.md
npcs.md
modules/
campaign-types.md
creative-voice.md
dndig-reference.md
encounter-design.md
formatting-conventions.md
literary-adaptation.md
session-pacing.md
world-building.md
templates/
campaign-overview.md
chapter-template.md
chapters-summary.md
factions.md
locations.md
npcs.md
README.md
timeline.md
workflows/
campaign-creation-workflow.md
iteration-workflow.md

详细介绍

Dndtale - DnD 战役与冒险创作工具

Dndtale 是一款专用技能,旨在帮助地下城主和创意内容创作者打造完整、引人入胜的《龙与地下城》战役与冒险。


快速开始

创建新战役
  1. 立即使用 TaskCreate 创建规划清单
  2. 遵循工作流: workflows/campaign-creation-workflow.md
  3. 如果尚未提供需求,使用 AskUserQuestion 收集需求
  4. 使用模板: 所有模板都在 templates/ 中
  5. 质量检查: 完成后使用 checklists/campaign-quality-checklist.md
更新现有战役
  1. 阅读现有内容后再进行修改
  2. 遵循迭代工作流: workflows/iteration-workflow.md
  3. 检查一致性: 使用 checklists/consistency-checklist.md
  4. 对现有文件进行针对性修改时,使用 Edit 工具
需要示例?

查看完整的示例战役:examples/the-stolen-flame/


Dndtale 的功能

此技能可帮助你创作:

  • 完整战役 - 多场次故事线,包含相互关联的情节、派系和长期影响
  • 单次冒险 - 在单场游戏中完成,目标明确且结局令人满意的冒险
  • NPC - 个性鲜明、动机明确、怀有秘密且拥有属性数据的角色
  • 地点 - 细节丰富的场景设定,包含氛围、历史和互动元素
  • 遭遇 - 平衡的挑战,设有多种解决方案并带来有意义的后果
  • 故事框架 - 既保留玩家自主权,又能确保情节连贯的叙事结构
  • 图像提示词 - 用于 AI 图像生成工具的详细提示词

核心原则

创作风格
  • 使用富有感染力、营造氛围的文字——先渲染氛围,而非罗列数据(参见 creative-voice.md)
  • 在每个场景描述中调动多种感官
  • 让每个 NPC 都有欲望、说话方式和观点
  • 将遭遇设计成戏剧引擎,而不是数学题
玩家自主权优先
  • 始终为问题提供多种解决方案
  • 设计会产生重要影响并持续发酵的后果
  • 避免强制玩家沿单一路径前进
  • 让玩家的选择塑造故事
  • 角色背景故事是战役的燃料——将其融入其中
便于桌面游玩
  • 编写清晰、便于快速浏览的 DM 记录
  • 提供简洁的朗读文本
  • 包含速查表
  • 预先考虑 DM 的常见需求
完整性与一致性
  • 在文档之间添加交叉引用
  • 保持时间线与逻辑一致
  • 确保名称和事实前后一致
  • 修改内容时检查依赖关系
使用合适的工具
  • TaskCreate/TaskUpdate: 跟踪复杂的战役创作任务
  • AskUserQuestion: 澄清需求并收集偏好
  • Read: 编辑前务必先阅读现有文件
  • Edit: 对现有内容进行针对性修改
  • Write: 根据模板创建新文件
  • dndig: 生成战役插画(参见 dndig-reference.md)

文件组织

每个战役都应遵循以下结构:

campaigns/[campaign-name]/
├── campaign-overview.md         # Master document with full campaign arc
└── changelog/                   # Changelogs
    └── [change-name].md         # Documented changes to the campaign
├── README.md                  # Player-facing session zero document (spoiler-free)
├── chapter-01.md                # Detailed session content
├── chapter-02.md                # Continue for each chapter/session
├── chapters-summary.md          # Chapter/Scene-level summaries for all chapters of the campaign
├── npcs.md                      # Important characters with stats and motivations
├── locations.md                 # Key places with descriptions
├── factions.md                  # Organizations and their goals (optional)
├── timeline.md                  # Timeline of events in the campaign (optional)
└── art/                         # Image prompts and artwork
    ├── [scene-name].md          # Image generation prompts for scenes
    ├── [location-name].md       # Image generation prompts for locations/environment
    ├── [npc-name].md            # Image generation prompts for unique NPCs
    └── [generated-images.jpg]   # Actual artwork *.jpg (if generated)

资源库

模板

将这些模板用作所有战役文档的起点:

模块

参考这些模块获取详细指导:

工作流

针对不同任务的分步流程:

检查清单

用于质量保证:

示例

展示所有模板用法的完整战役示例:


工作流概览

创建新战役

阶段 1:收集需求

  1. 使用 TaskCreate 创建规划清单
  2. 如果简介不完整,使用 AskUserQuestion
  3. 收集:故事构想、长度、等级、背景、基调
  4. 如果要改编源材料,请遵循 literary-adaptation.md
  5. 完成 campaign-research-checklist.md

阶段 2:战役框架

  1. 选择战役类型(参见 modules/campaign-types.md)
  2. 创建 campaign-overview.md(使用模板)
  3. 规划章节划分和游戏场次节奏(参见 session-pacing.md)
  4. 创建 chapters-summary.md(使用模板)
  5. 确定主要 NPC 和地点

阶段 3:详细开发

  1. 使用 creative-voice.md 提升写作质量,为每章撰写内容
  2. 使用 encounter-design.md 设计多样且有深度的遭遇
  3. 使用 world-building.md 中的分级框架详细设计 NPC
  4. 详细设计地点(使用模板)
  5. 按需创建派系(使用模板)

阶段 4:面向玩家的内容

  1. 撰写 README.md(使用模板)
  2. 确保简介中没有任何剧透

阶段 5:润色与质量检查

  1. 使用 dndig-reference.md 为关键场景编写图像提示词
  2. 按照 campaign-quality-checklist.md 进行检查
  3. 通读整个战役,检查节奏和一致性

查看详细工作流: workflows/campaign-creation-workflow.md

更新现有战役
  1. 阅读所有受影响的文件
  2. 规划更改并确定依赖项
  3. 编辑现有文件,进行有针对性的更改
  4. 更新交叉引用
  5. 使用 consistency-checklist.md 检查一致性

查看详细工作流: workflows/iteration-workflow.md


重要指南

务必做到

使用 TaskCreate/TaskUpdate 处理复杂任务

  • 立即使用 TaskCreate 创建规划清单
  • 跟踪各个创作阶段的进度
  • 完成任务后使用 TaskUpdate 将其标记为已完成
  • 同一时间只能有一个任务处于 in_progress 状态

必要时提出问题

  • 对于不明确的需求,使用 AskUserQuestion
  • 确认基调、内容界限和玩家偏好
  • 询问存在多种有效方案的情况
  • 不要猜测——向 DM 确认

编辑前先阅读

  • 使用 Edit 前,务必先使用 Read 阅读现有文件
  • 理解完整上下文
  • 检查依赖项和交叉引用
  • 与现有内容保持一致

保留玩家自主权

  • 为每个问题提供多种解决方案
  • 设计有意义的后果
  • 允许创造性的方法
  • 避免强制玩家走单一路径

遵循模板

  • 使用 templates/ 中的模板
  • 保持格式一致
  • 包含所有必需章节
  • 与示例风格相符
切勿这样做

不要强行引导玩家

  • 绝不要强制采用单一解决方案
  • 不要否定玩家的选择
  • 避免采用“NPC 包办一切”的解决方案

不要跳过质量检查

  • 完成前务必使用检查清单
  • 确认交叉引用有效
  • 检查名称是否一致
  • 测试故事逻辑

不要忘记文档

  • 在文档之间添加交叉引用
  • 链接相关内容
  • 添加 DM 注释和提示
  • 提供属性数据块或参考资料

不要破坏现有内容

  • 编辑时保持故事逻辑
  • 更新所有指向已更改内容的引用
  • 检查时间线是否一致
  • 保留有效内容

Session Zero 注意事项

除非另有说明,战役均面向愿意参与的成年人编写。当内容可能令人不安或属于 NSFW 时:

  • 在 README.md 中加入内容警告
  • 建议讨论 Session Zero 话题
  • 推荐安全工具(X-Card、Lines & Veils)
  • 明确标注成熟内容

标准 D&D 冒险结构

此技能遵循专业 D&D 冒险惯例(完整详情见 STRUCTURE.md):

**前置内容:**引言、概要、冒险钩子 **核心结构:**按章节划分场景、遭遇和 NPC **高潮:**史诗级最终遭遇,包含多种解决途径 **后置内容:**附录,包含属性数据、魔法物品、讲义

每章包含:

  • 用于场景铺陈的朗读文本
  • DM 信息与秘密
  • 遭遇设计(战斗、社交、技能挑战)
  • 带有性格与属性数据的 NPC
  • 宝藏与奖励
  • 与其他章节的关联

格式规范

遵循 modules/formatting-conventions.md 中的惯例:

朗读文本:

> Text the DM reads to players
> Detailed, evocative, multi-sensory
> Present tense, no secrets

**DM 备注:**使用常规文本描述游戏机制细节、秘密和应变方案

**属性数据:**尽可能参照《Monster Manual》,或提供自定义属性数据

**交叉引用:**使用 Markdown 链接:[Chapter 2](chapter-02.md) 或 [NPCs](npcs.md#npc-name)

**图像提示词:**在 art/ 文件夹中创建,并添加适当的元数据


快速参考

战役类型
  • **线性:**按顺序展开的章节,路径清晰(最容易准备)
  • **沙盒:**中心枢纽,多种选择(准备工作最多)
  • **事件驱动:**按时间线展开事件,玩家行动会影响结果
  • **设定驱动:**聚焦地点,鼓励探索

参见:modules/campaign-types.md

遭遇设计
  • 每场战斗都要回答:“为何会发生这场战斗?战斗结束后会有什么变化?”
  • 地形是第三个战斗者——环境应迫使玩家做出选择
  • 为敌人设定“消灭队伍”之外的目标(逃跑、保护、拖延时间、捕获)
  • 使用遭遇设计检查清单:戏剧性问题、利害关系、环境、多种应对方式、局势升级、关联
  • 使用遭遇多样性矩阵(战斗/社交/探索/混合子类型)追踪多样性
  • Boss 战需要包含多个阶段、传奇动作、情感利害关系和多种胜利条件

参见:modules/encounter-design.md

NPC 设计
  • **第 1 级(过场角色):**一个特征、一项有用之处、一个容易记住的名字
  • **第 2 级( recurring 角色):**想要与需要、对其他 NPC 的看法、一个秘密、说话习惯
  • **第 3 级(主要角色):**完整的内心世界、独立的故事线、机制分量、声音特征、关系网络
  • **反派:**动机、手段、弱点、升级、镜像

参见:modules/world-building.md、templates/npcs.md

地点设计
  • 氛围(景象、声音、气味、感受)
  • 历史与现状——运用环境叙事
  • 在场的 NPC 和遭遇
  • 可供发现的秘密——层层递进的谜题,让好奇心有所回报

参见:modules/world-building.md、templates/locations.md


基调与内容

根据 DM 要求的基调进行调整:

  • 英雄史诗风
  • 黑暗严肃风
  • 幽默轻松风
  • 悬疑与阴谋
  • 恐怖
  • 成人主题/NSFW(附带适当警告)

始终做到:

  • 始终保持与所要求的基调一致
  • 在简介中警告成熟内容
  • 针对敏感话题提供 Session Zero 指引

使用 dndig 生成图像

使用 dndig(../dndig)根据提示词文件生成战役插图。完整文档请参阅 dndig-reference.md。

快速使用:

dndig campaigns/my-campaign/art/throne-room.md --verbose

提示词文件格式:

---
title: throne-room
aspect_ratio: "16:9"
resolution: 2K
temperature: 0.8
batch: 2
instructions: campaign-style.md
references:
  - refs/gothic-castle.jpg
---

Detailed visual description based on scene read-aloud text...
Include: composition, lighting, mood, style, atmosphere.

主要功能:

  • 风格一致性: 为战役的视觉风格创建一个共享的 instructions 文件
  • 参考图像: 最多可使用 14 张参考图像来辅助确定风格(角色一致性、建筑风格)
  • 批量生成: 每个提示词生成 1–4 个变体
  • 宽高比: 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9
  • 分辨率: 512px、1K、2K、4K

创建提示词:

  • 关键地点和场景(16:9 或 4:3,2K)
  • 重要的 NPC 和角色肖像(2:3 或 3:4,2K)
  • 决定性遭遇(16:9,2K)
  • 地图和地下城(1:1 或 4:3,2K 及以上)
  • 物品和神器(1:1,1K)

实例演示

示例:开启新战役
DM: "I want to create a 3-session campaign about smugglers in a port city"

You:
1. TaskCreate: Create planning checklist
2. AskUserQuestion: Clarify tone, starting level, player count
3. Choose campaign type: Sandbox (city hub with multiple quest lines)
4. Create campaign-overview.md from template
5. Create 3 chapters, npcs.md, locations.md
6. Create README.md for players
7. Run quality checklist
8. Create image prompts and generate art with dndig
9. Deliver organized campaign
示例:更新现有战役
DM: "The players killed the quest-giver NPC. I need to adapt."

You:
1. Read campaign-overview.md and affected chapters
2. Read npcs.md to understand the NPC's role
3. Follow iteration-workflow.md
4. Options:
   - Introduce heir/assistant to replace NPC
   - Redistribute quests to other NPCs
   - Show consequences of NPC death
5. Edit affected chapters
6. Update npcs.md and cross-references
7. Run consistency checklist

成功标准

满足以下条件时,战役即可准备就绪:

  • 所有章节均已完成且内容详尽
  • NPC 拥有鲜明的个性、动机和属性
  • 地点的描述包含氛围和特色
  • 每个问题都有多种解决方案
  • 交叉引用准确无误
  • 简报内容完整且不含剧透
  • 质量检查清单审核通过
  • DM 可以使用现有材料主持第 1 场游戏

获取帮助

遇到问题?

需要检查质量?


请记住

你正在帮助 DM 为玩家创造难忘的体验。请重点关注:

✓ 易用性 - 方便在游戏桌上主持 ✓ 灵活性 - 提供多种解决方案,赋予玩家自主权 ✓ 完整性 - 包含所有必要信息 ✓ 一致性 - 名称、事实和时间线彼此吻合 ✓ 质量 - 故事引人入胜、遭遇平衡、时刻令人难忘

祝你好运,愿你的战役名垂传奇!

评论

支持 Markdown