外观
命令总览
屠龙骰是专精 DND5e / DND5r 跑团的 NoneBot2 骰娘插件（OneBot V11 适配器），为 QQ 群跑团提供一站式支持：掷骰表达式、角色卡与检定点命令、HP 管理、先攻列表与战斗轮。
本页是全量速查：先在功能一览挑功能、读名称显示规则与 @ 提及目标了解通用约定，再到命令总表查写法；不知从哪下手就按开始使用的三步走。
版本：v0.3.0。规则范围：仅支持 DND5e/5r。安装与配置见 快速开始。
功能一览
| 功能 | 说明 | 文档 |
|---|---|---|
| 🎲 掷骰表达式 | D20/优势劣势/保留最高/重掷/爆炸骰/连掷/暗骰/原因，仅 D20 有大成功/大失败播报 | 掷骰基础 · 掷骰进阶 |
| 📋 角色卡与属性 | $…$ 模板建卡；.dnd 4D6K3 掷点（.dndx 绑定属性名）；额外加值只装算得进检定的部分 | 角色卡与属性 |
| 🎯 检定与豁免 | .力量检定 .敏捷豁免 .隐匿检定 自动代入调整值/熟练/加值；支持连掷与 @ 代掷 | 检定与豁免 |
| 🗡️ 武器与攻击 | 卡上自定义武器（$武器$ 段）：.刺剑攻击/.刺剑命中 掷攻击检定，.刺剑伤害 报伤害类型并支持 副手/重击/偷袭 后缀 | 武器与攻击 |
| ❤️ HP 与长休 | .hp 记录/伤害/治疗/临时 HP/列表（含 NPC/怪物血量与跨战斗保持）；.长休 一键结算 | HP 与长休 |
| ⚔️ 先攻列表 | .ri 掷先攻入表、.init/.先攻 查看与删除/提前/交换；.先攻检定 自动联动角色卡 | 先攻列表 |
| 🔄 战斗轮 | .br 开局，.回合/.轮次/.ed 推进（.回合±n 可连续跳转），轮到玩家自动 @ 提醒 | 战斗轮 |
| 🧭 DM 实战指南 | 开团前整备 → 开团中检定 → 一次战斗（结算 / 推进 / 暗骰）的完整流程与速查表 | DM 实战指南 |
| ⚙️ 群管理 | .dset 群默认骰面；.bot 群聊服务开关（白名单）与常见问题 | 群管理与 FAQ |
名称显示规则
全插件的玩家名称显示统一按一条回退链取值——所有需要显示玩家名称的地方（掷骰落款、检定/豁免与武器攻击反馈、.dnd 属性生成、HP 相关反馈与列表、先攻入表名等）共用：
角色名（$姓名$）→ 群名片 → QQ 昵称 → 「未知玩家（QQ号）」
即优先取角色卡上的姓名；没有卡名时取群名片，其次 QQ 昵称；都取不到时显示 未知玩家（123456789），便于定位到具体成员。自己触发的命令取消息自带的名称字段；显示他人名称时才查询群成员信息。
以示例团为例——小满的角色是洛恩，小鹿还没建卡（群名片「小鹿」，QQ 昵称「鹿角」）：
小满
.rd
屠龙骰
洛恩 的掷骰结果为 1D20=[7]=7
小鹿
.rd
屠龙骰
小鹿 的掷骰结果为 1D20=[11]=11
先攻列表与 NPC 血量的条目名不参与这条回退链：名称由使用者（一般是 DM）在入表时指定、按字面使用，也不会与玩家绑定（@ 定位不到）。所以没卡的散客入表后，DM 直接用同一个名字结算即可：
白鸦
.ri+1 小鹿
屠龙骰
小鹿的先攻值是 1D20+1=[9]+1=10
白鸦
.hp 小鹿 12/12
屠龙骰
小鹿: HP=12/12 当前HP:12/12
白鸦
.hp 小鹿 -d6+2
屠龙骰
小鹿: 当前HP减少[5]+2=7 HP:12/12 -> HP:5/12
@ 提及目标（DM 代操作）
玩家缺席时，DM 要替他掷骰、结算、推进——多数带目标的命令都支持用 @群成员（下文记作 @玩家）指定目标，直连该成员在本群的角色卡，不受同名 NPC 与角色卡改名的歧义影响；@ 与名称可混写（分隔符 ; 或空白）。此类写法只在群聊适用。
| 场景 | 写法 |
|---|---|
| 代结算 HP | .hp @玩家 -4d6、.hp @玩家;地精 -d4（AOE 混写）、.hp @玩家易伤 -d8、.hp @玩家（查看）、.hp @玩家 @玩家2（查看多名玩家） |
| 代长休 | .长休 @玩家 |
| 代掷检定 | .力量豁免 @玩家、.2#隐匿检定优势 @玩家、.先攻检定 @玩家（以该玩家为归属入表） |
| 代掷武器攻击 / 伤害 | .刺剑攻击 @玩家、.刺剑重击伤害 @玩家（用目标角色卡上的武器项） |
| 代掷先攻 | .ri+3 @玩家（条目名取角色卡名并与该玩家绑定，重掷替换、回合提醒与 .hp 解析同步生效） |
| 按玩家定位条目 | .init del @玩家、.init first @玩家、.init swap @玩家/兽人、.回合 @玩家（改名后仍有效） |
| 查看他人角色卡 / 状态 | .角色卡 @玩家（或 .角色卡 角色名）、.状态 @玩家（查看对任何人开放；记录/清除仅限本人） |
约定：
- @ 目标需该成员已在本群建立角色卡，否则骰娘用 @ 回复并引导建卡（
.角色卡记录）； @机器人自身不作为目标（@屠龙骰 .hp -d4仍按发送者自己结算）；- 游离 @（未写在正确的目标位置，如
.hp -4d6 @玩家、@玩家 .hp -4d6）不执行并回纠正示例，避免误结算到发送者自己；.ri的提示为「目标请写在表达式右侧」； .ri 3#@玩家不支持批量写法（提示直接写条目名称）；.hp del/clr与.npc是 NPC 专用命令，@ 到玩家会提示不适用（移除玩家先攻条目用.init del）。
DM 视角的完整流程（代掷、代结算、代推进）见 DM 实战指南。
命令总表
下表按「基础 → 进阶 → DM → 群管理」分组列出全部命令；「场景」列写明可用范围与权限，没有标注权限的命令所有成员都能用。检定点命令（.力量检定 等）按消息模式触发，写作规则见检定与豁免。
基础
| 命令 | 说明 | 场景 |
|---|---|---|
.r [N#][hs][表达式] [原因] | 掷骰表达式（# 连掷 1~10、h 暗骰、s 只显数值） | 群聊 / 私聊 |
.rh [表达式] [原因] | 暗骰：群内只播一句提示，结果私聊掷骰者 | 群聊 / 私聊 |
.dnd [次数] [原因] | 4D6K3 掷点生成六项属性（降序列表，自行分配） | 群聊 / 私聊 |
.dndx [次数] [原因] | 同上，并按固定顺序绑定属性名（不排序，可直接抄入角色卡） | 群聊 / 私聊 |
进阶
| 命令 | 说明 | 场景 |
|---|---|---|
.角色卡模板 | 查看示例卡与填写提示 | 仅群聊 |
.角色卡记录 + 卡面 | 记录 / 覆盖角色卡（卡面照模板写） | 仅群聊 |
.角色卡 / .角色卡清除 | 查看 / 删除角色卡（记录与清除仅限本人） | 仅群聊 |
.角色卡 @玩家 / .角色卡 角色名 | 查看他人整卡（查看对任何人开放） | 仅群聊 |
.状态 / .状态 @玩家 | 查看自己 / 他人的 HP 与生命骰摘要 | 仅群聊 |
.xx检定（属性/技能/先攻） | 如 .力量检定、.2#察觉检定+1 | 仅群聊 |
.xx豁免 | 属性豁免检定点命令，如 .体质豁免+d4、.感知豁免优势 | 仅群聊 |
.xx检定/豁免 … @玩家 | 表达式右侧加 @ 代掷（用目标角色的属性/熟练/加值） | 仅群聊 |
.武器名攻击 / .武器名命中 | 用卡上该武器的命中加值掷攻击检定（如 .刺剑攻击优势、.2#刺剑攻击+2、.刺剑攻击 @玩家） | 仅群聊 |
.武器名伤害 | 掷该武器伤害并报出类型；后缀 副手/重击/偷袭 可组合（如 .刺剑重击偷袭伤害），尾部可加 ± 临时加值（如 .火球术伤害+1d6） | 仅群聊 |
.设置武器 / .删除武器 | 维护卡上武器（同名覆盖 / 删除，多个用 / 分隔；.设置武器 无参数列出） | 仅群聊 |
.先攻检定 / .先攻检定 @玩家 | 掷先攻并自动写入本群先攻列表（@ 形式以该玩家为归属入表） | 仅群聊 |
.hp [对象] 20/30 (5) | 设置自己 / 队友 / NPC 的 HP（含临时 HP） | 仅群聊 |
.hp [对象] -10 / +2d6 | 伤害 / 治疗（支持掷骰表达式与临时 HP；伤害位置可直接写 -X伤害 用卡上武器项，括号可指定来源代发） | 仅群聊 |
.hp @玩家 … / .hp @玩家 | 对 @ 的玩家角色卡结算 / 查看（@ 与名称可混写） | 仅群聊 |
.hp / .hp list | 查看自己 / 本群列表（PC 在前、NPC 在后） | 仅群聊 |
.hp del 名称 / .hp clr | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 .角色卡清除） | 仅群聊 |
.npc 持久/临时 名称 | NPC 血量跨战斗保持 / 恢复默认（同名 NPC 新入先攻表默认自动回满） | 仅群聊 |
.长休 / .长休 @玩家 | 长休结算（回满 HP、清临时 HP、回复一半生命骰） | 仅群聊 |
DM
| 命令 | 说明 | 场景 |
|---|---|---|
.ri[修正] [名称/…] | 掷先攻入表（.ri18 木乃伊 固定值、.ri+2 2#骷髅 批量、.ri+2 向导/狼 多项） | 仅群聊 |
.ri+2 @玩家 | 代不在场的玩家掷先攻入表（条目名取角色卡名并与该玩家绑定） | 仅群聊 |
.init / .先攻 | 查看先攻列表（del/clr/first/swap 子指令） | 仅群聊 |
.init del/first/swap @玩家 | 子指令按玩家归属定位条目（改名后仍有效） | 仅群聊 |
.br / .战斗轮 | 新建战斗轮（清空先攻表、当前回合） | 仅群聊 |
.回合 / .轮次 | 查看 / 跳转当前回合与轮次（.回合+2 连续推进、.回合 名称 定位） | 仅群聊 |
.回合 @玩家 | 跳转到该玩家的条目（不受改名 / 同名歧义影响） | 仅群聊 |
.ed / .结束 | 结束当前回合并自动推进（可代玩家发） | 仅群聊 |
群管理
| 命令 | 说明 | 场景 |
|---|---|---|
.dset [表达式] | 设置 / 查看群默认骰面（裸 d 用它当默认面数） | 仅群聊；修改需群主 / 管理员 |
.bot | 查看插件信息与本群服务状态 | 群聊（需 @）/ 私聊 |
.bot on / .bot off | 开启 / 关闭本群服务（白名单） | 仅群聊；群主 / 管理员，需 @ |
帮助
| 命令 | 说明 | 场景 |
|---|---|---|
.帮助 / .help | 命令总览 | 群聊 / 私聊 |
.help <命令> | 指定命令的详细用法（如 .help r、.帮助 战斗轮） | 群聊 / 私聊 |
开始使用
当 DM 带团时，再看DM 实战指南把一场战斗从头跑到尾。