nonebot-plugin-dnddicer 0.2.2__tar.gz → 0.3.0__tar.gz

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/.github/workflows/docs.yml

@@ -6,6 +6,12 @@
 #
 # 首次使用：仓库 Settings → Pages → Source 选「GitHub Actions」。
 # 未启用前本工作流会自动跳过（保持绿色），启用后无需再改任何配置。
+#
+# 注意（tag 部署被拒时查这里）：启用 Pages 后 GitHub 会自动建 `github-pages` 环境，
+# 其「Deployment branches and tags」默认只允许默认分支部署——tag 推送会在 deploy 步
+# 被拒（annotations 提示 not allowed due to environment protection rules）。
+# 解法：Settings → Environments → github-pages → 放行标签（选 Selected branches and
+# tags 加一条 Tag 规则 `v*`，并保留分支 main 供手动预览；或直接选 All branches and tags）。
 name: docs
 
 on:

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/.gitignore

@@ -34,6 +34,9 @@ env/
 AGENTS.md
 doc/
 
+# ---- 项目记忆（随项目目录存放、不入库；根目录限定，避免误伤同名子目录）----
+/memory/
+
 # ---- 编辑器/系统 ----
 .vscode/
 .idea/

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/CHANGELOG.md

@@ -8,6 +8,28 @@
 - 打 `v*` 标签前，请先在下方补好该版本的小节（标题格式 `## [x.y.z] - 日期`）：发布时 `.github/workflows/release.yml` 会提取与所推标签同名的小节作为 GitHub Release 的说明正文，缺小节即会在构建前直接失败。
 -->
 
+## [0.3.0] - 2026-09-25
+
+### 新增
+
+- **自定义武器与攻击系统**：
+    - 角色卡新增 `$武器$` 段（`名称+命中加值,伤害表达式+类型`，多项用 `/` 分隔；名称尾加 `x` 表示不可攻击检定的纯伤害法术），并新增 `$种族$` / `$职业$` / `$子职$` 段（游荡者的偷袭骰按等级自动计算）。
+    - `.武器名攻击` / `.武器名命中`：用卡上该武器的命中加值掷攻击检定，支持 优势/劣势、`N#` 连掷、`±` 临时加值与 `@玩家` 代掷；天然 20 提示重击、天然 1 提示必失。
+    - `.武器名伤害`：掷该武器的伤害并报出伤害类型，`副手` / `重击` / `偷袭` 后缀可组合、可加 `±` 临时加值。
+    - `.设置武器` / `.删除武器`：便捷维护卡上武器（列表查看、同名覆盖、多名称删除）。
+- **`.hp` 伤害位置支持武器写法**：
+    - `.hp 骷髅a易伤 -战锤重击伤害+1d4` 一条命令完成掷伤与扣血；回复先报「谁用【哪件武器】造成了多少伤害」，再列出各目标的扣血读数（单目标报实际结算值、含抗性/易伤折算；一发多目标报掷出的原始值）。
+    - DM 代发不在场的玩家：尾部括号指定武器来源（`.hp 骷髅b -火焰箭伤害（洛恩）` 或 `（@玩家）`，角色名支持模糊匹配）。
+
+### 变更
+
+- **属性攻击命令退役（破坏性变更）**：`.力量攻击` 等六属性攻击命令整体移除，攻击检定统一走角色卡 `$武器$` 项；`$熟练$` 与 `$额外加值$` 不再接受攻击条目（含全局「攻击」键），攻击加值一律折算进武器项。**旧角色卡需重新登记**：新版本读取旧卡会报错，发送 `.角色卡清除` 后重录即可。
+- `.bot` 简介与插件描述补充「自定义武器与攻击」表述。
+
+### 文档
+
+- 使用文档站新增《武器与攻击》页，全站手册同步（检定与豁免、角色卡与属性、DM 实战指南、HP 与长休、命令总览与 FAQ 等）；示例团四张角色卡补齐武器与职业段，战斗示例统一到武器流程。
+
 ## [0.2.2] - 2026-09-24
 
 ### 变更

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: nonebot-plugin-dnddicer
-Version: 0.2.2
-Summary: 专精 DND5e/5r 跑团的 NoneBot2 骰娘插件（屠龙骰）：掷骰表达式、角色卡与检定、属性生成、HP 管理、先攻列表、战斗轮等
+Version: 0.3.0
+Summary: 专精 DND5e/5r 跑团的 NoneBot2 骰娘插件（屠龙骰）：掷骰表达式、角色卡与检定、自定义武器与攻击、属性生成、HP 管理、先攻列表、战斗轮等
 Project-URL: Homepage, https://github.com/H-Elden/nonebot-plugin-dnddicer
 Project-URL: Issues, https://github.com/H-Elden/nonebot-plugin-dnddicer/issues
 Project-URL: Repository, https://github.com/H-Elden/nonebot-plugin-dnddicer.git
