58 lines
1.3 KiB
Markdown
58 lines
1.3 KiB
Markdown
---
|
||
tag: journal-roll
|
||
icon: 🎲
|
||
title: 掷骰与火花表命令
|
||
---
|
||
|
||
在 Journal 中掷骰或随机抽取火花表内容。优先匹配火花表，否则作为骰子表达式处理。
|
||
|
||
**语法：** `/roll 骰子表达式 | 火花表键名`
|
||
|
||
## 概述
|
||
|
||
`/roll` 命令用于掷骰或随机抽取火花表，并将结果同步到所有客户端。
|
||
|
||
- 如果参数匹配已定义的**火花表** slug，则抽取并发布对应火花表的结果。
|
||
- 否则，作为**骰子表达式**求值并发布掷骰结果。
|
||
|
||
## 示例
|
||
|
||
### 掷骰
|
||
|
||
```
|
||
/roll d20
|
||
/roll 3d6
|
||
/roll 2d8kh1
|
||
/roll 1d20+5
|
||
/roll 4d6k3
|
||
```
|
||
|
||
### 火花表
|
||
|
||
```
|
||
/roll npc
|
||
/roll encounter
|
||
/roll loot
|
||
```
|
||
|
||
## 支持的骰子表达式
|
||
|
||
| 表达式 | 说明 |
|
||
|---|---|
|
||
| `d20` | 单个 20 面骰 |
|
||
| `3d6` | 3 个 6 面骰求和 |
|
||
| `2d8kh1` | 2 个 8 面骰保留最高 1 个 |
|
||
| `1d20+5` | 1 个 20 面骰加 5 |
|
||
| `4d6k3` | 4 个 6 面骰保留最高 3 个 |
|
||
|
||
## 火花表定义
|
||
|
||
火花表在 markdown 文档中通过 `:spark[CSV路径]` 标记声明，系统扫描文档时自动发现。CSV 文件的第一列表头为骰子公式（如 `d6`、`d20`），后续列为数据列。
|
||
|
||
抽取时根据骰子公式投掷，查找对应行并将各列数据作为火花表结果发布。
|
||
|
||
## 权限
|
||
|
||
- **GM**：可使用
|
||
- **玩家**：不可使用
|
||
- **观察者**：不可使用 |