D&D 5e AI 地下城主引擎

基于 2024版 D&D 5e 规则 的 AI 地下城主系统。纯对话交互，不需要专用客户端，任何 IM 软件即可运行。

快速开始

1. 部署到工作目录

将本 skill 的 references/ 目录下的所有文件复制到你的 OpenClaw 工作目录根目录：

your-workspace/
├── DM_RULES.md          ← DM 运行规则（核心）
├── DM_TEMPLATES.md      ← 信息展示模板
├── DM_MAP_SYS.md        ← 地图生成系统
├── CHAR_CREATION.md     ← 角色创建流程
├── MODULE_ARC.md        ← 模组剧情框架
├── MODULE_INDEX.md      ← 模组信息索引
├── SOUL.md / IDENTITY.md ← DM 人格文件
├── live_party.json      ← 实时角色状态（运行中自动维护）
├── rules/               ← [自行准备] 2024版三宝书
│   ├── 玩家手册（2024）.md
│   ├── 城主指南 (2024).md
│   └── 怪物图鉴（2025）.md
├── modules/             ← [自行准备] D&D 模组文件
│   └── 博德之门_ 坠入阿弗纳斯 - Ch.*.md
└── saves/               ← [自动生成] 存档目录

注意：rules/ 和 modules/ 目录下的规则书和模组文件受版权保护，需要用户自行准备。

2. 配置技能

在 ~/.config/openclaw/agents.yaml 中配置此 skill：

agent:
  name: dnd-dm
  skills:
    - dnd-dm

3. 首次运行

启动后，城主会自动：

检查 saves/ 中的存档
提供载入存档 / 新开一局 / 查看存档选项
如新开一局，进入对话式角色创建

功能概览

🎲 规则裁决

严格按 2024版 规则结算（6步检定流程）
18种技能检定 + 战斗 + 法术 + 动作经济
自然1不重投，公平透明

⚔️ 战斗系统

先攻表（表格展示，排序+HP+AC+位置+状态）
每轮结束后自动展示更新后的战斗态势表
已死亡单位划掉、当前行动者标记

📋 信息展示

4种标准模板：剧情整理 / 房间布局 / 战斗态势 / 地形图
任务清单（主线+支线，含状态追踪）
实时角色卡查询（单角色 / 队伍总览 / 物品检索）

🧙 角色创建

7阶段对话式角色创建
属性分配、种族、职业、背景、技能、装备、法术选择
当前属性自动记录到 live_party.json

💾 存档系统

saves/存档*.json：断点续玩
live_party.json：实时角色状态（每次变更后立即更新）
存档触发：升级、长休、章节结束、玩家要求、重大决策前

🔒 行为红线（15条）

禁止偏离模组、禁止放水、禁止混用世界观
规则锁定（2024版 > 旧版）、自然1不重投
禁止提前加载后续章节、禁止跳过检定流程

文件说明

| 文件 | 说明 | |------|------| | DM_RULES.md | 核心规则，包含所有14条运行规则（含存档、升级、战斗展示、实时状态维护） | | DM_TEMPLATES.md | 展示模板：剧情整理、房间布局、战斗态势表（表格版）、地形图、任务清单、角色卡 | | DM_MAP_SYS.md | 地图生成系统：Excel地图 + emoji标记 + 坐标查询 | | CHAR_CREATION.md | 对话式角色创建的7阶段流程 | | MODULE_ARC.md | 模组剧情框架定义模板 | | MODULE_INDEX.md | 模组关键信息索引模板 | | SOUL.md / IDENTITY.md | DM 人格定义文件 | | live_party.json | 实时角色状态 JSON（运行中自动维护） |

场景描述格式标准

运行时城主使用以下标记格式描述场景：

[交互物] — 可互动的物体/位置
【NPC】 — 非玩家角色
"对话" — 引号内为NPC对话

升级与存档要求

升级时：完整记录角色全部属性、技能、专长、戏法、法术、装备、职业特性
存档时：保存完整的角色状态 + 任务状态
后续升级基于前一次完整记录递增，不从零重建

版本 1.0.6 · 2026-05-21 · 基于2024版D&D 5e规则