屠龙骰（DNDDicer / nonebot-plugin-dnddicer）

专精 DND5e / DND5r 跑团的 NoneBot2 骰娘插件（OneBot V11 适配器）， 命令手感对齐 nonebot-dicepp（梨骰）。

当前版本：v0.2.1 · 完整使用手册见 📖 使用文档

✨ 简介

DNDDicer 的目标是填补「NoneBot 商店中缺少 DND5e/5r 专业 + 现代维护 + 插件形态 骰娘」的空位： 以 DicePP 掷骰引擎与命令手感为基准，做独立的、零配置可加载的 NoneBot 插件，供任何已有 机器人从商店安装即用。

• 掷骰引擎：移植 nonebot-dicepp 的 AST 表达式引擎（Lark 文法），支持 2d20kh1、 优势/劣势、爆炸骰、连掷、暗骰等 DicePP 完整语法面；
• 跑团全流程：掷骰 → .dnd 属性生成 → 角色卡与检定/豁免/攻击点命令 → HP 管理 （伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮；
• 规则范围：仅 DND5e/5r——专精 DND 定位，不做 COC/d100 体系与 .mode 模式切换；
• 商店合规：零配置可加载、本地存储走 nonebot-plugin-localstore、元数据完整、全程异步。

📖 使用文档

详细用法、输入/输出示例与常见问题见仓库 docs/ 使用文档：

• 命令总表与快速开始 · 群管理与 FAQ
• 掷骰语法 · 角色卡与检定
• 属性生成 · HP 管理
• 先攻列表 · 战斗轮

📦 安装

通过 NB-CLI（推荐，与商店安装方式一致）：

nb plugin install nonebot-plugin-dnddicer

或通过包管理器安装后，在 pyproject.toml 的 [tool.nonebot] 中声明加载：

pip install nonebot-plugin-dnddicer

[tool.nonebot]
plugins = ["nonebot_plugin_dnddicer"]

依赖：Python ≥ 3.11，NoneBot2 ≥ 2.4.0，OneBot V11 适配器（nb plugin install 会自动安装依赖）。

⚙️ 配置

插件零配置即可加载运行，以下配置项全部可选（在 .env / 环境变量中设置）：

🎲 用法

命令以 .（或全角 。）开头，中英文别名对齐 DicePP；命令起始符默认仅 . / 。， 如需用宿主斜杠 / 等起始符触发（如 /.help），请设置配置项 dnddicer_use_host_command_starts=true。 群聊服务默认关闭（白名单）：需群主/管理员发送 .bot on 开启本群服务；.bot off 关闭后本群不再响应命令（.bot 本身不受影响）。群聊中使用 .bot 需先 @ 本机器人； 私聊不受服务开关限制，可直接使用全部功能。

DM 代操作（@ 提及目标）：多数带目标的命令支持用 @群成员 指定目标——直连该成员 在本群的角色卡，不受同名 NPC/改名影响，且可与名称混写（.hp @玩家 -4d6、 .hp @玩家;地精 -d4、.ri+3 @玩家、.init del @玩家、.回合 @玩家、 .角色卡 @玩家、.力量豁免 @玩家、.先攻检定 @玩家 等）。详见 使用文档。

🎲 掷骰（群聊 / 私聊）

📋 角色卡与检定（群聊）

🎯 属性生成（群聊 / 私聊）

❤️ HP 与长休（群聊）

⚔️ 先攻与战斗轮（群聊）

⚙️ 群管理（群聊）

一期范围外功能会显式提示而非静默：.r exp 期望值采样、.r a/n 特殊判定； 牌堆/随机表与规则查询（T2）、法术位/死亡豁免/BUFF 表（T3 候选）见下方路线。

📄 版本与路线

1. ✅ v0.1.0（第一期 = T0 + T1 + 战斗轮简化版 + .bot 服务开关）：掷骰引擎移植、.r/.rh、 帮助、群配置（.dset）、角色卡与检定/豁免/攻击、.dnd 属性生成、HP 管理与长休 （含抗性/易伤与 AOE 伤害掷骰）、先攻列表、战斗轮——全部落地，全量测试通过；
2. ✅ v0.2.0：HP 抗性/易伤与 AOE 掷骰完善、.dnd 原因 兼容修复、 NPC/怪物血量（三层目标搜索、先攻列表与 .hp list 联动、.ri 入表自动回满、 .npc 持久/临时 跨战斗保持）、.dndx 属性名绑定掷点；
3. ✅ v0.2.1：@ 提及目标（DM 可代玩家操作 .hp/.npc/.ri/.回合 等、查看角色卡）、 玩家名称显示统一回退链、.hp del/clr 语义修订（仅作用 NPC 血量）、 优势/劣势别名粘连等真机反馈修复；
4. ⏳ 第二期 T2：牌堆/随机表、规则查询；
5. ⏳（可选）T3 增强期：法术位管理（.ss/.cast）、死亡豁免闭环（.ds）、BUFF/临时加值表（.buff）等。

每版完整变更（新增 / 变更 / 修复 / 文档）见 CHANGELOG.md。

📦 本地开发

# uv 方式（推荐；或使用 pip 安装 .[dev]）
uv sync --group dev
uv run pytest

测试基于 nonebug 做 NoneBot 加载冒烟与全命令行为回归（与 NoneFlow 商店自动加载检查同思路）。

🤝 许可与致谢

• 本项目（业务层与工程骨架）以 MIT License 发布，见 LICENSE。
• 掷骰引擎与命令语法移植自 nonebot-dicepp （Copyright (c) 2022 pear-studio，MIT License）：相关文件头保留上游版权声明与 MIT 许可全文，来源按 MIT 要求在 LICENSE 中注明。
• 规则查询类资料内容不随插件分发（版权归原权利方/译者），需要时由使用者自行提供。
• 本项目与 nonebot-dicepp 无隶属关系，为独立命名的衍生/移植作品。