使用骰子符号进行随机数

您还可以使用RPG骰子标记将随机数字插入到文本中。数字替换以#井号符号开始，后跟包含骰子表达式的{}花括号，例如#{1d6+2}将被替换为一个介于3到8之间的随机数（表达式"1d6+2"表示"掷一个6面的骰子并加2"）。有关支持的骰子表达式语法的更多详细信息，请参阅dicexp crate。

随机查找表格式

支持多种格式来定义随机查找表。支持的格式在此处详细描述。

.txt

在.txt文件中的每一行都将被解析为一个查找表条目，所有可能的值具有相等的权重。

IDs

此查找表的ID就是该文件名，不带.txt扩展名（例如，animal.txt的ID是animal）。

示例

以下是一个ID为animal的随机查找示例，它以相等的概率随机选择dog、cat、bird或rat：animal.txt

dog
cat
bird
rat

.csv

.csv文件被解释为标准的逗号分隔值（CSV）文件（UTF-8编码），其中第一行是标题行，包含列名，所有后续行是每个列的可能值。每个列都是自己的随机查找表。所有行具有相等的概率，除非存在名为weight的列。如果存在weight列，则每行的概率将按相应的weight列中的十进制值加权。

IDs

CSV文件中每列的ID是filename/column（例如，在pet-names/dog文件中，列dog的ID是pet-names/dog）。

示例

以下示例创建了四个不同的随机查找表，ID分别为pet-names/bird、pet-names/cat、pet-names/dog和pet-names/rat：pet-names.csv

bird,cat,dog,rat
pip,paws,spot,whiskers
seed,mew,spike,cheesy
lala,claws,rolf,nibbler

以下示例创建了一个ID为rarity/rarity的查找表，有60%的概率抽取"普通"，30%的概率抽取"不常见"，9%的概率抽取"稀有"，1%的概率抽取"非常稀有"：rarity.csv

weight,rarity
6,common
3,uncommon
0.9,rare
0.1,very rare

.yaml（和.yml）

YAML文件可以包含一个或多个随机查找表，具有任意层级的嵌套深度。在YAML文件中遇到的任何列表都将被解析为查找表，所有项目具有相同的概率，而使用字符串-数字映射来指定加权概率（例如rarity: {common: 6, uncommon: 3, rare: 0.9, "very rare": 0.1}）。表可以通过嵌套的映射对象来组织，每个嵌套都会为查找表ID路径添加一个层级。

IDs

YAML文件中每个随机查找的ID等于文件名（不包含文件后缀）后跟文件中查找表的对象-映射路径。

在简单的只包含列表的文件的情况下（见以下示例中的animal.yaml），ID只是文件名。对于文件底层的对象，ID将是filename/name（见以下示例中的treasure.yaml），而嵌套对象的ID将使用反斜杠分隔符表示嵌套路径，即filename/level1/level2/.../name，见以下colors.yaml示例）。

示例

以下是一个ID为animal的随机查找示例，该查找随机解析为bird、cat、dog或rat中的任何一个，具有相同的概率：animal.yaml

- bird
- cat
- dog
- rat

以下示例创建了一个查找表，创建了两个ID为treasure/money和treasure/junk的表，其中treasure/money中的条目具有不同的概率，但treasure/junk中的所有条目都具有相同的概率：treasure.yaml

money:
  "100 copper pennies": 4
  "10 silver dollars": 1.5
  "1 gold ingot": 0.5
junk:
  - old boot
  - pocket lint
  - broken toy boat

以下示例创建了三个ID为colors/light/primary、colors/paint/primary和colors/paint/secondary/pastel的查找表：colors.yaml

light:
  primary:
    - red
    - green
    - blue
paint:
  primary:
    - red
    - yellow
    - blue
  secondary:
    pastel:
      - peach
      - light green
      - lavender

.json

JSON文件的工作方式与YAML完全相同（见上文）。

IDs

与上述YAML解析相同。

示例

以下是一个ID为animal的随机查找示例，该查找随机解析为bird、cat、dog或rat中的任何一个，具有相同的概率：animal.json

[
 "bird",
 "cat",
 "dog",
 "rat"
]

以下示例创建了一个查找表，创建了两个ID为treasure/money和treasure/junk的表，其中treasure/money中的条目具有不同的概率，但treasure/junk中的所有条目都具有相同的概率：treasure.json

{
 "money": {
  "100 copper pennies": 4,
  "10 silver dollars": 1.5,
  "1 gold ingot": 0.5
 },
 "junk": [
  "old boot",
  "pocket lint",
  "broken toy boat"
 ]
}

以下示例创建三个查找表，其ID分别为：colors/light/primary、colors/paint/primary、colors/paint/secondary/pastel：colors.json

{
 "light": {
  "primary": [
   "red",
   "green",
   "blue"
  ]
 },
 "paint": {
  "primary": [
   "red",
   "yellow",
   "blue"
  ],
  "secondary": {
   "pastel": [
    "peach",
    "light green",
    "lavender"
   ]
  }
 }
}

目录

当你加载一个目录时，twas会递归地扫描目录中所有支持的文件格式并加载所有这些文件。所有加载的文件的ID都将以其在加载目录中的相对文件路径为前缀。因此，如果你加载目录foo/bar，文件foo/bar/animal.txt将具有ID animal，但文件foo/bar/vehicles/cars.txt将具有ID vehicles/cars。

IDs

目录中加载的文件的ID将以其在加载目录中的相对子目录路径为前缀。

示例

给定以下目录结构和上面的文件示例

resources/
 ├─ adventure/
 │   ├─ rarity.csv
 │   └─ treasure.yaml
 ├─ colors.yaml
 └─ pets/
     ├─ animal.txt
     └─ pet-names.csv

则加载resources目录将注册以下随机查找表ID列表

adventure/rarity/rarity
adventure/treasure/money
adventure/treasure/junk
colors/light/primary
colors/paint/primary
colors/paint/secondary/pastel
pets/animal
pets/pet-names/bird
pets/pet-names/cat
pets/pet-names/dog
pets/pet-names/rat

.zip

当twas加载一个.zip文件时，它会提取它并将它的内容视为目录（见上面）。

IDs

加载到zip存档文件中的文件的ID将以其在加载zip存档中的相对子目录路径为前缀。

示例

给定以下zip存档结构和上面的文件示例

resources.zip
 ├─ adventure/
 │   ├─ rarity.csv
 │   └─ treasure.yaml
 ├─ colors.yaml
 └─ pets/
     ├─ animal.txt
     └─ pet-names.csv

则加载resources目录将注册以下随机查找表ID列表

adventure/rarity/rarity
adventure/treasure/money
adventure/treasure/junk
colors/light/primary
colors/paint/primary
colors/paint/secondary/pastel
pets/animal
pets/pet-names/bird
pets/pet-names/cat
pets/pet-names/dog
pets/pet-names/rat

许可和再分发

twas源代码受Mozilla Public License，v. 2.0条款约束。