@@ -32,14 +32,14 @@ Description-Content-Type: text/markdown
 
 > 专精 **DND5e / DND5r** 跑团的 [NoneBot2](https://nonebot.dev/) 骰娘插件（OneBot V11 适配器），致力于做功能最全面、体验最好的 DND 骰娘。
 >
-> 当前版本：**v0.2.2** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**
+> 当前版本：**v0.3.0** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**
 
 ## ✨ 简介
 
 DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代维护 + 插件形态** 骰娘」的空位：围绕 DND 跑团全流程持续做深做全，致力于提供功能最全面、体验最好的 DND 骰娘，零配置可加载，供任何已有机器人从商店安装即用。
 
 - **掷骰引擎**：内置 AST 表达式引擎（Lark 文法），支持 `2d20kh1`、优势/劣势、爆炸骰、连掷、暗骰等完整掷骰语法；
-- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免/攻击点命令 → HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮；
+- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮；
 - **规则范围**：仅 DND5e/5r——专精 DND 定位，不做 COC/D100 体系与 `.mode` 模式切换；
 - **商店合规**：零配置可加载、本地存储走 `nonebot-plugin-localstore`、元数据完整、全程异步。
 
@@ -49,7 +49,7 @@ DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代
 
 - 开始：[快速开始](./docs/guide/quickstart.md) · [示例团与人物](./docs/guide/cast.md)
 - 第一章 · 基础操作：[掷骰基础](./docs/guide/roll-basics.md) · [掷骰进阶](./docs/guide/roll-advanced.md) · [先攻列表](./docs/guide/initiative.md)
-- 第二章 · 进阶操作：[角色卡与属性](./docs/guide/character-card.md) · [检定与豁免](./docs/guide/checks.md) · [HP 与长休](./docs/guide/hp-rest.md) · [战斗轮](./docs/guide/battle.md)
+- 第二章 · 进阶操作：[角色卡与属性](./docs/guide/character-card.md) · [检定与豁免](./docs/guide/checks.md) · [武器与攻击](./docs/guide/weapons.md) · [HP 与长休](./docs/guide/hp-rest.md) · [战斗轮](./docs/guide/battle.md)
 - 第三章 · DM 操作：[DM 实战指南](./docs/guide/dm-guide.md)
 - 参考 · [命令总览](./docs/guide/overview.md) · [群管理与 FAQ](./docs/guide/faq.md)
 
@@ -107,9 +107,23 @@ plugins = ["nonebot_plugin_dnddicer"]
 | `.角色卡 @玩家` / `.角色卡 角色名` | 查看**他人**整卡（任何人可查看；记录/清除仅限本人） |
 | `.状态 @玩家` | 查看他人的 HP 与生命骰摘要 |
 | `.力量检定` / `.察觉检定+1` 等 | 属性/技能/先攻检定点命令，自动代入调整值/熟练/加值（`2#` 连掷、`+d4` 等可追加；表达式右侧可加 `@玩家` 代掷） |
-| `.体质豁免` / `.敏捷攻击优势` 等 | 豁免/攻击点命令（原名直配，优势/劣势后缀；同样支持尾部 `@玩家`） |
+| `.体质豁免` / `.感知豁免优势` 等 | 豁免点命令（原名直配，优势/劣势后缀；同样支持尾部 `@玩家`） |
 | `.先攻检定` / `.先攻检定 @玩家` | 掷先攻并自动写入本群先攻列表（@ 形式代不在场的玩家掷） |
 
+### 🗡️ 武器与攻击（群聊）
+
+角色卡通过 `$武器$` 段自定义武器/法术项：`名称+命中加值,伤害表达式+类型`，如 `长剑+8,1d8+5挥砍`；名称尾加 `x` 表示不可攻击检定，如 `火球术x,8d6火焰`。
+
+骰娘只忠实执行、不判 AC、不自动补属性：
+
+| 命令 | 说明 |
+| --- | --- |
+| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击） |
+| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`） |
+| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 删除，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
+
+详见 [武器与攻击](./docs/guide/weapons.md)。
+
 ### 🎯 属性生成（群聊 / 私聊）
 
 | 命令 | 说明 |
@@ -122,7 +136,7 @@ plugins = ["nonebot_plugin_dnddicer"]
 | 命令 | 说明 |
 | --- | --- |
 | `.hp [对象] 20/30 (5)` | 设置自己/队友/NPC HP（含临时 HP；先 `.ri 名称` 入先攻表后即可记录 NPC 血量） |
-| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
+| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
 | `.hp @玩家 …` / `.hp @玩家` | 对 @ 的玩家角色卡结算 / 查看（`.hp @玩家 -4d6`、`.hp @玩家;地精 -d4` 与名称混写；需该玩家已建卡） |
 | `.hp` / `.hp list` | 查看自己 / 本群列表（PC + NPC） |
 | `.hp del 名称` / `.hp clr` | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 `.角色卡清除`，玩家先攻条目用 `.init del`） |
@@ -158,8 +172,9 @@ plugins = ["nonebot_plugin_dnddicer"]
 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. ✅ **v0.2.2**：掷骰说明文字按四则运算还原（常量复合子表达式与一元负号）、私聊下的群聊限定命令不再静默与 `.bot` 私聊文案修正；**使用文档站上线**（手册式 15 页，随发版自动部署）；
-5. ⏳ **第二期 T2**：牌堆/随机表、规则查询；
-6. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
+5. ✅ **v0.3.0**：**自定义武器与攻击系统**（`$武器$` 段、`.武器名攻击` / `.武器名伤害`、`.设置武器` / `.删除武器`）、`.hp` 伤害位置武器写法（含来源括号代发）；**属性攻击命令退役**（破坏性变更，旧卡需重录）、文档站新增《武器与攻击》页与全站同步；
+6. ⏳ **第二期 T2**：牌堆/随机表、规则查询；
+7. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
 
 每版完整变更（新增 / 变更 / 修复 / 文档）见 [CHANGELOG.md](./CHANGELOG.md)。
 

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/README.md

@@ -2,14 +2,14 @@
 
 > 专精 **DND5e / DND5r** 跑团的 [NoneBot2](https://nonebot.dev/) 骰娘插件（OneBot V11 适配器），致力于做功能最全面、体验最好的 DND 骰娘。
 >
-> 当前版本：**v0.2.2** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**
+> 当前版本：**v0.3.0** · 完整使用手册见 **📖 [使用文档](https://h-elden.github.io/nonebot-plugin-dnddicer/)**
 
 ## ✨ 简介
 
 DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代维护 + 插件形态** 骰娘」的空位：围绕 DND 跑团全流程持续做深做全，致力于提供功能最全面、体验最好的 DND 骰娘，零配置可加载，供任何已有机器人从商店安装即用。
 
 - **掷骰引擎**：内置 AST 表达式引擎（Lark 文法），支持 `2d20kh1`、优势/劣势、爆炸骰、连掷、暗骰等完整掷骰语法；
-- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免/攻击点命令 → HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮；
+- **跑团全流程**：掷骰 → `.dnd` 属性生成 → 角色卡与检定/豁免点命令 → 自定义武器与攻击（`.X攻击`/`.X伤害`）/ HP 管理（伤害掷骰、抗性/易伤、AOE 多目标结算、长休）→ 先攻列表与战斗轮；
 - **规则范围**：仅 DND5e/5r——专精 DND 定位，不做 COC/D100 体系与 `.mode` 模式切换；
 - **商店合规**：零配置可加载、本地存储走 `nonebot-plugin-localstore`、元数据完整、全程异步。
 
@@ -19,7 +19,7 @@ DNDDicer 的目标是填补「NoneBot 商店中缺少 **DND5e/5r 专业 + 现代
 
 - 开始：[快速开始](./docs/guide/quickstart.md) · [示例团与人物](./docs/guide/cast.md)
 - 第一章 · 基础操作：[掷骰基础](./docs/guide/roll-basics.md) · [掷骰进阶](./docs/guide/roll-advanced.md) · [先攻列表](./docs/guide/initiative.md)
-- 第二章 · 进阶操作：[角色卡与属性](./docs/guide/character-card.md) · [检定与豁免](./docs/guide/checks.md) · [HP 与长休](./docs/guide/hp-rest.md) · [战斗轮](./docs/guide/battle.md)
+- 第二章 · 进阶操作：[角色卡与属性](./docs/guide/character-card.md) · [检定与豁免](./docs/guide/checks.md) · [武器与攻击](./docs/guide/weapons.md) · [HP 与长休](./docs/guide/hp-rest.md) · [战斗轮](./docs/guide/battle.md)
 - 第三章 · DM 操作：[DM 实战指南](./docs/guide/dm-guide.md)
 - 参考 · [命令总览](./docs/guide/overview.md) · [群管理与 FAQ](./docs/guide/faq.md)
 
@@ -77,9 +77,23 @@ plugins = ["nonebot_plugin_dnddicer"]
 | `.角色卡 @玩家` / `.角色卡 角色名` | 查看**他人**整卡（任何人可查看；记录/清除仅限本人） |
 | `.状态 @玩家` | 查看他人的 HP 与生命骰摘要 |
 | `.力量检定` / `.察觉检定+1` 等 | 属性/技能/先攻检定点命令，自动代入调整值/熟练/加值（`2#` 连掷、`+d4` 等可追加；表达式右侧可加 `@玩家` 代掷） |
-| `.体质豁免` / `.敏捷攻击优势` 等 | 豁免/攻击点命令（原名直配，优势/劣势后缀；同样支持尾部 `@玩家`） |
+| `.体质豁免` / `.感知豁免优势` 等 | 豁免点命令（原名直配，优势/劣势后缀；同样支持尾部 `@玩家`） |
 | `.先攻检定` / `.先攻检定 @玩家` | 掷先攻并自动写入本群先攻列表（@ 形式代不在场的玩家掷） |
 
+### 🗡️ 武器与攻击（群聊）
+
+角色卡通过 `$武器$` 段自定义武器/法术项：`名称+命中加值,伤害表达式+类型`，如 `长剑+8,1d8+5挥砍`；名称尾加 `x` 表示不可攻击检定，如 `火球术x,8d6火焰`。
+
+骰娘只忠实执行、不判 AC、不自动补属性：
+
+| 命令 | 说明 |
+| --- | --- |
+| `.刺剑攻击` / `.刺剑命中` | 用卡上该武器的命中加值掷攻击检定（`优势`/`劣势`、`N#` 连掷、`±` 临时加值、`@玩家` 代掷；天然 20 提示重击） |
+| `.刺剑伤害` | 掷该武器伤害并报出类型；后缀 `副手`（不加任何加值）/ `重击`（骰数翻倍）/ `偷袭`（游荡者按等级自动附加偷袭骰）可组合，尾部可加 `±` 临时加值（如升环 `.火球术伤害+1d6`） |
+| `.设置武器` / `.删除武器` | 维护卡上武器（同名覆盖 / 删除，多个用 `/` 分隔；`.设置武器` 无参数列出当前武器） |
+
+详见 [武器与攻击](./docs/guide/weapons.md)。
+
 ### 🎯 属性生成（群聊 / 私聊）
 
 | 命令 | 说明 |
@@ -92,7 +106,7 @@ plugins = ["nonebot_plugin_dnddicer"]
 | 命令 | 说明 |
 | --- | --- |
 | `.hp [对象] 20/30 (5)` | 设置自己/队友/NPC HP（含临时 HP；先 `.ri 名称` 入先攻表后即可记录 NPC 血量） |
-| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
+| `.hp [对象] -2d6+3` 等 | 伤害/治疗（支持掷骰表达式；伤害位置可直接写 `-武器名伤害`，如 `-战锤重击伤害+1d4`，对应发送者卡上武器项、尾部括号可指定来源代发；目标后加 `抗性`/`易伤` 后缀可减半/加倍，分号分隔多目标同发结算） |
 | `.hp @玩家 …` / `.hp @玩家` | 对 @ 的玩家角色卡结算 / 查看（`.hp @玩家 -4d6`、`.hp @玩家;地精 -d4` 与名称混写；需该玩家已建卡） |
 | `.hp` / `.hp list` | 查看自己 / 本群列表（PC + NPC） |
 | `.hp del 名称` / `.hp clr` | 删除单个 / 清空全部 NPC 血量记录（玩家角色卡请用 `.角色卡清除`，玩家先攻条目用 `.init del`） |
@@ -128,8 +142,9 @@ plugins = ["nonebot_plugin_dnddicer"]
 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. ✅ **v0.2.2**：掷骰说明文字按四则运算还原（常量复合子表达式与一元负号）、私聊下的群聊限定命令不再静默与 `.bot` 私聊文案修正；**使用文档站上线**（手册式 15 页，随发版自动部署）；
-5. ⏳ **第二期 T2**：牌堆/随机表、规则查询；
-6. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
+5. ✅ **v0.3.0**：**自定义武器与攻击系统**（`$武器$` 段、`.武器名攻击` / `.武器名伤害`、`.设置武器` / `.删除武器`）、`.hp` 伤害位置武器写法（含来源括号代发）；**属性攻击命令退役**（破坏性变更，旧卡需重录）、文档站新增《武器与攻击》页与全站同步；
+6. ⏳ **第二期 T2**：牌堆/随机表、规则查询；
+7. ⏳（可选）**T3 增强期**：法术位管理（`.ss/.cast`）、死亡豁免闭环（`.ds`）、BUFF/临时加值表（`.buff`）等。
 
 每版完整变更（新增 / 变更 / 修复 / 文档）见 [CHANGELOG.md](./CHANGELOG.md)。
 

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/docs/.vitepress/config.mts

@@ -49,6 +49,7 @@ export default defineConfig({
         items: [
           { text: '角色卡与属性', link: '/guide/character-card' },
           { text: '检定与豁免', link: '/guide/checks' },
+          { text: '武器与攻击', link: '/guide/weapons' },
           { text: 'HP 与长休', link: '/guide/hp-rest' },
           { text: '战斗轮', link: '/guide/battle' },
         ],

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/docs/guide/cast.md

@@ -32,7 +32,7 @@
 四张卡按 **2024 版核心规则**建（玩家手册 / 城主指南 / 怪物图鉴，无扩展）：
 
 - **27 点购点**定基础属性 → 叠加**背景属性加值**（2024 起物种不再给属性加值）→ 再叠加 **4 级属性提升**；熟练项只登记该角色真实拥有的条目；
-- 额外加值只写「算得进检定」的部分（例如魔法武器的伤害加值由 DM 结算，不登记在卡上）。
+- 额外加值只写「算得进属性检定」的部分；武器类加值（含魔法武器的 +1）直接计入 `$武器$` 项的命中与伤害。
 
 展开以下文本，可以直接复制发送给骰娘，进行角色卡记录。
 
@@ -40,41 +40,56 @@
 
 ```text
 $姓名$ 薇拉
+$种族$ 人类
+$职业$ 圣武士
+$子职$ 奉献之誓
 $等级$ 5
 $生命值$ 54/54
 $生命骰$ 5/5 D10
 $属性$ 18/10/14/8/10/16
-$熟练$ 力量攻击/感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
-$额外加值$ 力量攻击:+1
+$熟练$ 感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
+$武器$ 长剑+8,1d8+5挥砍
 ```
 
 ```text
 $姓名$ 洛恩
+$种族$ 精灵
+$职业$ 法师
+$子职$ 塑能师
 $等级$ 5
 $生命值$ 37/37
 $生命骰$ 5/5 D6
 $属性$ 8/15/16/18/10/8
-$熟练$ 敏捷攻击/智力豁免/感知豁免/2*奥秘/历史/调查/宗教/察觉
+$熟练$ 智力豁免/感知豁免/2*奥秘/历史/调查/宗教/察觉
+$武器$ 火焰箭+7,2d10火焰/匕首+5,1d4+2穿刺
 ```
 
 ```text
 $姓名$ 塔莉
+$种族$ 半身人
+$职业$ 游荡者
+$子职$ 盗贼
 $等级$ 5
 $生命值$ 43/43
 $生命骰$ 5/5 D8
 $属性$ 8/18/16/10/14/10
-$熟练$ 敏捷攻击/敏捷豁免/智力豁免/2*隐匿/2*巧手/先攻/欺瞒/察觉/游说/洞悉
+$熟练$ 敏捷豁免/智力豁免/2*隐匿/2*巧手/先攻/欺瞒/察觉/游说/洞悉
 $额外加值$ 隐匿:优势
+$武器$ 刺剑+7,1d8+4穿刺/匕首+7,1d4+4穿刺
 ```
 
 ```text
 $姓名$ 布鲁姆
+$种族$ 矮人
+$职业$ 牧师
+$子职$ 生命领域
 $等级$ 5
 $生命值$ 48/48
 $生命骰$ 5/5 D8
 $属性$ 14/8/16/8/18/11
-$熟练$ 力量攻击/感知豁免/魅力豁免/医药/游说/洞悉/宗教
+$熟练$ 感知豁免/魅力豁免/医药/游说/洞悉/宗教
 $额外加值$ 隐匿:劣势/豁免:+1
+$武器$ 战锤+5,1d8+2钝击
 ```
 
 :::
@@ -95,16 +110,21 @@ $额外加值$ 隐匿:劣势/豁免:+1
 | 豁免熟练 | 感知、魅力 | 智力、感知 | 敏捷、智力 | 感知、魅力 |
 | 技能熟练 | 士兵：运动、威吓；<br>职业：洞悉、游说；<br>物种：察觉 | 学者：奥秘、历史；<br>职业：调查、宗教；<br>物种：察觉 | 罪犯：巧手、隐匿；<br>职业：欺瞒、察觉、游说、洞悉 | 侍僧：洞悉、宗教；<br>职业：医药、游说 |
 | 专精 | — | 奥秘（职业） | 隐匿、巧手（职业） | — |
-| 攻击熟练 | 力量攻击（长剑、标枪） | 敏捷攻击（匕首、轻弩） | 敏捷攻击（刺剑、匕首、短弓） | 力量攻击（战锤） |
+| 武器熟练 | 长剑、标枪 | 匕首、轻弩 | 刺剑、匕首、短弓 | 战锤 |
 | 武器精通 | 长剑（削弱）、标枪（缓速） | —（法师无此特性） | 刺剑（侵扰）、匕首（迅击） | —（牧师无此特性） |
-| 额外加值 | 力量攻击:+1<br>（长剑 +1，非普通） | — | 隐匿:优势<br>（精灵之靴，非普通） | 隐匿:劣势（链甲）；<br>豁免:+1（防护斗篷，非普通） |
+| 额外加值 | —<br>（长剑 +1，非普通；加值计入武器项） | — | 隐匿:优势<br>（精灵之靴，非普通） | 隐匿:劣势（链甲）；<br>豁免:+1（防护斗篷，非普通） |
+| 武器 | 长剑+8,1d8+5挥砍 | 火焰箭+7,2d10火焰；<br>匕首+5,1d4+2穿刺 | 刺剑+7,1d8+4穿刺；<br>匕首+7,1d4+4穿刺 | 战锤+5,1d8+2钝击 |
 
 要点：
 - **属性加值来自背景**（2024 起物种不再给属性加值，改为给特性）；
 - **生命值**按「1 级取生命骰最大值 + 体质调整值，其后每级取职业固定值 + 体质调整值」计算（圣武士 6、牧师与游荡者 5、法师 4），再加上物种与专长的固定加值（矮人刚毅每级 +1、健壮每级 +2）；
 - **熟练加值**（5 级）为 +3；
 - **调整值**为 (属性 − 10) ÷ 2 向下取整；
-- **额外加值**只登记算得进检定的部分，来源为 2024 城主指南的魔法物品（5–10 级开卡时给 1 件普通 + 1 件非普通）。
+- **额外加值**只登记算得进属性检定的部分，来源为 2024 城主指南的魔法物品（5–10 级开卡时给 1 件普通 + 1 件非普通）；
+- **武器项**（`$武器$` 段）的数值：
+    - 命中加值 = 攻击属性调整 + 熟练加值（+ 魔法加值）；
+    - 伤害加值 = 攻击属性调整（+ 魔法加值）；
+    - 伤害类型照武器实际记录（供伤害提示与后续特性使用），详见[武器与攻击](./weapons.md)。
 
 ## 群里的第一幕
 
@@ -120,12 +140,15 @@ $额外加值$ 隐匿:劣势/豁免:+1
 ::: chat
 阿茶 | .角色卡记录
 $姓名$ 薇拉
+$种族$ 人类
+$职业$ 圣武士
+$子职$ 奉献之誓
 $等级$ 5
 $生命值$ 54/54
 $生命骰$ 5/5 D10
 $属性$ 18/10/14/8/10/16
-$熟练$ 力量攻击/感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
-$额外加值$ 力量攻击:+1
+$熟练$ 感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
+$武器$ 长剑+8,1d8+5挥砍
 屠龙骰 | 角色卡已设置
 
 注：另外三张卡的记录结果相同（都回「角色卡已设置」），卡面见上方折叠块。
@@ -137,7 +160,7 @@ $额外加值$ 力量攻击:+1
 | --- | --- |
 | ① 开群与建卡 | 群主开启本群服务；四名玩家登记角色卡 |
 | ② 旅店试骰 | 出发前的掷骰（基本表达式、优势/劣势、暗骰、连掷） |
-| ③ 探路检定 | 属性 / 技能 / 豁免 / 攻击检定点命令，含 DM 代掷 |
+| ③ 探路检定 | 属性 / 技能 / 豁免检定点命令，含 DM 代掷 |
 | ④ 碎星隘口遭遇战 | 批量先攻、战斗轮推进、HP / AOE / 抗性易伤结算（含 NPC 与亡灵） |
 | ⑤ 战利与长休 | 战后恢复：长休、生命骰回复 |
 | ⑥ 收尾与清场 | 清空先攻表与 NPC 血量记录 |

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/docs/guide/changelog.md

@@ -14,6 +14,28 @@ editLink: false
 - 打 `v*` 标签前，请先在下方补好该版本的小节（标题格式 `## [x.y.z] - 日期`）：发布时 `.github/workflows/release.yml` 会提取与所推标签同名的小节作为 GitHub Release 的说明正文，缺小节即会在构建前直接失败。
 -->
 
+## [0.3.0] - 2026-09-25
+
+### 新增
+
+- **自定义武器与攻击系统**：
+    - 角色卡新增 `$武器$` 段（`名称+命中加值,伤害表达式+类型`，多项用 `/` 分隔；名称尾加 `x` 表示不可攻击检定的纯伤害法术），并新增 `$种族$` / `$职业$` / `$子职$` 段（游荡者的偷袭骰按等级自动计算）。
+    - `.武器名攻击` / `.武器名命中`：用卡上该武器的命中加值掷攻击检定，支持 优势/劣势、`N#` 连掷、`±` 临时加值与 `@玩家` 代掷；天然 20 提示重击、天然 1 提示必失。
+    - `.武器名伤害`：掷该武器的伤害并报出伤害类型，`副手` / `重击` / `偷袭` 后缀可组合、可加 `±` 临时加值。
+    - `.设置武器` / `.删除武器`：便捷维护卡上武器（列表查看、同名覆盖、多名称删除）。
+- **`.hp` 伤害位置支持武器写法**：
+    - `.hp 骷髅a易伤 -战锤重击伤害+1d4` 一条命令完成掷伤与扣血；回复先报「谁用【哪件武器】造成了多少伤害」，再列出各目标的扣血读数（单目标报实际结算值、含抗性/易伤折算；一发多目标报掷出的原始值）。
+    - DM 代发不在场的玩家：尾部括号指定武器来源（`.hp 骷髅b -火焰箭伤害（洛恩）` 或 `（@玩家）`，角色名支持模糊匹配）。
+
+### 变更
+
+- **属性攻击命令退役（破坏性变更）**：`.力量攻击` 等六属性攻击命令整体移除，攻击检定统一走角色卡 `$武器$` 项；`$熟练$` 与 `$额外加值$` 不再接受攻击条目（含全局「攻击」键），攻击加值一律折算进武器项。**旧角色卡需重新登记**：新版本读取旧卡会报错，发送 `.角色卡清除` 后重录即可。
+- `.bot` 简介与插件描述补充「自定义武器与攻击」表述。
+
+### 文档
+
+- 使用文档站新增《武器与攻击》页，全站手册同步（检定与豁免、角色卡与属性、DM 实战指南、HP 与长休、命令总览与 FAQ 等）；示例团四张角色卡补齐武器与职业段，战斗示例统一到武器流程。
+
 ## [0.2.2] - 2026-09-24
 
 ### 变更

{nonebot_plugin_dnddicer-0.2.2 → nonebot_plugin_dnddicer-0.3.0}/docs/guide/character-card.md

@@ -1,6 +1,8 @@
 # 角色卡与属性
 
-角色卡是检定的基础：把等级、六属性、熟练与额外加值登记成一张卡，之后用 `.力量检定`、`.敏捷豁免`、`.力量攻击` 这类点命令时，骰娘会自动代入卡上的加值，不必每次手写算式。
+角色卡是检定的基础：把等级、六属性、熟练与额外加值登记成一张卡，之后用 `.力量检定`、`.敏捷豁免`、`.隐匿检定` 这类点命令时，骰娘会自动代入卡上的加值，不必每次手写算式。
+
+攻击检定与伤害掷骰需要手动录卡，走卡上的 `$武器$` 条目，见[武器与攻击](./weapons.md)）。
 
 本页解决两件事——**属性从哪来**、**卡怎么登记**；卡登记好之后怎么掷检定，见[检定与豁免](./checks.md)。
 
@@ -58,44 +60,57 @@ $属性$ 9/15/15/15/12/9
 ::: chat
 小鹿 | .角色卡模板
 屠龙骰 | $姓名$ 张三
+$种族$ 半精灵
+$职业$ 游荡者
+$子职$ 刺客
 $生命值$ 20/30 (5)
 $生命骰$ 3/4 D8
 $等级$ 4
 $属性$ 10/15/12/13/8/11
-$熟练$ 体操/2*隐匿/敏捷豁免/敏捷攻击
-$额外加值$ 敏捷攻击:+1d4/豁免:+2
+$熟练$ 体操/2*隐匿/敏捷豁免
+$额外加值$ 豁免:+2
+$武器$ 短剑+4,1d4+2穿刺
 
 ——提示（记录时请仅复制上方模板段并修改）——
 属性段六个数值依次对应: 力量/敏捷/体质/智力/感知/魅力
-额外加值段键 = 六属性/技能/豁免/攻击条目, 另有作用于全部的全局键: 豁免 与 攻击
+额外加值段键 = 六属性/技能/豁免条目, 另有作用于全部豁免的全局键: 豁免
 额外加值取值 = 可选 优势/劣势 前缀 + ±掷骰表达式, 如: 隐匿:优势+2
+职业段填 12 职业名之一（如 游荡者），游荡者的偷袭后缀会按等级自动附加偷袭骰
+武器段格式 = 名称+命中加值,伤害表达式+类型（多项用 / 分隔），如 短剑+4,1d4+2穿刺
 :::
 
-> 最后四行是模板的**提示**，不是卡的内容——记录时只复制「`$姓名$` … `$额外加值$`」这一段。
+> 「`——提示——`」以下（最后五行）是模板的**提示**，不是卡的内容——记录时只复制「`$姓名$` … `$武器$`」这一段。
 
 段落一览（**加粗**为必填）：
 
 | 段落 | 说明 | 是否必填 |
 | --- | --- | --- |
 | `$姓名$` | 角色名，用于检定落款与先攻列表；不写时显示名回退到群名片 | 可选 |
+| `$种族$` | 种族（如 `半精灵`），记录与展示用 | 可选 |
+| `$职业$` | 12 职业规范名之一（如 `游荡者`）；**游荡者**的偷袭后缀会按等级自动附加偷袭骰 | 可选 |
+| `$子职$` | 子职（如 `刺客`），记录与展示用 | 可选 |
 | **`$等级$`** | 等级；熟练加值 = 2 + (等级 − 1) ÷ 4 向下取整（5 级 → +3） | **必填** |
 | **`$属性$`** | 六个数值，用 `/` 分隔，依次对应 **力量 / 敏捷 / 体质 / 智力 / 感知 / 魅力**；<br>骰娘自动计算：调整值 = (数值 − 10) ÷ 2 向下取整 | **必填** |
 | `$生命值$` | `当前/最大(临时)`，如 `54/54`、`20/30 (5)`；<br>HP 结算改的是这里，见[HP 与长休](./hp-rest.md) | 可选 |
 | `$生命骰$` | `当前/总数 D骰面`，如 `5/5 D8`；长休按此回复生命骰 | 可选 |
 | `$熟练$` | 熟练条目，用 `/` 分隔；`2*隐匿` 为**专精**（双倍熟练），`0*隐匿` 显式关闭 | 可选 |
 | `$额外加值$` | 见[下节](#额外加值) | 可选 |
+| `$武器$` | 自定义武器/法术项：`名称+命中加值,伤害表达式+类型`（如 `短剑+4,1d4+2穿刺`），多项用 `/` 分隔；<br>名称尾加 `x` 表示不可攻击检定（如 `火球术x,8d6火焰`）；见[武器与攻击](./weapons.md) | 可选 |
 
 各段**顺序不限、可整段省略**（洛恩的卡就整段省掉了 `$额外加值$`）。记录成功后回「角色卡已设置」；再次记录会**整体覆盖**旧卡：
 
 ::: chat
 阿茶 | .角色卡记录
 $姓名$ 薇拉
+$种族$ 人类
+$职业$ 圣武士
+$子职$ 奉献之誓
 $等级$ 5
 $生命值$ 54/54
 $生命骰$ 5/5 D10
 $属性$ 18/10/14/8/10/16
-$熟练$ 力量攻击/感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
-$额外加值$ 力量攻击:+1
+$熟练$ 感知豁免/魅力豁免/运动/威吓/洞悉/游说/察觉
+$武器$ 长剑+8,1d8+5挥砍
 屠龙骰 | 角色卡已设置
 :::
 
@@ -103,18 +118,19 @@ $额外加值$ 力量攻击:+1
 
 格式为 `条目:取值`，多个用 `/` 分隔；取值是**可选**的 `优势`/`劣势` 前缀加一段 ±掷骰表达式：
 
-- 条目键：六属性名、技能名、`力量豁免`/`敏捷豁免`…、`力量攻击`/`敏捷攻击`…；
-- 另有作用于**全部**豁免 / 攻击的全局键：`豁免`、`攻击`；
+- 条目键：六属性名、技能名、`力量豁免`/`敏捷豁免`…；
+- 另有作用于**全部**豁免的全局键：`豁免`；
 - 没有内容就整段省略（洛恩的卡省掉了 `$额外加值$`）；卡上带优劣势时，对应检定会直接掷出优势/劣势。
 
-只登记**算得进检定**的部分——示例团三处加值都来自 2024 城主指南的魔法物品（数值出处见[示例团与人物](./cast.md#建卡依据)）：
+只登记**算得进检定**的部分——示例团两处加值都来自 2024 城主指南的魔法物品（数值出处见[示例团与人物](./cast.md#建卡依据)）：
 
 | 角色 | 卡上的写法 | 含义 |
 | --- | --- | --- |
-| 薇拉 | `力量攻击:+1` | 长剑 +1 的加值只进力量攻击 |
 | 塔莉 | `隐匿:优势` | 精灵之靴：潜行自带优势 |
 | 布鲁姆 | `豁免:+1` | 防护斗篷：所有豁免 +1（另有一条 `隐匿:劣势` 来自链甲） |
 
+武器的命中与伤害加值不走这里。直接写进 `$武器$` 项（薇拉的长剑 +1 已在 `长剑+8,1d8+5挥砍` 里），见[武器与攻击](./weapons.md)。
+
 限时效果的加值（祝福术 `+1d4`、激励骰…）**不要写进卡**——写成命令里的临时加值即可，见[检定与豁免](./checks.md#临时加值-不进角色卡)。
 
 ## 查看（.角色卡 / .状态）
@@ -124,12 +140,15 @@ $额外加值$ 力量攻击:+1
 ::: chat
 阿茶 | .角色卡
 屠龙骰 | $姓名$ 薇拉
+$种族$ 人类
+$职业$ 圣武士
+$子职$ 奉献之誓
 $生命值$ 54/54
 $生命骰$ 5/5 D10
 $等级$ 5
 $属性$ 18/10/14/8/10/16
-$熟练$ 运动/洞悉/察觉/威吓/游说/感知豁免/魅力豁免/力量攻击
-$额外加值$ 力量攻击:+1
+$熟练$ 运动/洞悉/察觉/威吓/游说/感知豁免/魅力豁免
+$武器$ 长剑+8,1d8+5挥砍
 老猫 | .状态
 屠龙骰 | HP:43/43
 生命骰:5/5 D8
@@ -141,20 +160,27 @@ $额外加值$ 力量攻击:+1
 白鸦 | .角色卡 @阿茶
 屠龙骰 | 薇拉 的角色卡：
 $姓名$ 薇拉
+$种族$ 人类
+$职业$ 圣武士
+$子职$ 奉献之誓
 $生命值$ 54/54
 $生命骰$ 5/5 D10
 $等级$ 5
 $属性$ 18/10/14/8/10/16
-$熟练$ 运动/洞悉/察觉/威吓/游说/感知豁免/魅力豁免/力量攻击
-$额外加值$ 力量攻击:+1
+$熟练$ 运动/洞悉/察觉/威吓/游说/感知豁免/魅力豁免
+$武器$ 长剑+8,1d8+5挥砍
 白鸦 | .角色卡 洛恩
 屠龙骰 | 洛恩 的角色卡：
 $姓名$ 洛恩
+$种族$ 精灵
+$职业$ 法师
+$子职$ 塑能师
 $生命值$ 37/37
 $生命骰$ 5/5 D6
 $等级$ 5
 $属性$ 8/15/16/18/10/8
-$熟练$ 2*奥秘/历史/调查/宗教/察觉/智力豁免/感知豁免/敏捷攻击
+$熟练$ 2*奥秘/历史/调查/宗教/察觉/智力豁免/感知豁免
+$武器$ 火焰箭+7,2d10火焰/匕首+5,1d4+2穿刺
 白鸦 | .状态 @小满
 屠龙骰 | 洛恩: HP:37/37
 生命骰:5/5 D6
@@ -162,7 +188,7 @@ $熟练$ 2*奥秘/历史/调查/宗教/察觉/智力豁免/感知豁免/敏捷
 
 - **查看开放、修改仅本人**：任何人可查看他人的卡（群内信息共享），而 `.角色卡记录` / `.角色卡清除` 写入的目标恒为发送者自己——带 @ 也不会改动他人的卡；
 - `.状态` 查看他人**仅支持 @ 形式**（写角色名会按自己的状态回复）；
-- `$熟练$` 的书写顺序不限，查看时按「技能 → 豁免 → 攻击」的固定次序显示；
+- `$熟练$` 的书写顺序不限，查看时按「技能 → 豁免」的固定次序显示；
 - @ 到无卡成员会提示引导建卡；角色名命中 NPC 条目时提示「是NPC条目，没有角色卡」。
 
 ## 覆盖与清除
@@ -203,7 +229,7 @@ $属性$ 10/10/10
 小鹿 | .角色卡记录
 $等级$ 1
 $属性$ 10/10/10/10/10/10
-$额外加值$ 敏捷攻击+1d4
+$额外加值$ 隐匿优势+2
 屠龙骰 | 必须使用冒号(:)分割额外加值条目和内容
 
 注：`$额外加值$` 要写成 `条目:取值` 的冒号形式。