ttrpg-tools/src/doc-entries/journal-spark.md

39 lines
879 B
Markdown
Raw Normal View History

---
tag: journal-spark
icon: 🎰
title: 火花表
---
在 Journal 中通过 `/roll` 命令随机抽取火花表内容用于生成随机遭遇、NPC、物品等。
**语法:** `/roll 火花表键名`
## 概述
火花表通过 `/roll` 命令触发:当参数匹配已定义的火花表 slug 时,自动抽取并发布结果,而非作为骰子表达式处理。
## 示例
```
/roll npc
/roll encounter
/roll loot
```
## 火花表定义
火花表在 markdown 文档中通过 `:spark[CSV路径]` 标记声明CSV 文件的第一列表头为骰子公式(如 `d6`、`d20`),后续列为数据列。系统扫描文档时自动发现这些标记。
```
:spark[npc]
:spark[encounter]
:spark[loot]
```
抽取时根据骰子公式投掷,查找对应行并发布结果。
## 权限
- **GM**:可使用
- **玩家**:不可使用
- **观察者**:不可使用