---
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**：可使用
- **玩家**：不可使用
- **观察者**：不可使用