跳至主要内容

RPG 系统

Fate 与 Fudge 骰子

符号骰面、Fate 数值与系统记法。

记法与 API

fate() 在混合批次中默认掷四颗骰子。fate(6) 和 fate(dice=6) 可更改数量;dice 必须是正整数。在 TypeScript 中集成时,请使用 rollFateDice({ dice: 4 }, options),或省略它的第一个参数。

import { rollFateDice } from '@erpg/dicecore/systems/fate'
const roll = rollFateDice({ dice: 4 }, { seed: 'fate-42' })
console.log(roll.total, roll.dice.map(die => die.fateValue))

骰面与计分

该 API 掷物理 d6 骰子,以保留 3D 骰面。1–2 点为 minus(−1),3–4 点为 blank(0),5–6 点为 plus(+1)。total 对 fateValue 求和,范围从 −N 到 +N。每颗骰子都有 profileId: 'fate-df'、一个 1 到 6 之间的 rawValue、faceKey、symbols 和 fateValue。

通用 dF 记法同样产生 −1/0/+1,但它的骰面已经转换完成。要忠实呈现物理骰面,请使用 Fate API。baseRoll 默认是完整的;{ detail: 'compact' } 返回一个不含分组、事件或输出的摘要,同时在 roll.dice 中保留语义骰子。种子/重放遵循 Core 契约。

试一试这些示例

Fate 骰子

Fate / Fudge 骰子

投掷具有减号、空白和加号面的 Fate 骰子。标准骰池为四枚骰子,二维结果和三维骰子都会保留每个符号面及总值。

系统调用

支持的简写和变体

使用 fate 或 fatedice。命名参数 dice、dado 或 dados 均可指定骰子数量;省略时,默认投掷四颗骰子。

调用别名
fate(...)fatedice(...)
命名参数
fate(dice=4)fate(dados=4)fate(dado=4)
位置参数形式
fatedice(4)fate()
−总值减 1
0不改变总值
+总值加 1