dsh-dungeon-master 0.5.2 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -2
- package/CHANGELOG_EN.md +24 -2
- package/README.md +203 -198
- package/README_EN.md +203 -198
- package/cordis.patch.yml +32 -32
- package/cordis.yml +112 -112
- package/dist/commands/dnd.d.ts.map +1 -1
- package/dist/commands/dnd.js +4 -3
- package/dist/commands/dnd.js.map +1 -1
- package/dist/config.d.ts +2 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +2 -0
- package/dist/config.js.map +1 -1
- package/dist/dnd/battle-image.d.ts +11 -4
- package/dist/dnd/battle-image.d.ts.map +1 -1
- package/dist/dnd/battle-image.js +86 -7
- package/dist/dnd/battle-image.js.map +1 -1
- package/dist/dnd/battlefield.d.ts +39 -3
- package/dist/dnd/battlefield.d.ts.map +1 -1
- package/dist/dnd/battlefield.js +378 -88
- package/dist/dnd/battlefield.js.map +1 -1
- package/dist/dnd/campaign.d.ts +192 -16
- package/dist/dnd/campaign.d.ts.map +1 -1
- package/dist/dnd/campaign.js +645 -92
- package/dist/dnd/campaign.js.map +1 -1
- package/dist/dnd/combat-agent.d.ts +53 -5
- package/dist/dnd/combat-agent.d.ts.map +1 -1
- package/dist/dnd/combat-agent.js +612 -62
- package/dist/dnd/combat-agent.js.map +1 -1
- package/dist/dnd/combat-context.d.ts +74 -2
- package/dist/dnd/combat-context.d.ts.map +1 -1
- package/dist/dnd/combat-context.js +62 -21
- package/dist/dnd/combat-context.js.map +1 -1
- package/dist/dnd/conditions.d.ts +217 -0
- package/dist/dnd/conditions.d.ts.map +1 -0
- package/dist/dnd/conditions.js +1216 -0
- package/dist/dnd/conditions.js.map +1 -0
- package/dist/dnd/custom-effects.d.ts +121 -0
- package/dist/dnd/custom-effects.d.ts.map +1 -0
- package/dist/dnd/custom-effects.js +446 -0
- package/dist/dnd/custom-effects.js.map +1 -0
- package/dist/dnd/dice.d.ts +5 -1
- package/dist/dnd/dice.d.ts.map +1 -1
- package/dist/dnd/dice.js +4 -3
- package/dist/dnd/dice.js.map +1 -1
- package/dist/dnd/dnd-service.d.ts +8 -6
- package/dist/dnd/dnd-service.d.ts.map +1 -1
- package/dist/dnd/dnd-service.js +43 -7
- package/dist/dnd/dnd-service.js.map +1 -1
- package/dist/dnd/dnd-tools.d.ts.map +1 -1
- package/dist/dnd/dnd-tools.js +2 -0
- package/dist/dnd/dnd-tools.js.map +1 -1
- package/dist/dnd/formula.d.ts +40 -0
- package/dist/dnd/formula.d.ts.map +1 -0
- package/dist/dnd/formula.js +219 -0
- package/dist/dnd/formula.js.map +1 -0
- package/dist/dnd/map-view.d.ts +3 -1
- package/dist/dnd/map-view.d.ts.map +1 -1
- package/dist/dnd/map-view.js +33 -10
- package/dist/dnd/map-view.js.map +1 -1
- package/dist/dnd/movement.d.ts +3 -3
- package/dist/dnd/movement.d.ts.map +1 -1
- package/dist/dnd/movement.js +14 -8
- package/dist/dnd/movement.js.map +1 -1
- package/dist/dnd/pending-attack.d.ts +23 -13
- package/dist/dnd/pending-attack.d.ts.map +1 -1
- package/dist/dnd/pending-attack.js +198 -27
- package/dist/dnd/pending-attack.js.map +1 -1
- package/dist/dnd/save-effect.d.ts +12 -0
- package/dist/dnd/save-effect.d.ts.map +1 -1
- package/dist/dnd/save-effect.js +72 -8
- package/dist/dnd/save-effect.js.map +1 -1
- package/dist/dnd/spell-links.d.ts +32 -11
- package/dist/dnd/spell-links.d.ts.map +1 -1
- package/dist/dnd/spell-links.js +105 -20
- package/dist/dnd/spell-links.js.map +1 -1
- package/dist/dnd/srd-lookup.d.ts.map +1 -1
- package/dist/dnd/srd-lookup.js +23 -0
- package/dist/dnd/srd-lookup.js.map +1 -1
- package/dist/dnd/terrain.d.ts +8 -2
- package/dist/dnd/terrain.d.ts.map +1 -1
- package/dist/dnd/terrain.js +13 -8
- package/dist/dnd/terrain.js.map +1 -1
- package/dist/dnd/tool-scope.d.ts.map +1 -1
- package/dist/dnd/tool-scope.js +1 -1
- package/dist/dnd/tool-scope.js.map +1 -1
- package/dist/dnd/tool-views.js +4 -4
- package/dist/dnd/tool-views.js.map +1 -1
- package/dist/dnd/tools/character.d.ts.map +1 -1
- package/dist/dnd/tools/character.js +223 -21
- package/dist/dnd/tools/character.js.map +1 -1
- package/dist/dnd/tools/combat.d.ts.map +1 -1
- package/dist/dnd/tools/combat.js +222 -32
- package/dist/dnd/tools/combat.js.map +1 -1
- package/dist/dnd/tools/dice.d.ts.map +1 -1
- package/dist/dnd/tools/dice.js +406 -53
- package/dist/dnd/tools/dice.js.map +1 -1
- package/dist/dnd/tools/explore.d.ts.map +1 -1
- package/dist/dnd/tools/explore.js +3 -2
- package/dist/dnd/tools/explore.js.map +1 -1
- package/dist/dnd/tools/rules.d.ts +3 -0
- package/dist/dnd/tools/rules.d.ts.map +1 -0
- package/dist/dnd/tools/rules.js +190 -0
- package/dist/dnd/tools/rules.js.map +1 -0
- package/dist/dnd/tools/saves.d.ts.map +1 -1
- package/dist/dnd/tools/saves.js +23 -6
- package/dist/dnd/tools/saves.js.map +1 -1
- package/dist/dnd/tools/shared.d.ts +8 -2
- package/dist/dnd/tools/shared.d.ts.map +1 -1
- package/dist/dnd/tools/shared.js +239 -39
- package/dist/dnd/tools/shared.js.map +1 -1
- package/dist/dnd/turn-buttons.d.ts +4 -0
- package/dist/dnd/turn-buttons.d.ts.map +1 -1
- package/dist/dnd/turn-buttons.js +49 -25
- package/dist/dnd/turn-buttons.js.map +1 -1
- package/dist/dnd/zones.d.ts +123 -0
- package/dist/dnd/zones.d.ts.map +1 -0
- package/dist/dnd/zones.js +545 -0
- package/dist/dnd/zones.js.map +1 -0
- package/dist/features/button-utils.d.ts +2 -1
- package/dist/features/button-utils.d.ts.map +1 -1
- package/dist/features/button-utils.js.map +1 -1
- package/dist/features/note-judge.d.ts +24 -7
- package/dist/features/note-judge.d.ts.map +1 -1
- package/dist/features/note-judge.js +112 -24
- package/dist/features/note-judge.js.map +1 -1
- package/dist/features/reply-judge.d.ts.map +1 -1
- package/dist/features/reply-judge.js +22 -4
- package/dist/features/reply-judge.js.map +1 -1
- package/dist/gateway/bootstrap.d.ts.map +1 -1
- package/dist/gateway/bootstrap.js +28 -1
- package/dist/gateway/bootstrap.js.map +1 -1
- package/dist/gateway/middleware-setup.d.ts +3 -1
- package/dist/gateway/middleware-setup.d.ts.map +1 -1
- package/dist/gateway/middleware-setup.js +24 -5
- package/dist/gateway/middleware-setup.js.map +1 -1
- package/dist/middleware/reply-decider.d.ts +8 -1
- package/dist/middleware/reply-decider.d.ts.map +1 -1
- package/dist/middleware/reply-decider.js +22 -8
- package/dist/middleware/reply-decider.js.map +1 -1
- package/dist/middleware/serial-merge.d.ts +7 -3
- package/dist/middleware/serial-merge.d.ts.map +1 -1
- package/dist/middleware/serial-merge.js +125 -9
- package/dist/middleware/serial-merge.js.map +1 -1
- package/dist/model/status-watch.d.ts +4 -0
- package/dist/model/status-watch.d.ts.map +1 -1
- package/dist/model/status-watch.js +6 -2
- package/dist/model/status-watch.js.map +1 -1
- package/dist/session/index.d.ts +1 -1
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js.map +1 -1
- package/dist/session/session-manager.d.ts +21 -5
- package/dist/session/session-manager.d.ts.map +1 -1
- package/dist/session/session-manager.js +141 -18
- package/dist/session/session-manager.js.map +1 -1
- package/dist/session/types.d.ts +8 -0
- package/dist/session/types.d.ts.map +1 -1
- package/dist/setup/bind-routes.d.ts.map +1 -1
- package/dist/setup/bind-routes.js +2 -1
- package/dist/setup/bind-routes.js.map +1 -1
- package/dist/transport/agent-turn.d.ts +7 -3
- package/dist/transport/agent-turn.d.ts.map +1 -1
- package/dist/transport/agent-turn.js +20 -2
- package/dist/transport/agent-turn.js.map +1 -1
- package/dist/transport/events.d.ts +6 -1
- package/dist/transport/events.d.ts.map +1 -1
- package/dist/transport/events.js +1 -0
- package/dist/transport/events.js.map +1 -1
- package/dist/transport/inbound.d.ts +6 -0
- package/dist/transport/inbound.d.ts.map +1 -1
- package/dist/transport/inbound.js +66 -13
- package/dist/transport/inbound.js.map +1 -1
- package/dist/transport/outbound-buffer.d.ts +6 -0
- package/dist/transport/outbound-buffer.d.ts.map +1 -1
- package/dist/transport/outbound-buffer.js +13 -0
- package/dist/transport/outbound-buffer.js.map +1 -1
- package/dist/transport/outbound.d.ts.map +1 -1
- package/dist/transport/outbound.js +95 -21
- package/dist/transport/outbound.js.map +1 -1
- package/dist/transport/turn-steer.d.ts +70 -0
- package/dist/transport/turn-steer.d.ts.map +1 -0
- package/dist/transport/turn-steer.js +206 -0
- package/dist/transport/turn-steer.js.map +1 -0
- package/lib/client.js +10 -0
- package/lib/client.js.map +1 -1
- package/package.json +143 -137
- package/skills/dnd-module-authoring/SKILL.md +91 -0
- package/skills/dnd-module-authoring/guide.md +76 -47
- package/skills/dnd-rule-extension/SKILL.md +126 -0
- package/skills/qqbot-sticker-maker/SKILL.md +87 -0
- package/skills/qqbot-sticker-maker/references/character-specs.md +94 -0
- package/skills/qqbot-sticker-maker/references/meme-adaptation-notes.md +46 -0
- package/skills/qqbot-sticker-maker/resources/zipzippipe/sources.json +105 -0
- package/skills/qqbot-sticker-maker/scripts/sticker-cli.cjs +1158 -0
- package/skills/qqbot-sticker-maker/scripts/sticker-export.cjs +147 -0
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# 跑团模组编写指南
|
|
2
2
|
|
|
3
3
|
这份指南讲怎么把一本冒险模组(或者你自己的剧本)写成 bot 能跑的 JSON。
|
|
4
|
-
类型定义在 `src/dnd/adventure.ts` 和 `src/dnd/
|
|
4
|
+
类型定义在 `src/dnd/adventure.ts`、`src/dnd/dungeon.ts` 和 `src/dnd/terrain.ts`,这里讲的是怎么用。
|
|
5
5
|
|
|
6
|
-
> **版权**:商业模组(官方冒险、付费 PDF)转出来的 JSON
|
|
6
|
+
> **版权**:商业模组(官方冒险、付费 PDF)转出来的 JSON 与地图只放在本机的 `<dnd 根目录>/adventures/`,
|
|
7
7
|
> 不要提交进仓库、不要分享。文本用自己的话转述,不要整段照抄朗读框。
|
|
8
8
|
|
|
9
9
|
## 1. 放在哪
|
|
@@ -12,30 +12,43 @@
|
|
|
12
12
|
|
|
13
13
|
| 写法 | 适合 |
|
|
14
14
|
|---|---|
|
|
15
|
-
| `adventures/<id>.json` |
|
|
16
|
-
| `adventures/<id>/adventure.json` + `adventures/<id>/sites/*.json` |
|
|
15
|
+
| `adventures/<id>.json` | 小模组,一个文件写完(不能挂本地地图图片) |
|
|
16
|
+
| `adventures/<id>/adventure.json` + `adventures/<id>/sites/*.json` | 中型模组,每个场景一个文件,方便分批写 |
|
|
17
|
+
| `adventures/<id>/build/*.json` → 合并成 `adventure.json` | 长篇模组(几十个场景,NPC、线索、地图也要按章分片维护) |
|
|
17
18
|
|
|
18
|
-
拆文件时 `adventure.json` 可以不写 `sites`(或只写一部分),`sites/`
|
|
19
|
+
拆文件时 `adventure.json` 可以不写 `sites`(或只写一部分),`sites/` 下的 `.json` 按文件名排序后追加进去。
|
|
20
|
+
目录形式的模组里,加载器只读 `adventure.json` 和 `sites/*.json`,同目录下放离线备团资料(`text-en/`、`text-zh/`、`img/`、`data/`、`译名对照表.md`、`build/`)互不干扰,`img/` 里的图片还能直接给场景地图和战斗底图引用。
|
|
19
21
|
旧的单地城格式(`dungeons/*.json`)还能用,会被当成只有一个场景的模组。
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
长篇模组用 `build/` 分片时,推荐按文件名定顺序:`00-core.json` 放顶层字段,`10-*.json`、`20-*.json` 按章放 `chapters` / `sites` / `npcs` / `leads` / `quests` / `flags`,`60-maps.json` 放场景地图矩形,`61-battlemaps.json` 放战斗场地图。合并脚本除拼接同名顶层数组外,支持三个增量键最省事:
|
|
24
|
+
|
|
25
|
+
- `addRooms: { "<场景id>": [房间...] }`:大地下城分几个文件往已定义的场景里追加房间。
|
|
26
|
+
- `siteMaps: { "<场景id>": [地图...] }`:把玩家版地图和房间像素框单独挂到场景的 `maps` 上。
|
|
27
|
+
- `roomBattlemaps: { "<房间id>": 场地图 }`:批量挂房间战斗图(房间已手写 `battlemap` 时不覆盖)。
|
|
28
|
+
|
|
29
|
+
加载与本地校验规则:
|
|
22
30
|
|
|
23
31
|
- 文件改了会自动重新读(按修改时间),不用重启 bot;但正在跑的团只在下一回合看到新内容。
|
|
24
32
|
- 结构错误:这个模组不加载,日志里有 `im-qqbot: 模组 xxx 加载失败: 原因`。
|
|
25
|
-
- 可疑但不致命的地方(没人设置的 flag
|
|
33
|
+
- 可疑但不致命的地方(没人设置的 flag、发布人 `offers` 漏列任务、线索太少的场景):照样加载,日志里打 `im-qqbot: 模组 xxx: 警告`。
|
|
34
|
+
- 不用起 bot 也能在插件目录一行跑完结构与警告校验:
|
|
35
|
+
```bash
|
|
36
|
+
node -e "import('./src/dnd/adventure.ts').then(({ AdventureLibrary }) => new AdventureLibrary({ adventures: '../dnd/adventures' }, console).list())"
|
|
37
|
+
```
|
|
26
38
|
- 群里发 `/dnd dungeons` 能看到加载成功的模组;`/dnd new <id>` 开团。
|
|
27
39
|
|
|
28
40
|
## 2. 拆书的顺序
|
|
29
41
|
|
|
30
42
|
一本模组按这个顺序拆最不容易漏:
|
|
31
43
|
|
|
32
|
-
|
|
44
|
+
0. **先备资料与定译名**(改编长篇时):先把章节文本、干净的玩家版地图(去掉房间编号和暗门「S」标记的图,放进 `adventures/<id>/img/`)和一份固定译名对照表备齐,专有名词从头到尾用同一套译法。
|
|
45
|
+
1. **读背景和概览**,写 `truth`(DM 才知道的真相:反派是谁、要什么、东西真正在哪)和 `chapters`。
|
|
33
46
|
2. **每章定玩法**:线性(伏击→巢穴)、城镇枢纽(地点 + NPC + 传闻 + 任务)、沙盒(大地图多据点)、地城。
|
|
34
|
-
3. **每个场景**:通用规则(General Features)→ `features
|
|
47
|
+
3. **每个场景**:通用规则(General Features)→ `features`;玩家版地图与房间像素框 → `site.maps`;房间坐标和出口 → `rooms`;
|
|
35
48
|
朗读框 → `playerView`;正文拆成遭遇(`encounter`)、检定和宝物(`dmNotes`)、条件变化(`triggers`)。
|
|
36
49
|
会打仗的房间顺手把方格图写成 `battlemap`(第 5 节),不写就由 DM 开战时现画。
|
|
37
|
-
4. **抽实体**:NPC 表 → `npcs
|
|
38
|
-
5.
|
|
50
|
+
4. **抽实体**:NPC 表 → `npcs`(具名反派和可能被俘审问的人,把「知道什么」和「不知道什么」都写进 `knows`);「X 知道什么」侧栏 → `knowledge`;传闻 → 带 `leads` 的 `facts`;任务 → `quests`。
|
|
51
|
+
5. **画线索图**:每个隐藏的关键场景(写了 `knownWhen` 的)至少两条线索指过去,少于两条会打警告。
|
|
39
52
|
6. **最后补 flag**:所有条件里用到的状态都要在 `flags` 里声明,而且要有触发器/信息/任务奖励去设置它。
|
|
40
53
|
|
|
41
54
|
书里元素和字段的对照:
|
|
@@ -47,13 +60,14 @@
|
|
|
47
60
|
| 章节、本章目标 | `chapters[].goal` / `dmGuide` |
|
|
48
61
|
| 地图上的一个地点 | `sites[]` |
|
|
49
62
|
| General Features(光照、声音、地形) | `site.features` |
|
|
63
|
+
| 书里的玩家版地图(无编号、无暗门标记) | `site.maps` |
|
|
50
64
|
| 编号区域 | `rooms[]` |
|
|
51
65
|
| 区域的战斗方格图(墙、门、柱子、碎石、水渠) | `room.battlemap` |
|
|
52
66
|
| 朗读框 | `room.playerView`(转述) |
|
|
53
67
|
| 区域正文的 DC、陷阱、宝物、怪物动机 | `room.dmNotes` |
|
|
54
68
|
| 粗体怪物名 | `room.encounter`(具名的头目写成 NPC) |
|
|
55
69
|
| Developments(如果……就……) | `room.triggers` |
|
|
56
|
-
|
|
|
70
|
+
| 状态变了之后的描述或 DM 笔记(水放干了、强盗被清掉) | `room.variants` |
|
|
57
71
|
| 暗门 | `exit.hidden: true` |
|
|
58
72
|
| 要爬、要游、要跳的通道 | `exit.check` |
|
|
59
73
|
| 锁着、要钥匙或口令的门 | `exit.requires` + `lockedText` |
|
|
@@ -72,14 +86,16 @@
|
|
|
72
86
|
| 字段 | 必填 | 说明 |
|
|
73
87
|
|---|---|---|
|
|
74
88
|
| `id` / `name` | ✓ | |
|
|
89
|
+
| `credits` | | 来源或重用许可说明(如 SRD 5.1 CC BY 4.0) |
|
|
90
|
+
| `levels` | | `{ "start": 1, "end": 5 }`,只是说明 |
|
|
91
|
+
| `partySize` | | 模组按几人写的遭遇,缺省 `4`(官方模组默认)。本桌在场 PC 多于这个人数时,`dnd_move` 刷怪会自动提醒 DM 上调上限(小怪不超过 `PC 数 × 1.5` 只,首领 HP 不超过模组卡 `× 1.5`) |
|
|
75
92
|
| `truth` | | DM 机密,每回合注入,写短 |
|
|
76
93
|
| `hook` | | 开团时念给玩家(`/dnd new` 直接发到群里) |
|
|
77
|
-
| `opening` | | 进第一个场景前 DM
|
|
78
|
-
| `start` | ✓ | 开局所在房间 id;这个房间的 `encounter`
|
|
79
|
-
| `chapters` / `sites` / `npcs` / `leads` / `quests` / `flags` | | `sites`
|
|
80
|
-
| `
|
|
81
|
-
| `
|
|
82
|
-
| `milestones` | | `{ "level": 2, "when": 条件, "text": "说明" }`,满足时提示一次 |
|
|
94
|
+
| `opening` | | 进第一个场景前 DM 带玩家做的事,一步一条(互相介绍、和委托人的交情、行进队形……)。**所有新团都会先停在开场阶段**:没写 `opening` 时走默认两步(角色介绍 + 行进队形),若有 PC 还没留过背景钩子还会顺带提示 `dnd_hook add`;写了 `opening` 就替换默认步骤。开场期间不注入第一个房间的 DM 笔记,做完调 `dnd_story action=begin` 才进起始场景 |
|
|
95
|
+
| `start` | ✓ | 开局所在房间 id;这个房间的 `encounter` 在 `begin` 结束开场时刷出(适合开场伏击) |
|
|
96
|
+
| `chapters` / `sites` / `npcs` / `leads` / `quests` / `flags` | | `sites` 至少一个,其余缺省为空数组 |
|
|
97
|
+
| `routes` | | `[{ "from": "场景a", "to": "场景b", "days": 3, "note": "..." }]`,双向连通。写了就只能沿路在已知场景间移动(地城只能从 `entry` 出发,城镇从哪都能走);不写则所有已知场景互通 |
|
|
98
|
+
| `milestones` | | `[{ "level": 2, "when": 条件, "text": "说明" }]`,满足时提示一次 |
|
|
83
99
|
|
|
84
100
|
### 章节
|
|
85
101
|
|
|
@@ -96,10 +112,11 @@
|
|
|
96
112
|
| `features` | 通用规则,首次抵达和每回合注入 |
|
|
97
113
|
| `arrival` | 首次抵达时念给玩家 |
|
|
98
114
|
| `summary` | DM 一两句概述 |
|
|
99
|
-
| `knownWhen` | 满足前玩家不知道这个地方;不写 = 一开始就知道。线索 `points.site`
|
|
115
|
+
| `knownWhen` | 满足前玩家不知道这个地方;不写 = 一开始就知道。线索 `points.site`(或 `points.room` 落在本场景)揭示后也会变成已知 |
|
|
100
116
|
| `knowledge` | 场景里无名群体知道的事 |
|
|
117
|
+
| `maps` | 书里的玩家版地图:`[{ image, reveal?: "fog"\|"full", rooms: { 房间id: [x,y,宽,高] 或 [[x,y,宽,高], ...] } }]`。`image` 相对模组目录(**只有目录形式的模组能用**,单文件模组会打警告跳过;不能越出模组目录),要用**无房间号、无暗门标记的玩家版图**。`fog`(默认)只露去过的房间、边缘羽化并裁剪画布(不泄露全层有多大),连着房间的走廊可作为第 2 个矩形写进同一房间下,队伍红点画在**第一个矩形**中心;`full` 整张不裁(城镇、区域图),本场景未标进 `rooms` 的小地点也会回退发这张 `full` 图。有可用地图时 `dnd_map` 与 `/dnd map` 优先发它(需装 `sharp`),不再画方框示意图 |
|
|
101
118
|
|
|
102
|
-
**dungeon**:房间要写坐标 `x y w h
|
|
119
|
+
**dungeon**:房间要写坐标 `x y w h`(网格,示意图回退用)和 `exits`,只能走相邻房间,离开场景要回到 `entry`。
|
|
103
120
|
**hub**:地点不用写坐标和出口(自动排成网格),已知地点之间随便走,从任何地点都能出发去别的场景;
|
|
104
121
|
地点可以用 `knownWhen` 藏起来,用 `shop: { "sells": "...", "maxPrice": 25 }` 标成店铺。`knownWhen` 只能用在城镇地点,入口不能藏。
|
|
105
122
|
|
|
@@ -109,16 +126,15 @@
|
|
|
109
126
|
|---|---|
|
|
110
127
|
| `playerView` | 可以说给玩家的描述(短,3 句以内) |
|
|
111
128
|
| `dmNotes` | DC、陷阱、宝物、怪物战术;工具结果和注入里都有 |
|
|
112
|
-
| (场景)`maps` | 书里的玩家版地图:`[{ image, reveal?: "fog"\|"full", rooms: { 房间 id: [x,y,宽,高] 或几个矩形 } }]`,image 相对模组目录。fog 只露去过的房间并裁剪,full 整张发(城镇、区域图);dnd_map 有它就不画示意图 |
|
|
113
129
|
| `exits` | `[{ to, label, hidden?, check?, requires?, lockedText?, oneWay? }]`;只写一边就双向连通。传送阵、滑道、陷坑这种回不去的写 `oneWay: true`,否则玩家能从落点反着走回来 |
|
|
114
130
|
| `encounter` | 首次进入时刷出的怪物,见下 |
|
|
115
|
-
| `battlemap` | 战斗场地图(5
|
|
131
|
+
| `battlemap` | 战斗场地图(5 尺一格的墙、门、障碍,可挂原书底图 `art`),见第 5 节;不写就由 DM 开战时画 |
|
|
116
132
|
| `triggers` / `variants` | 见第 4 节 |
|
|
117
133
|
| `npcs` | 住在这里的 NPC id(`npc.home` 指过来的也算) |
|
|
118
134
|
| `knowledge` | 只在这个房间的群体知道的事 |
|
|
119
135
|
|
|
120
136
|
出口检定:`"check": { "skill": "运动", "dc": 10, "fail": "失败的后果" }`(或 `ability: "力量"`)。
|
|
121
|
-
工具给每个移动的人掷骰,没过的留在原地,`fail` 交给 DM 用 `dnd_apply`
|
|
137
|
+
工具给每个移动的人掷骰,没过的留在原地,`fail` 交给 DM 用 `dnd_apply` 结算(桌上若已先用 `dnd_check` 投过这道检定,DM 传 `check_done` 骰子编号即可跳过重掷)。技能和属性中英文都行。
|
|
122
138
|
|
|
123
139
|
### 怪物(encounter / spawn / NPC 的 stat)
|
|
124
140
|
|
|
@@ -127,8 +143,8 @@
|
|
|
127
143
|
"attackBonus": 4, "damage": "1d6+2", "abilities": { "dex": 14 }, "notes": "灵巧脱逃……" }
|
|
128
144
|
```
|
|
129
145
|
|
|
130
|
-
`srd` 是 dnd5eapi.co 的 index
|
|
131
|
-
`count > 1` 时自动编号(地精1、地精2)。`traits: ["不死坚韧"]`
|
|
146
|
+
房间 `encounter` 和触发器 `spawn` 直接按上面写的数值刷怪,运行时不联网拉数据,所以 `hp`、`ac`、`initBonus`、`attackBonus`、`damage` 都要填齐;`srd` 是 dnd5eapi.co 的 index,留在卡上供 DM 用 `dnd_srd` 查完整动作与法术。不在 SRD 的怪物把数据填全即可。
|
|
147
|
+
`count > 1` 时自动编号(地精1、地精2)。`traits: ["不死坚韧"]` 由工具自动结算。
|
|
132
148
|
|
|
133
149
|
### NPC
|
|
134
150
|
|
|
@@ -140,13 +156,13 @@
|
|
|
140
156
|
| `voice` / `motive` / `faction` | 扮演提示 |
|
|
141
157
|
| `home.room` | 平时在哪 |
|
|
142
158
|
| `attitude` | `friendly | indifferent | hostile` |
|
|
143
|
-
| `stat` | `{ "srd": "bugbear" }
|
|
144
|
-
| `knows` |
|
|
145
|
-
| `offers` | 发布的任务 id |
|
|
159
|
+
| `stat` | `{ "srd": "bugbear" }`(上场时在线拉 SRD)或完整怪物数据;不写 = 平民 |
|
|
160
|
+
| `knows` | 必填数组(没有写 `[]`),能透露的信息(`facts`)。`knows` 非空时 `dnd_lookup npc` 会约束 DM「这几条之外他不知道别的」 |
|
|
161
|
+
| `offers` | 发布的任务 id(任务写了 `giver` 时这里也要列上,漏了会打警告) |
|
|
146
162
|
| `canJoin` | 会入队 |
|
|
147
163
|
|
|
148
|
-
NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟着队伍走)、和队伍打起来
|
|
149
|
-
(`fight=true
|
|
164
|
+
NPC 只在两种情况下建角色卡:入队(`dnd_story action=npc join=true`,跟着队伍走)、和队伍打起来
|
|
165
|
+
(`fight=true`,留在自己房间、进那个房间的先攻);被俘或带伤上场时可传 `hp=<当前血量>`(不传默认满血)。光聊天的 NPC 不建卡。
|
|
150
166
|
**具名头目写成 NPC 时,开打要 `fight=true` 才会进先攻**,在 `dmNotes` 里提醒一句。
|
|
151
167
|
|
|
152
168
|
### 信息(facts)与知识块
|
|
@@ -184,10 +200,10 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
184
200
|
- 默认只触发一次,`"once": false` 可重复。
|
|
185
201
|
- 一条 Development 一个触发器;后续步骤用 `requires` 串起来(先放第一波水,才能放第二波)。
|
|
186
202
|
|
|
187
|
-
|
|
203
|
+
**变体**:条件满足时换一套玩家描述或 DM 笔记(`playerView` / `dmNotes` 可只写其一),后面的覆盖前面的。
|
|
188
204
|
|
|
189
205
|
```json
|
|
190
|
-
"variants": [{ "when": "flood-1", "playerView": "东边的水池已经见底……" }]
|
|
206
|
+
"variants": [{ "when": "flood-1", "playerView": "东边的水池已经见底……", "dmNotes": "池底露出暗格,调查 DC 12。" }]
|
|
191
207
|
```
|
|
192
208
|
|
|
193
209
|
**条件**写法(用在 `requires`、`knownWhen`、`completeWhen`、`when` 等处):
|
|
@@ -204,10 +220,7 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
204
220
|
|
|
205
221
|
## 5. 战斗场地图(battlemap)
|
|
206
222
|
|
|
207
|
-
房间的 `x y w h`
|
|
208
|
-
用的是另一张 5 尺一格的场地图。房间上写了 `battlemap`,这个房间第一次开战时就拷进存档;
|
|
209
|
-
没写的话,DM 开战时会被要求用 `dnd_position terrain` 照房间描述现画一张(格式一样),也存进存档。
|
|
210
|
-
以后再在这个房间打仗,用的都是存档里的那张。
|
|
223
|
+
房间的 `x y w h` 只管方框示意图画在哪,打仗用不上。战斗时的站位、寻路、借机、范围法术和战斗图使用的是另一张 5 尺一格的场地图。房间上写了 `battlemap`,第一次在这个房间开战时就拷进团档;没写的话,DM 开战时会被要求用 `dnd_position terrain` 照房间描述现画一张,也存进团档。以后再在这个房间打仗,用的都是团档里的那张。
|
|
211
224
|
|
|
212
225
|
```json
|
|
213
226
|
"battlemap": {
|
|
@@ -225,7 +238,7 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
225
238
|
}
|
|
226
239
|
```
|
|
227
240
|
|
|
228
|
-
|
|
241
|
+
装有 `sharp` 时,`dnd_map` 和战斗中的 `/dnd status` 会把场地图渲染成带网格坐标、站位圆片和图例的图片发给玩家;DM(模型)在工具结果里看到的则是下面的字符网格(没装 `sharp` 时玩家侧也会退回字符网格):
|
|
229
242
|
|
|
230
243
|
```
|
|
231
244
|
0 1 2 3 4 5 6 7 8 9
|
|
@@ -240,7 +253,7 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
240
253
|
- 坐标和战斗里一致:左上角 `(0,0)`,x 向东(右)、y 向南(下)。`width` / `height` 最大 40。
|
|
241
254
|
- `areas` 是矩形,`w` / `h` 默认 1,**后写的盖住先写的**:先画整面墙,再在墙上开门。没盖到的格子是空地。
|
|
242
255
|
|
|
243
|
-
| `kind` |
|
|
256
|
+
| `kind` | 字符图上 | 规则 |
|
|
244
257
|
|---|---|---|
|
|
245
258
|
| `wall` | `#` | 走不进、挡视线(隔着打会提醒 DM) |
|
|
246
259
|
| `object` | 小写字母 | 同上,必须有 `name`(熔炉、石柱、矿车) |
|
|
@@ -248,17 +261,31 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
248
261
|
| `door` | `+` | 能走的门洞;`to` 写通往的房间 id |
|
|
249
262
|
| `outside` | `:` | 门外的走廊或隔壁一角;站在那里还算这个房间,距离和借机照常算 |
|
|
250
263
|
|
|
264
|
+
### 挂书里的底图(`battlemap.art`)
|
|
265
|
+
|
|
266
|
+
目录形式的模组可以给 `battlemap` 加上 `art`,让发给玩家的战斗图直接裁原书的玩家版地图做底图(移动、借机、视线规则仍只看 `areas` 和 `shade`):
|
|
267
|
+
|
|
268
|
+
```json
|
|
269
|
+
"art": {
|
|
270
|
+
"image": "img/mine-player.webp",
|
|
271
|
+
"left": 312.5, "top": 148.0, "cell": 49.6,
|
|
272
|
+
"shade": [[0, 0, 3, 6]]
|
|
273
|
+
}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
- `image` 相对模组目录;`left`、`top` 是格子 `(0,0)` 左上角在原图上的**像素坐标**,`cell` 是一格对应的**原图像素数**(≥ 8,可写小数对齐原图网格线)。
|
|
277
|
+
- `shade` 是 `[x, y, 宽, 高]` 的**场地图格子坐标**(不是像素),标出裁剪框里不属于本房间的区域(隔壁未探索房间、外围岩体):出图时涂黑,规则上自动算作墙,但 `areas` 里画在上面的 `door` / `outside` 仍然优先通行。
|
|
278
|
+
- 从原书地图批量生成场地图草稿时,可以只标外墙和 `art`:只要 `areas` 里还没有门、石柱这类非墙地形,开战时系统会提示 DM 按房间描述用 `dnd_position terrain` 补上——**保持 `width` 和 `height` 不变重画时,原有的 `art` 底图和 `shade` 会自动保留**。
|
|
279
|
+
|
|
251
280
|
写的时候注意:
|
|
252
281
|
|
|
253
282
|
- **门外留两三格 `outside`**。玩家常说「退到门外」「守在门口」,图上没有门外就只能把人从站位上拿掉。
|
|
254
283
|
- **门的 `to` 和房间出口对上**。队伍从哪个房间进来,开战时 DM 就被提示把 PC 摆在 `to` 等于那个房间的门边。
|
|
255
|
-
`to`
|
|
256
|
-
-
|
|
257
|
-
再宽就只截人在的那一块。书上的地图如果是 10 尺一格,记得换成 5 尺一格(格数翻倍)。
|
|
284
|
+
`to` 写错(指向不存在的房间,或指向本房间自己)会报错。
|
|
285
|
+
- **没有底图时宽度尽量不超过 22 格**。字符网格在 15 格以内一格画 3 个字符,16–22 格一格 2 个字符,整张都画得出来;再宽就只截有人那一块。书上的地图如果是 10 尺一格,记得换成 5 尺一格(格数翻倍,`art.cell` 减半)。
|
|
258
286
|
- **怪物开场站哪不在这里写**,放进 `dmNotes`(「丧尸散在大厅各处,焰颅浮在熔炉上方」),DM 开战时照着摆。
|
|
259
|
-
-
|
|
260
|
-
|
|
261
|
-
- 越界、`object` 没写名字、`to` 指向不存在的房间,模组会加载失败,日志里写明是哪个房间哪一项。
|
|
287
|
+
- **改模组不会自动覆盖已经开过战的存档**:那个房间的场地图已经拷进团档了,而团档受保护不能手改 JSON。想让旧团换上模组里的新预设图,让 DM 调 `dnd_position action=clear_terrain`(清除存档里的图并恢复模组预设 `battlemap`),或直接 `dnd_position action=terrain` 重画。
|
|
288
|
+
- 越界、`object` 没写名字、`to` 指向不存在的房间、`art.shade` 超出宽高,模组都会加载失败,日志里写明是哪个房间哪一项。
|
|
262
289
|
|
|
263
290
|
## 6. 写作建议
|
|
264
291
|
|
|
@@ -266,10 +293,11 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
266
293
|
`playerView` 里不要写埋伏的预兆或要检定才看得出的东西,模型会照着念出来。
|
|
267
294
|
- `dmNotes` 里要等检定或近看才能说的内容,开头写清楚「以下要等……才能说」,模型更不容易剧透。
|
|
268
295
|
- `dmNotes` 里写清楚检定(技能 + DC + 后果),DM 才不会临场编。
|
|
296
|
+
- 具名反派、俘虏的 `knows` 不要留空:除了他知道的情报,把**他不知道什么**(如「只跟信使接头,没见过幕后主使,也不知道老巢在哪」)也写成一条 `fact`;否则审问时 DM 容易现编口供把主线带偏。
|
|
269
297
|
- 暗门用 `hidden` 出口,不要只写在笔记里,否则地图和移动都不知道它存在。
|
|
270
298
|
- 不在书里的东西不要补:DM 规则要求它不编暗道和捷径,模组里没写的路就是走不通。
|
|
271
|
-
- 被俘、受伤的 NPC
|
|
272
|
-
-
|
|
299
|
+
- 被俘、受伤的 NPC 入队或开战时,在 `dmNotes` 标清当前血量,提醒 DM 用 `dnd_story action=npc join=true hp=1`(不传 `hp` 默认满血)。
|
|
300
|
+
- 写完先跑一遍加载校验看警告,再用 `/dnd new <id> blank` 在测试群跑一遍。
|
|
273
301
|
|
|
274
302
|
## 7. 最小示例
|
|
275
303
|
|
|
@@ -300,7 +328,8 @@ NPC 只在两种情况下建角色卡:入队(`dnd_story npc join=true`,跟
|
|
|
300
328
|
"home": { "room": "camp-tavern" }, "attitude": "friendly",
|
|
301
329
|
"knows": [
|
|
302
330
|
{ "id": "mine-rumor", "text": "矿坑在北边山腰上。", "via": "ask", "leads": ["mine-map"] },
|
|
303
|
-
{ "id": "vault-word", "text": "铁门口令是「灰岩」。", "via": "persuade", "dc": 13, "set": ["vault-open"] }
|
|
331
|
+
{ "id": "vault-word", "text": "铁门口令是「灰岩」。", "via": "persuade", "dc": 13, "set": ["vault-open"] },
|
|
332
|
+
{ "id": "miner-limit", "text": "只听见矿坑深处有怪声,没进过金库里面,不知道是谁在背后操纵工头。", "via": "ask" }
|
|
304
333
|
] }
|
|
305
334
|
],
|
|
306
335
|
"leads": [{ "id": "mine-map", "text": "矿坑在北边山腰", "points": { "site": "mine" } }],
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dnd-rule-extension
|
|
3
|
+
description: 在 dsh-dungeon-master 中确认、建模并热注册自定义 D&D 5e 村规、第三方职业扩展(如魔兽 5e 图腾/光环)、专武特效与个人宿命被动。当玩家提出或确认内置 SRD/PHB 表尚未覆盖的子职能力、专长、魔法武器附伤、光环或战场持续危害,或需要在代码中扩展战斗结算钩子时加载。
|
|
4
|
+
metadata:
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# D&D 5e 扩展规则与村规热注册(`dnd-rule-extension`)
|
|
9
|
+
|
|
10
|
+
`dsh-dungeon-master` 将攻击修正、命中附伤、豁免加值、光环、治疗加成、2.5D 飞行与持续地形统一交由确定性引擎结算,避免依赖模型在长对话中凭 `notes` 文本回忆数值。
|
|
11
|
+
|
|
12
|
+
遇到内置表尚未收录的扩展规则(如魔兽 5e 职业、塔莎/珊娜萨扩展、个人专武「段云」、宿命被动「风暴遗誓」「冥河炉心」等)时,**默认走路径一(通过 `dnd_rule` 零重启热注册)**;仅当机制引入全新状态机阶段、现有 6 类声明式钩子与 `BattleZone` 均无法表达且经部署者授权修改源码时,才走路径二。
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 一、引擎已内置规则(无需重复定义)
|
|
17
|
+
|
|
18
|
+
注册前先用 `dnd_rule(action="list")` 查看当前规则表。以下能力已原生支持:
|
|
19
|
+
|
|
20
|
+
- **PHB 14 种标准状态 + 力竭(`力竭:1..6`)**,以及 `闪避`、`狂暴`(近战力量 `+2/+3/+4` + 物理三抗)、`祝福术`、`灾祸术`、`护盾信仰`、`加速术`、`妖火`、`神圣武器`、`战斗英姿`、`咒剑诅咒`。
|
|
21
|
+
- **内置声明式特性与法术(`BUILTIN_EFFECTS`)**:
|
|
22
|
+
- `脆弱诅咒`(锁定目标命中 `+1d6` 黯蚀,专注)
|
|
23
|
+
- `猎人印记`(锁定目标武器命中 `+1d6` 武器同型,专注)
|
|
24
|
+
- `神恩`(武器命中 `+1d4` 光耀,专注)
|
|
25
|
+
- `变巨术`(武器命中 `+1d4` + 力量豁免优势,专注)
|
|
26
|
+
- `防护毒素`(毒素伤害抗性 + 对抗毒素/中毒豁免优势,非专注)
|
|
27
|
+
- `守护灵光`(圣武士未失能时,10 尺 / 18 级 30 尺内自身与友军全豁免自动 `+max(1, cha_mod)`)
|
|
28
|
+
- `灵体卫士`(15 尺敌方半速 + 回合开始/首次进圈或扫过触发感知豁免,`3d8` 基础 + 每高 1 环 `+1d8` 光耀半伤,专注)
|
|
29
|
+
- `生命门徒`(1 环及以上治疗法术额外恢复 `2 + slot_level`)、`神佑医者`(治疗他人时自身恢复 `2 + slot_level`)、`保全生命`(`5 * level` 治疗池,上限有效生命值一半)
|
|
30
|
+
- **内置战场持续区域预设(`dnd_position action="zone"`)**:
|
|
31
|
+
- `黑暗术`、`云雾术`、`毒雾`、`死云术`、`臭云术`、`蛛网术`、`匕首之云`、`月华之光`、`荆棘丛生`、`火墙术`、`沉默术`。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 二、路径一:零重启热注册工作流(默认路径)
|
|
36
|
+
|
|
37
|
+
### 第 1 步:与玩家核对规则边界并选定作用域
|
|
38
|
+
调用 `dnd_rule(action="define")` 前先确认:
|
|
39
|
+
1. **作用域 `scope`**:
|
|
40
|
+
- `"campaign"`(默认):写入当前团档 `customEffects`,仅本团生效——适用于个人专武、角色宿命被动、本桌房规。
|
|
41
|
+
- `"global"`:写入 `<dnd.root>/custom-effects.json`,跨团复用——适用于魔兽 5e 等整套第三方职业/专长包。
|
|
42
|
+
2. **挂载载体**:
|
|
43
|
+
- **常驻被动** → 将规则 `name` 写入角色卡 `dnd_character(action="update", traits=[..., "<规则名>"])`(纯无条件武器元素附伤也可直接填武器的 `riders` 字段)。
|
|
44
|
+
- **限时增益/姿态/诅咒** → 用 `dnd_resource(action="use", ..., apply_state="<规则名>")` 或 `dnd_apply(add_conditions=["<规则名>"])` 激活。
|
|
45
|
+
- **地面/空间持续区域** → 战斗中用 `dnd_position(action="zone", name="<区域名>", ...)` 放置。
|
|
46
|
+
3. **同步记入团档约定**:调用 `dnd_chronicle(action="add", kind="ruling", text="...")` 记录文字裁定,确保跨压缩与战后交接一致。
|
|
47
|
+
|
|
48
|
+
> **子代理权限边界**:独立战斗子代理接管期间仅可调用 `dnd_rule(action="list" | "show")` 查询已登记规则;新增(`define`)或移除(`remove`)须在主 DM 阶段与玩家确认。
|
|
49
|
+
|
|
50
|
+
### 第 2 步:安全公式语法
|
|
51
|
+
公式由确定性递归下降解析器求值(不使用 `eval`):
|
|
52
|
+
- **可用变量**:`level`、`prof`、`slot_level`、`str`..`cha`、`str_mod`..`cha_mod`、`hp`、`max_hp`。
|
|
53
|
+
- **运算符与函数**:`+`、`-`、`*`、`/`、括号 `(...)`、`min(a, b, ...)`、`max(a, b, ...)`、`floor(x)`、`ceil(x)`、`abs(x)`。
|
|
54
|
+
|
|
55
|
+
### 第 3 步:映射到 6 类钩子
|
|
56
|
+
|
|
57
|
+
| 钩子字段 | 核心配置项 | 典型场景 |
|
|
58
|
+
| :--- | :--- | :--- |
|
|
59
|
+
| `attack_mod` | `to_hit_formula`, `bonus_dice`, `advantage`, `crit_on` (18–20), `weapon_only`, `melee_only`, `ranged_only` | 战斗姿态、命中图腾、扩展重击区间 |
|
|
60
|
+
| `hit_rider` | `damage_dice`, `bonus_formula`, `damage_type`(如 `"闪电"` 或 `"武器同型"`), `marked_target_only`, `weapon_only`, `melee_only`, `str_attack_only`, `advantage_only`, `once_per_turn` | 元素附伤、巨像屠夫(`once_per_turn`)、优势触发附伤(`advantage_only`)、印记类锁定附伤(`marked_target_only`) |
|
|
61
|
+
| `defense_mod` | `ac_bonus`(整数或公式), `resistant`, `immune`, `vulnerable`, `attacker_advantage` | 护甲增益、元素抗性/免疫(如 `["闪电", "雷鸣"]` 或 `["*"]`) |
|
|
62
|
+
| `save_mod` | `abilities`(`["con", "wis"]` 或 `"all"`), `bonus_formula`, `bonus_dice`, `advantage`, `vs_tags`(如 `["concentration", "毒素"]`) | 专注豁免优势、特定伤害/状态豁免加成 |
|
|
63
|
+
| `aura` | `radius`, `radius_at_18`, `target`(`"allies"`/`"enemies"`/`"all"`), `include_self`, `save_bonus_formula`, `slow_factor`, `hazard`(`{damage_dice, upcast_per_slot, base_slot, damage_type, save_ability, half_on_save}`) | 圣武士/魔兽光环、萨满图腾光环、持续伤害减速光环 |
|
|
64
|
+
| `heal_mod` | `bonus_formula`, `self_heal_on_other_formula`, `pool_formula`, `cap_at_half_max_hp` | 治疗量加成、治疗他人自愈、固定治疗池 |
|
|
65
|
+
|
|
66
|
+
### 第 4 步:常用注册示例
|
|
67
|
+
|
|
68
|
+
#### 示例 1:个人宿命被动(每回合首击闪电附伤 + 双抗 + 专注优势)
|
|
69
|
+
```json
|
|
70
|
+
{
|
|
71
|
+
"action": "define",
|
|
72
|
+
"scope": "campaign",
|
|
73
|
+
"name": "风暴遗誓·二阶",
|
|
74
|
+
"description": "获得闪电与雷鸣抗性,每回合首次武器命中额外造成 1d8 闪电伤害。",
|
|
75
|
+
"defense_mod": { "resistant": ["闪电", "雷鸣"] },
|
|
76
|
+
"hit_rider": { "damage_dice": "1d8", "damage_type": "闪电", "weapon_only": true, "once_per_turn": true }
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
```json
|
|
80
|
+
{
|
|
81
|
+
"action": "define",
|
|
82
|
+
"scope": "campaign",
|
|
83
|
+
"name": "冥河炉心",
|
|
84
|
+
"description": "体质专注豁免与对抗毒素豁免具有优势,并获得毒素抗性。",
|
|
85
|
+
"defense_mod": { "resistant": ["毒素"] },
|
|
86
|
+
"save_mod": { "abilities": ["con"], "advantage": "advantage", "vs_tags": ["concentration", "毒素", "中毒"] }
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
随后执行 `dnd_character(action="update", name="角色名", traits=[..., "风暴遗誓·二阶", "冥河炉心"])`。
|
|
90
|
+
|
|
91
|
+
#### 示例 2:条件触发专武附伤(仅优势命中时追加雷鸣伤害)
|
|
92
|
+
若武器每次命中都无条件附带元素伤害(如烈焰舌 `+2d6 火焰`),直接在 `dnd_character` 的 `weapons` 中填 `riders: [{"damage": "2d6", "damage_type": "火焰"}]` 即可;若需条件触发(如优势命中才触发):
|
|
93
|
+
```json
|
|
94
|
+
{
|
|
95
|
+
"action": "define",
|
|
96
|
+
"scope": "campaign",
|
|
97
|
+
"name": "段云·雷鸣",
|
|
98
|
+
"description": "具有优势的近战武器攻击命中时额外造成 1d6 雷鸣伤害。",
|
|
99
|
+
"hit_rider": { "damage_dice": "1d6", "damage_type": "雷鸣", "weapon_only": true, "melee_only": true, "advantage_only": true }
|
|
100
|
+
}
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
#### 示例 3:跨团复用的职业光环(`scope: "global"`)
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"action": "define",
|
|
107
|
+
"scope": "global",
|
|
108
|
+
"name": "献祭光环",
|
|
109
|
+
"concentration": false,
|
|
110
|
+
"default_rounds": 10,
|
|
111
|
+
"description": "10 尺内敌人在回合开始或首次进入时须过敏捷豁免,失败受 2d6 火焰伤害,成功减半。",
|
|
112
|
+
"aura": {
|
|
113
|
+
"radius": 10,
|
|
114
|
+
"target": "enemies",
|
|
115
|
+
"hazard": { "damage_dice": "2d6", "damage_type": "火焰", "save_ability": "dex", "half_on_save": true }
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 三、路径二:源码级扩展(开发维护参考)
|
|
123
|
+
|
|
124
|
+
当新机制超出上述声明式钩子表达范围(例如新增特殊反应窗口阶段、多目标共享生命链接等)且在源码仓库开发时:
|
|
125
|
+
1. 核心模块位于 `src/dnd/`:`custom-effects.ts` / `formula.ts`(钩子与公式)、`conditions.ts`(状态与回合推进)、`zones.ts` / `battlefield.ts` / `battle-image.ts`(持续区域、2.5D 飞行与 `/dnd status` SVG 渲染)、`campaign.ts`(存档结构,新增字段须设为可选 `?` 以兼容旧团档)。
|
|
126
|
+
2. 修改后运行 `npm test`、`npm run build` 与 `npm run typecheck:client` 完成校验。
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: qqbot-sticker-maker
|
|
3
|
+
description: 制作、微调、构图对齐、抠图预览并入库 dsh-dungeon-master 的 Q 版透明表情包(PNG + stickers/index.json)。支持源梗图比例测量与叠影对比、局部拼接防漂移、白底泛洪抠图/原生透明导出、深浅底 1:1 预览及原子注册。当用户要求生成机器人角色表情包、改编梗图动作或修正贴纸细节并入库时加载。
|
|
4
|
+
metadata:
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# QQ Bot 表情包制作与入库(`qqbot-sticker-maker`)
|
|
9
|
+
|
|
10
|
+
先选定目标角色与版本,再将角色身份参考与源表情的构图结合。默认交付 `256×256` 透明 RGBA PNG、`1024×1024` 母版,以及从**最终 256px 文件解码生成**的深底 `#252830` / 浅底 `#F2F4F8` 对照预览。保留原始生成文件并实际核验尺寸;默认无外白边(若源梗图本身需要白边则随源图)。
|
|
11
|
+
|
|
12
|
+
> **素材与版权边界**:社区同人立绘与本机私有参考图不随 npm 包分发(已被 `.gitignore` / `.npmignore` 排除)。已整理的社区形象出处、原始链接与 SHA-256 校验值见 [`resources/zipzippipe/sources.json`](./resources/zipzippipe/sources.json);如需使用参考图,请按该清单核对授权并放置于本机 `resources/` 目录,或使用用户当场提供的角色设定图。
|
|
13
|
+
|
|
14
|
+
## 路径与工具
|
|
15
|
+
|
|
16
|
+
- 记 `SKILL_ROOT` 为本 `SKILL.md` 所在目录,配套脚本位于 `<SKILL_ROOT>/scripts/sticker-cli.cjs`。不要假定 shell 当前工作目录。
|
|
17
|
+
- 图片生成与修改使用当前环境实际提供的生图工具;先用看图工具检查每张输入参考与生成结果。
|
|
18
|
+
- 生图工具支持透明底时直接请求真实 alpha 并保留输出;**仅当输入确为白底稿时才运行 `sticker-cli.cjs process`**,不要对白发或原生透明图重复泛洪抠图。
|
|
19
|
+
- 坐标网格、局部拼接、透明导出、预览与索引注册均通过 `<SKILL_ROOT>/scripts/sticker-cli.cjs` 离线执行(依赖环境中已安装的 `sharp`,各子命令支持 `--help`)。
|
|
20
|
+
|
|
21
|
+
## 角色视觉参考
|
|
22
|
+
|
|
23
|
+
生图前先读 [`references/character-specs.md`](./references/character-specs.md) 的对应章节;社区同人出处见 [`resources/zipzippipe/sources.json`](./resources/zipzippipe/sources.json)。
|
|
24
|
+
|
|
25
|
+
| 角色 / 文件前缀 | 原设参考(本机可选缓存路径) | Q 版补充参考(本机可选缓存路径) |
|
|
26
|
+
| --- | --- | --- |
|
|
27
|
+
| Gemini:`gemini_*`;哈基米:`cat_*` | `resources/zipzippipe/gemini-original.jpg` | `resources/hakimi_canonical_full.png`、`resources/hakimi_torso_skirt_zoom.png` |
|
|
28
|
+
| Claude:`claude_*` | `resources/zipzippipe/claude-original.jpg` | 与黑发、工程服等其他版本区分 |
|
|
29
|
+
| DeepSeek 大肥鱼:`fish_*` | `resources/zipzippipe/deepseek-original.jpg` | `resources/feiyu_canonical_maid_ref.png`(上善无形原角色 → ZipZipPipe 女仆二创) |
|
|
30
|
+
| GPT:`gpt_*` | `resources/zipzippipe/gpt-original.jpg` | `resources/zipzippipe/gpt-turnaround.png` |
|
|
31
|
+
|
|
32
|
+
用户当次明确指定的要求优先:原设图负责身份、物种与服装结构,源表情负责动作、神态、构图与笔触;不要把正常头身比立绘的写实光影照搬进蜡笔平涂 Q 版。未收录的新角色直接从用户提供的参考图提取特征。
|
|
33
|
+
|
|
34
|
+
## 制作流程
|
|
35
|
+
|
|
36
|
+
### 1. 固定输入与比例测量
|
|
37
|
+
|
|
38
|
+
核对目标 `stickers/index.json` 的 `look` 描述与实际图片,标明每张输入属于「编辑目标 / 身份参考 / 风格参考」。换角色改编时同步检查手持道具是否绑定源角色品牌标志(如四角星抱枕 → 对应角色标志物)。
|
|
39
|
+
|
|
40
|
+
改编源梗图时先运行 `align-guide`(合集大图加 `--crop "x,y,w,h"`),查看网格图与 JSON 指标,记录头部跨度、视线倾角、五官有无眼白、道具纵向区间与底部截断线;详见 [`references/meme-adaptation-notes.md`](./references/meme-adaptation-notes.md):
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
node <SKILL_ROOT>/scripts/sticker-cli.cjs align-guide \
|
|
44
|
+
--ref stickers/cat_夸夸我.png \
|
|
45
|
+
--out-dir tmp/imagegen/example \
|
|
46
|
+
--tag baseline \
|
|
47
|
+
--output tmp/imagegen/example/baseline.json
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### 2. 生图、叠影对照与局部拼接
|
|
51
|
+
|
|
52
|
+
同时传入源表情与目标角色参考,保持粗颗粒深色描边与柔和哑光色块,写清画面文字内容与位置。
|
|
53
|
+
|
|
54
|
+
生成初稿后运行 `align-guide --compare <draft>` 检查「原图 / 红青叠影 / 新稿」三栏对比图。整体外框接近不代表构图合格,需同时核对眼睛位置、手势与道具上沿。若主体已对齐、仅局部服饰需重绘,用 `sticker-cli.cjs splice`(`--clear-box` + `--patch-crop` + `--target-box`)锁定已通过主体,防止整图重绘漂移;最多迭代两轮针对性修正。
|
|
55
|
+
|
|
56
|
+
### 3. 透明导出与 1:1 尺寸验收
|
|
57
|
+
|
|
58
|
+
- **原生透明稿**:直接运行 `export`,保留原始 alpha 并生成 `1024` 母版、`256` 成品与深浅底预览。
|
|
59
|
+
- **白底稿**:先运行 `process` 泛洪去白底,检查报告中的 `enclosedWhitePockets`——确认属于背景孔洞的坐标传 `--extra-seeds`,白发、眼白、书页、浅色百褶裙或女仆荷叶边传 `--protect-boxes` 或配合 `--gap-close-radius` 保护;随后将透明母版交给 `export` 生成从**最终 256px PNG 解码的 1:1 像素预览**。
|
|
60
|
+
- 校验成品为正方形 RGBA PNG、同时包含透明背景像素与可见前景像素、体积 `≤ 300 KiB`,并用看图工具目视核查小字清晰度、发丝白边与实心浅色区域。
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
node <SKILL_ROOT>/scripts/sticker-cli.cjs export \
|
|
64
|
+
--input tmp/imagegen/example/generated.png \
|
|
65
|
+
--name gpt_求夸 \
|
|
66
|
+
--tag v1 \
|
|
67
|
+
--out-dir tmp/imagegen/example/final \
|
|
68
|
+
--output tmp/imagegen/example/export-v1.json
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### 4. 交付与入库注册
|
|
72
|
+
|
|
73
|
+
仅要求「试做 / 看看效果」时交付预览图与成品路径,不改正式表情库;获得明确入库授权后运行 `register`(可先加 `--dry-run` 预检,通过 `--stickers-dir <cwd>/stickers` 指定目标机器人的表情目录):
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
node <SKILL_ROOT>/scripts/sticker-cli.cjs register \
|
|
77
|
+
--input tmp/imagegen/example/final/gpt_求夸_v1.png \
|
|
78
|
+
--file gpt_求夸.png \
|
|
79
|
+
--stickers-dir ./stickers \
|
|
80
|
+
--emotion "求夸" \
|
|
81
|
+
--look "白紫龙娘抱结形抱枕,眼巴巴等夸奖" \
|
|
82
|
+
--note "做完事想求一句夸时用" \
|
|
83
|
+
--dry-run \
|
|
84
|
+
--output tmp/imagegen/example/register-check.json
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
`emotion` 写简短情绪词,`look` 写客观画面描述,`note` 写触发语境;避免与运行中的机器人在同一时刻并发改写 `index.json`。
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# 角色视觉规范:原设与本地 Q 版
|
|
2
|
+
|
|
3
|
+
本表区分社区原设与本地 Q 版贴纸系列的视觉约定。生图前查看目标角色参考图与源表情,明确两者分别负责「身份/服装」与「动作/笔触」。数值色板与腰宽是既有 `cat_*` 系列的约定,不覆盖用户选定的其他版本或姿态。社区原设出处与校验哈希见 [`../resources/zipzippipe/sources.json`](../resources/zipzippipe/sources.json)(参考图文件本身仅存本机,不随 npm 包分发)。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. 通用画风规范(蜡笔手绘 Q 版贴纸风)
|
|
8
|
+
|
|
9
|
+
| 维度 | 硬性要求 | 严禁出现的错误 |
|
|
10
|
+
| :--- | :--- | :--- |
|
|
11
|
+
| **画布底色** | 优先真实透明 RGBA;仅白底稿走 `process` | 不把棋盘格或实色背景误当透明,不重复抠原生透明图 |
|
|
12
|
+
| **外白边** | **默认无贴纸外白边(No outer white border)**,最终导出 `256×256` 透明 RGBA PNG | 除非用户明确要求,严禁在外轮廓外再套一圈白边或阴影 |
|
|
13
|
+
| **线条质感** | 略带颗粒感的手绘蜡笔 / 粗彩铅深色描边(`#2D1636` 深梅紫或 `#1E2B4D` 深藏蓝) | 严禁生硬矢量细线、厚涂无描边、3D 渲染感 |
|
|
14
|
+
| **上色与光影** | 哑光平涂柔和粉彩色块;简洁眼神光按源表情保留 | 避免把正常比例原设的写实光影或复杂玻璃眼照搬成 Q 版 |
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 2. 哈基米猫娘(`cat_*`)人设规范
|
|
19
|
+
|
|
20
|
+
**本机可选参考图**(若已缓存于 `<SKILL_ROOT>/resources/` 或 `<cwd>/stickers/`):
|
|
21
|
+
- 全身与发色基准:`<SKILL_ROOT>/resources/hakimi_canonical_full.png`
|
|
22
|
+
- 胸腰裙局部放大:`<SKILL_ROOT>/resources/hakimi_torso_skirt_zoom.png`
|
|
23
|
+
- 已入库笔触基准:`<cwd>/stickers/cat_看书.png`、`cat_认栽.png`、`cat_好耶.png`
|
|
24
|
+
|
|
25
|
+
### 2.1 发色、猫耳与头饰(统一 `蓝粉紫` 渐变)
|
|
26
|
+
- **三段柔和渐变发色**:
|
|
27
|
+
- 头顶、刘海与猫耳外侧:**清冷矢车菊蓝紫(Cool Periwinkle-Blue `#A0ACEA`)**;
|
|
28
|
+
- 中段长发与两侧盘发团子:**绣球蓝紫(Hydrangea Blue-Lavender `#B6ACEA`)**;
|
|
29
|
+
- 发尾尖端:**柔和兰花粉紫(Pastel Orchid-Pink `#E2B6EA`)**。
|
|
30
|
+
- **红线**:严禁画成暖洋红顶或纯粉红头发。
|
|
31
|
+
- **猫耳与呆毛**:头顶一根向上微弯的呆毛;一对大猫耳(外侧矢车菊蓝紫 `#A0ACEA`,内耳浅樱粉 `#F7C6D2` + 白色绒毛簇),**绝对不能画人类耳朵**。
|
|
32
|
+
- **发型结构**:两侧耳朵下方各盘一个圆润螺旋发团(Coiled side buns),后侧垂落蓬松微卷长发。
|
|
33
|
+
- **星形发饰**:画面右侧(角色左耳下方)佩戴一枚**金边粉蓝紫渐变的「四角星 `✦`」发卡**(下方可缀一粒迷你小四角星)。**严禁画成五角星 `★`!**
|
|
34
|
+
|
|
35
|
+
### 2.2 异色瞳与五官
|
|
36
|
+
- **异色瞳方向(以看图者视角为准)**:
|
|
37
|
+
- **画面左侧(角色右眼)**:哑光浆果粉红 / 玫红(Matte Berry-Pink `#B84B7C` ~ `#C95B8B`);
|
|
38
|
+
- **画面右侧(角色左眼)**:哑光琥珀金黄(Matte Ochre-Gold `#DEAC4B` ~ `#E5B85B`)。
|
|
39
|
+
- **眼白与眼神光**:
|
|
40
|
+
- 冷面看书等表情不额外加白色高光;求夸、兴奋等可以随源图保留简洁眼神光;
|
|
41
|
+
- **是否有眼白取决于源梗图**:若源梗图是冷面死鱼眼/豆豆眼(如《认真看书》),去掉眼白、缩小瞳孔(约常规 `0.8×`)以还原无神感;若是委屈/震惊大眼梗图,按源梗图比例保留眼白。
|
|
42
|
+
|
|
43
|
+
### 2.3 服装解剖
|
|
44
|
+
1. **平胸体型**:胸部平坦利落,不画乳沟、隆起弧线或紧身撑起感。
|
|
45
|
+
2. **上半身挂脖露肩短上衣**:
|
|
46
|
+
- 深紫黑/暗夜蓝底色(`#282742`)配细金边;
|
|
47
|
+
- 中式小立领,咽喉正中扣一粒迷你四角星 `✦`;
|
|
48
|
+
- **胸口正中是扁平白色菱形镂空/白衬块(`◇`),白块中心有一颗金边蓝紫四角星 `✦`**(不画成盘扣卷草纹)。
|
|
49
|
+
3. **腰封与菱形露脐小腹**:
|
|
50
|
+
- 胸衣下缘衔接**倒 V 形(`/\`)浅紫腰封(`#BA93EC`)**,正中嵌一颗较大四角星 `✦`;
|
|
51
|
+
- 露出平坦纤细的菱形小腹与一竖短肚脐线(小腹宽度约头宽 `28%~34%`);
|
|
52
|
+
- **分离式宽袖**:露肩设计,大袖套套在手臂中段,袖子、后发与腰腹/裙摆之间保留清晰的背景空隙(Cutout Corridors),避免衣服跟头发粘成深色块。
|
|
53
|
+
4. **A 字百褶短裙(构图截断线低于肚脐时画出裙头)**:
|
|
54
|
+
- 向外微张的 A 字伞裙轮廓;
|
|
55
|
+
- **深紫前裙片(`#2A2F50`)与两侧/下摆浅色白紫百褶条纹(`#F1EEFB`)相间交替**;
|
|
56
|
+
- 两侧胯部各饰一颗四角星 `✦`,前裙片上方垂挂纤细金色腰链与中心小四角星 `✦`。
|
|
57
|
+
- *抠图提示*:浅色百褶裙衬接近白色,白底稿调用 `process` 时将该区域加入 `--protect-boxes`。
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 3. 大肥鱼鲸娘女仆(`fish_*`)人设规范
|
|
62
|
+
|
|
63
|
+
**本机可选参考图**:`<SKILL_ROOT>/resources/feiyu_canonical_maid_ref.png`
|
|
64
|
+
|
|
65
|
+
### 3.1 外观与服饰特征
|
|
66
|
+
- **发色与发型**:明亮钴蓝 / 海蓝色短发(`#4A69BD` ~ `#5B78C7`),头顶有一根圆弧呆毛,两侧发梢向外微翘。
|
|
67
|
+
- **鲸鳍耳与鲸尾(核心物种特征)**:
|
|
68
|
+
- 头部两侧长着**上蓝下白(带波浪白边)的鲸鱼胸鳍状侧耳**,斜向下张开,不画人类耳朵或猫耳;
|
|
69
|
+
- 身后露出上翘的**蓝色双叶鲸鱼尾鳍**。
|
|
70
|
+
- **黑白蓝女仆装**:
|
|
71
|
+
- 头戴**白色荷叶边女仆发箍**,画面右侧(角色左耳上方)系一枚**天蓝色蝴蝶结**;
|
|
72
|
+
- 深藏蓝女仆裙配白色荷叶边领口、白色围裙与白色蓬松袖口;
|
|
73
|
+
- 胸前领口系**深藏蓝蝴蝶结,中心嵌一枚蓝色菱形宝石胸针**。
|
|
74
|
+
|
|
75
|
+
### 3.2 表情基调
|
|
76
|
+
- 既有系列以面无表情豆豆眼 / 半眯死鱼眼 / 礼貌微笑的反差感为主;「求夸」「好耶」等正向情绪表情则随源图自然表现,不强行套用死鱼眼。原设长发女仆与本地短发 Q 版按当次指定版本选用。
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 4. ZipZipPipe 四位社区原设摘要
|
|
81
|
+
|
|
82
|
+
这里仅整理画面可见的视觉结构特征;原图出处见 [`../resources/zipzippipe/sources.json`](../resources/zipzippipe/sources.json)。
|
|
83
|
+
|
|
84
|
+
### Gemini(`gemini_*`;本地哈基米 Q 版用 `cat_*`)
|
|
85
|
+
- 蓝紫到粉紫长发、猫耳猫尾,画面左眼偏玫红、右眼偏金色,四角星饰物;深蓝紫与白色金边露肩宽袖裙装。
|
|
86
|
+
|
|
87
|
+
### Claude(`claude_*`)
|
|
88
|
+
- 橙色长发、琥珀暖色眼睛、画面右侧花形发饰及垂饰,奶油白/橙/黑层叠长裙,白色褶边领口与袖口、深色颈部蝴蝶结。原图手持书本仅为道具,不误加龙角、猫耳或鲸鳍耳。
|
|
89
|
+
|
|
90
|
+
### DeepSeek 大肥鱼女仆版(`fish_*`)
|
|
91
|
+
- 蓝色长发与呆毛、鲸鳍状侧耳、蓝眼、末端分叉鲸尾;深蓝长裙配白色女仆头饰、荷叶边与小鲸鱼图案围裙(上善无形原角色 → ZipZipPipe 女仆二创)。
|
|
92
|
+
|
|
93
|
+
### GPT 白紫龙娘(`gpt_*`)
|
|
94
|
+
- 银白到浅紫长卷发、卷呆毛、双浅银分节龙角、尖侧耳、浅紫双瞳、浅紫膜翼与白紫鳞尾;画面右侧交织结形发饰及流苏,白紫露肩高领礼裙配分离宽袖与结形元素(不简化成普通花朵或四角星)。
|