hypercross
/
ttrpg-tools
2
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ttrpg-tools/src/doc-entries/journal-roll.md

65 lines
1.4 KiB
Markdown
Raw Normal View History

docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
---
tag: journal-roll
icon: 🎲
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
title: 掷骰与种子表命令
description: 在 Journal 中掷骰或随机生成种子表内容。优先匹配种子表，否则作为骰子表达式处理。
syntax: '/roll 骰子表达式 | 种子表键名'
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
props:
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
- name: 参数
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
type: string
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
desc: 骰子表达式（如 3d6、2d8kh1、d20+5）或已定义的种子表 slug
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
---
## 概述
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
`/roll` 命令用于掷骰或随机抽取种子表，并将结果同步到所有客户端。
- 如果参数匹配已定义的**种子表** slug，则抽取并发布对应种子表的结果。
- 否则，作为**骰子表达式**求值并发布掷骰结果。
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
## 语法
```
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
/roll 骰子表达式 | 种子表键名
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
```
## 示例
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
### 掷骰
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
```
/roll d20
/roll 3d6
/roll 2d8kh1
/roll 1d20+5
/roll 4d6k3
```
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
### 种子表
```
/roll npc
/roll encounter
/roll loot
```
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
## 支持的骰子表达式
| 表达式 | 说明 |
|---|---|
| `d20` | 单个 20 面骰 |
| `3d6` | 3 个 6 面骰求和 |
| `2d8kh1` | 2 个 8 面骰保留最高 1 个 |
| `1d20+5` | 1 个 20 面骰加 5 |
| `4d6k3` | 4 个 6 面骰保留最高 3 个 |
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
## 种子表定义
种子表在文档中通过 `:spark[CSV路径]` 指令或 spark 形状的 markdown 表格定义，CSV 文件的第一列表头为骰子公式（如 d6、d20），后续列为数据列。
docs: add new journal command documentation Replace the attribute system documentation with new documentation for the variable system, roll command, link command, and spark command.
2026-07-12 19:09:02 +08:00
## 权限
- **GM**：可使用
- **玩家**：不可使用
refactor: merge /spark command into /roll Consolidate the `/spark` command into `/roll` to simplify the CLI. The `/roll` command now handles both dice notation and spark table slugs. - Update `parseInput` to treat `/roll` arguments as a generic string. - Update `dispatchCommand` to check for spark table matches before evaluating dice notation or variable expressions. - Update command completions to show both dice and spark table suggestions under `/roll`. - Update documentation and UI placeholders to reflect the change.
2026-07-13 14:43:55 +08:00
- **观察者**：不可使用