JSON 牌堆编写：从入门到进阶

Hikari Sakurai

使用《署名—非商业性使用—相同方式共享 4.0 协议国际版》（CC BY-NC-SA 4.0）进行授权
https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.zh-Hans

本文参考了星空的原版指南，参考内容已获授权。

本文件基于 Dice! 系列骰娘编写，希望可以给你的牌堆编写带来帮助。在开始之前，请确认以下内容：

请确认使用插件是否为溯洄和 Shiki 开发的 Dice!，方法为输入 .bot 后返回语句包含 by 溯洄 Shiki ，并请记住你的具体版本号（如 2.4.0beta3(563)）
请确认你有足够的耐心看完本文档，并且在操作时对自己有足够的包容心。如果你是第一次编写牌堆，出现任何问题都是很正常的，请勿仓促放弃。

如果你已经做好了这些准备，你可以开始学习如何编写属于你的第一个牌堆了~

Hikari Sakurai

一、JSON 牌堆编写：入门篇
　1.0 编写建议
　 1.1 牌堆文件构成
　 1.2 简单的牌堆编写
　 1.3 特别注意
 二、JSON 牌堆编写：进阶篇
　2.0 JSON 和牌堆的一些理论基础
　　 2.0.1 JSON 的标准格式
　　 2.0.2 是不是放回抽取？
　　2.0.3 权重不同怎么办？
　　2.0.4 我想生成随机数字怎么办？
　　2.0.5 可以发送图片吗？
　2.1 引例
　 2.2 用 YAML 格式编写牌堆
　 2.3 用 Excel 编写牌堆
 三、结语

Hikari Sakurai

一、JSON牌堆编写：入门篇

这一部分我们将会介绍 JSON 牌堆的一些基础知识，并尽量采用通俗易懂的语言说明。

如果你认真阅读了这一部分，你应当可以编写一个简单的牌堆了。

1.0 编写建议

尽管使用 Windows 默认的记事本完全可以达到编写牌堆的条件，但是还是建议使用 Notepad++、Visual Studio Code 等软件编写。如您使用其他的 IDE ，也可以保持您原有的习惯。

尽管询问群友或网友是一个解决问题的方案，但是笔者仍然建议在此之前先查看已有的正确的牌堆文件进行研究——在这个方面，自行“踩雷”后编写牌堆有助于你编写其他的牌堆。

一个命名方面的警告：
因为dice会在一开始把牌堆文件读取，所以支持跨牌堆调用。因此，如果有两个相同的抽取关键词则有可能导致调用错误。因此，尽量不要使用常用命名如 时间，天气，性别 等。

Hikari Sakurai

1.1 牌堆文件组成

首先我们打开一个牌堆文件

{
    "点心": ["橙子", "荔枝", "巧克力", "樱桃", "青苹果", "山楂", "牛奶", "葡萄酒", "啤酒", "白巧克力", "圣代", "奶茶", "红茶","马卡龙","布丁", "咖啡", ,"可乐", "鱼子酱", "蘑菇浓汤", "罗宋汤", "调制酒"], 
	"食物": ["汉堡", "面条", "肉泥", "牛排", . "猪排", "羊排", "奶酪", "披萨", "面包", "香肠", "方便面", "热狗", "火腿", "三明治", "蛋挞", ."空心粉", "沙拉", "烤鱼", "土豆饼"],
	"今天吃什么": ["\n您 今天的伙食如下一\n早餐: [{%食物}] 和[{%点心}] \n午餐: [{%食物}] , [{%食物}] 搭配[{%点心}] \n晚餐: [{%食物}] 搭配[{%点心}] "]
}

可以看到牌堆组成并不复杂，整个文本被 { } 花括号包裹，（以第二行为例子）由类别 "点心" 参数 [“橙子”,……,”调制酒”] 组成，另外还包含（第四行为例） {%食物} 引用，\n 换行符组成。

Hikari Sakurai

1.2 牌堆书写

看到上面的组成是不是觉得很简单，现在我们举个例子：

假设我要写一个牌堆首先要做的就是把 { } 花括号打出来，就像这样：（注意：这里使用的符号均为英文半角，牌堆中的符号同理不要写成了中文全角，如果忘记了花括号的话牌堆会报错）

{}

之后输入第一个项目，命名为 目标1

{
	"目标1"
}

接下来开始给 目标1 写包含项，就是在中括号 [ ] 里面的数据，命名为 参数1

{
	"目标1": [
		"参数1"
	]
}

但是我要写的参数不止一个怎么办呢？没关系，用 , 把参数隔开

{
	"目标1": [
		"参数1",
		"参数2",
		"参数n"
	]
}

当我们完成第一个项目的编写之后，接下来便是第二个项目的编写，方法步骤与上面相同，命名为 项目2 （注意：项目与项目之间要用 , 隔开）

{
	"目标1": [
		"参数1",
		"参数2",
		"参数n"
	],
	"目标2": [
		"参数1",
		"参数2",
		"参数n"
	]
}

到现在，我们已经把所有的项目参数写完了，我们要在抽卡中把这些参数体现出来要怎么做呢？我们还要再写一个项目，命名为 抽卡 ，内容如下所示：

{
	"目标1": [
		"参数1",
		"参数2",
		"参数n"
	],
	"目标2": [
		"参数1",
		"参数2",
		"参数n"
	],
	"抽卡":[
		"恭喜你在牌堆中抽到了这个物品：{%目标1}它的参数是：{%目标2}"
	]
}

{%目标1} 和 {%目标2} 的作用就是引用的作用，只要我们对骰娘发送 .draw 抽卡，得到的反馈中就包含了 目标1 ， 目标2 中的参数（多次引用同理）

如果我们觉得这个语句的格式需要调整，例如换行，我们只要在需要换行的地方输入 \n 这个换行符号就行了（特别注意，禁止使用回车键换行），就像这样：

["恭喜你在牌堆中抽到了这个\n物品：{%目标1}\n它的参数是：{%目标2}"]

是不是很简单？现在让我们加入写牌堆队伍中吧~

Hikari Sakurai

1.3 特别注意（包含错误示范，请避免出现此类错误）

牌堆的后缀名称为 .json，如果是用记事本写的牌堆请将后缀名 .txt 更改为 .json （此类错误为文件后缀问题）；
请注意开头和结尾的花括号 {} 避免遗漏；
文档编码请使用 UTF-8 以避免无法读取；
注意检查符号使用，请勿输入全角符号（下图为错误输入）
```
   {
   	“目标1”：[
   		“参数1”
   	]
   }
```
（事实上，如果你在用 Visual Studio Code 编写，会看到错误提示）

正确输入应为：
```
   {
   	"目标1": [
   		"参数1"
   	]
   }
```
项目与项目之间，参数与参数之前请用 , 隔开，避免出错（下图为错误示范）
```
   {
   	"目标1": [
   		"参数1" "参数2" "参数n"
   	]
   }
```
（事实上，如果你在用 Visual Studio Code 编写，会看到错误提示）

正确输入应为：
```
   {
   	"目标1": [
   		"参数1", "参数2", "参数n"
   	]
   }
```

注意最后一条项目不要添加逗号，否则会出现错误。（下面为错误示范）

   {
   	"目标1": [
   		"参数1", "参数2", "参数n",
   	],
   	"目标2": [
   		"参数1", "参数2", "参数n",
   	],
   }

（事实上，如果你在用 Visual Studio Code 编写，会看到错误提示）

正确输入为：

   {
   	"目标1": [
   		"参数1", "参数2", "参数n"
   	],
   	"目标2": [
   		"参数1", "参数2", "参数n"
   	]
   }

Hikari Sakurai

二、JSON牌堆编写：进阶篇

很高兴你已经是一位牌堆的作者了，也很高兴你有兴趣继续学习牌堆的更多写法。

后面介绍的内容对你可能会有一些挑战，但是没关系，慢慢读下去。相信看完这部分，你会发现更多有趣的编写思路。

nya~

Hikari Sakurai

2.0 JSON和牌堆的一些理论基础

这一节的目的是告诉你更多的你可以在牌堆中实现的内容。

请注意，这一节有的内容可能不适用于某些版本（包括 CQ 版本和 Dice! 版本），请在尝试本节内容之前确认版本！

Hikari Sakurai

2.0.1 JSON的标准格式

下面给出了一个示例牌堆，这个牌堆你可以直接保存为一个名为 奶茶.json 的文件使用：

{
    "咖啡": ["美式咖啡", "可可拿铁咖啡", "拿铁咖啡", "青稞拿铁咖啡", "珍珠拿铁咖啡", "香草拿铁咖啡", "法式奶霜咖啡", "焦糖玛奇朵", "香草拿铁", "荔枝气泡水咖啡", "焦糖茶拿铁", "摩卡", "抹茶拿铁", "榛果拿铁", "香草馥芮白", "豆奶拿铁"], 
    "想不到啥分类": ["香草星冰乐", "榛果风味摩卡星冰乐", "鲜百香双响炮", "鲜百香绿茶", "金桔柠檬汁", "鲜柠檬绿茶", "柠檬椰果养乐多", "芒果养乐多", "柠檬红茶", "清香乌龙茶", "百香三重奏", "冰淇淋红茶", "红茶玛奇朵", "阿萨姆红茶", "百香绿", "翡翠柠檬", "蜂蜜绿", "葡萄柚绿", "养乐多绿", "黑糖红茶", "抹茶", "柠檬椰果养乐多", "杨枝甘露", "芝士奶盖鲜红茶", "芝士奶盖鲜绿茶", "凤梨四季春", "巧克力星冰乐", "抹茶豆奶星冰乐", "摩卡星冰乐", "浓缩咖啡星冰乐", "冰摇桃桃乌龙茶", "冰摇芒果花草茶", "冰摇柠檬茶", "冰摇红梅黑加仑", "金萱乌龙茶", "伯爵红茶", "英式红茶", "甜冰茶"], 
    "大小": ["大杯", "中杯", "小杯", "特大杯"], 
    "咖啡甜度": ["少糖", "去糖"], 
    "冰度": ["热", "去冰", "冰", "少冰", "多冰", "温"], 
    "甜度": ["全糖", "七分甜", "三分甜", "半糖", "无糖"], 
    "奶茶种类": ["红茶拿铁", "绿茶拿铁", "奶茶三兄弟", "青稞奶茶", "鲜芋茶拿铁", "大红袍珍珠茶拿铁", "芒果欧蕾", "焦糖奶茶", "鲜芋奶茶", "法式奶霜大红袍", "法式奶霜绿茶", "抹茶拿铁", "四季奶青", "咖啡冻奶茶", "鲜芋牛奶", "黑糖奶绿", "茉莉奶绿", "四季奶茶", "奶茶", "奶绿", "乌龙奶茶", "抹茶奶绿", "可可奶茶", "布丁奶茶", "红豆奶茶", "珍珠奶茶", "波霸奶茶", "布丁奶绿", "珍珠奶绿", "波霸奶绿", "红豆奶绿"], 
    "奶茶配料": ["加珍珠", "加波霸", "加椰果", "加红豆", "加布丁", "加奶霜", "无配料"], 
    "奶": ["鲜芋青稞牛奶", "青稞红豆牛奶", "青稞可可牛奶", "双拼可可牛奶", "珍珠可可牛奶", "布丁可可牛奶", "鲜芋牛奶", "经典巧克力"], 
    "甜点菜单": ["荔枝玫瑰风味蛋糕", "风车流心金沙酥", "栗香蓝莓蛋糕", "草莓甜心蛋糕", "金玉满满奶香酥", "风华正茂千层酥", "抹茶黑芝麻蛋糕", "芝士咸蛋黄蛋糕", "大大大巧克力脆酥圈", "蜂蜜提子司康", "培根可颂堡", "慢炖牛肉鲜蔬握不住大卷", "葡式咖喱鸡肉握不住", "经典凯撒鸡肉握不住", "亚洲风味鸡排锦绣面沙拉", "大蘑菇头型奇亚籽坚果麦芬", "培根鸡肉俱乐部大嘴三明治", "芝香薄切火腿片大嘴三明治", "牛排蘑菇三明治", "海盐香草风味鸡肉恰巴特", "法式薄切火腿芝士恰巴特", "坚果派对风味酸奶慕斯蛋糕", "法式秘制烤鸭腿配番茄意面沙拉轻星食", "烟熏鸡胸肉配白汁管面沙拉轻星食", "大蘑菇头形清新蓝莓麦芬", "大蘑菇头形香浓巧克力麦芬", "纽约浓郁重芝士蛋糕", "浓醇三重黑巧克力蛋糕", "提拉米苏蛋糕"], 
    "奶茶菜单": [
        "咖啡：{%咖啡}\n大小：{%大小}\n热度：{%冰度}\n甜度：{%咖啡甜度}", 
        "奶茶：{%奶茶种类}\n配料：{%奶茶配料}\n大小：{%大小}\n热度：{%冰度}\n甜度：{%甜度}", 
        "牛奶：{%奶}\n大小：{%大小}\n热度：{%冰度}\n甜度：{%甜度}", 
        "饮品：{%想不到啥分类}\n大小：{%大小}\n热度：{%冰度}"
    ], 
    "奶茶生成": [
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}\n恭喜你成为云喝奶茶幸运用户，额外获得一份\n{%奶茶菜单}", 
        "你走进一家奶茶店，点了一份：\n{%奶茶菜单}，\n以及{%甜点菜单}"
    ], 
    "奶茶":["{奶茶生成}"]
}

你可以看到这个牌堆有两个看似相同实则略有差别的格式：

{
	"大小": ["大杯", "中杯", "小杯", "特大杯"]
}

{
    "奶茶生成": [
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}\n恭喜你成为云喝奶茶幸运用户，额外获得一份\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}，\n以及{%甜点菜单}"
    ],
}

它们的区别在于，中括号 [] 的内容是否分行。前者未分行，而后者每行仅有一个。

我们建议使用后者的格式，这与它是 json 文档的标准格式无关，更多的是因为容易检查和阅读。

Hikari Sakurai

2.0.2 是不是放回抽取？

你可能会发现，在使用 draw 命令的时候，有的牌堆是放回抽取，有的是不放回抽取。那么如何控制是否放回？

如果你观察过很多牌堆，会发现在引用牌堆时有两种情况，以 奶茶.json 已有的词条为例，为节省空间仅仅给出部分：

{
	"奶茶生成":[
	"你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
    "你走进一家奶茶店，点了一份：\n{奶茶菜单}", 
	]
}

可以看到，有两种引用方式：{%奶茶菜单} 和 {奶茶菜单} ，唯一的区别在于有没有 % 作为起始。在牌堆文件中，含有 % 将采取放回抽取，否则为不放回抽取。

Hikari Sakurai

2.0.3 权重不同怎么办？（版本限定）

在 2.4.0beta3(563) 之前，本节部分内容不可用。

在理论上，不放回抽取并且设定不同权重的牌堆是可以实现模拟氪金抽卡游戏的。这一点很容易实现。仍然以 奶茶.json 为例：

{
    "奶茶生成": [
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}\n恭喜你成为云喝奶茶幸运用户，额外获得一份\n{%奶茶菜单}", 
         "你走进一家奶茶店，点了一份：\n{%奶茶菜单}，\n以及{%甜点菜单}"
    ],
}

可以看到， "你走进一家奶茶店，点了一份：\n{%奶茶菜单}" 重复了很多次，在当前版本的牌堆文件中，只需多次重复内容即可设定权重。重复次数越多权重越大。

如果你使用了 2.4.0beta3(563) 及之后的版本，你可以使用更简单的方法设定不同牌数。

牌堆权重使用方法: 条目前增加 ::权重::, 即 ::牌数::牌堆内容
牌数必须为正整数，且小于999999

牌数则相当于牌堆中有牌数个此项目

示例:

{
    "抽卡": [
        "::500::1星",
        "::400::2星",
        "::80::3星",
        "::15::4星",
        "::5::5星"
    ]
}

以上牌堆则有 50% 抽到 1 星，40% 2 星，8% 3 星，1.5% 4 星，0.5% 5 星

关于牌数的一个有趣的实现，请参见仑质的有多长 - 有关牌堆概率实现的试验性牌堆

Hikari Sakurai

2.0.4 我想生成随机数字怎么办？

一些牌堆中可能需要生成随机数，如随机生成一个 COC 7th 规则的 NPC 的属性和其他内容。尽管直接使用 .coc7 以及其他对应条目是可取的，但是仍然不方便。

在牌堆文件中，像 .r 指令一样生成一个随机数是很方便的。你只需要在需要生成的位置添加一个 [] ，在其中类似输入 .r 的参数一样输入即可。

例如：

{
    "人偶作成": [
        "【享年】：[1d10+7]\n【暗示】：{人偶暗示}\n【宝物】：{人偶宝物}\n【职位】：{人偶职位}\n{职阶分项}\n【记忆碎片】：\n{人偶记忆碎片}\n{人偶记忆碎片}"
    ],
}

人偶享年之后的 [1d10+7] 即等同于 .r1d10+7

Hikari Sakurai

2.0.5 可以发送图片吗？（CoolQ Pro 版本限定）

答案是可以的，但是有前提条件，你的 CoolQ 版本必须为 Pro 版本，也就是需要前往官网进行氪金。

该功能的实现依赖于 CQ 码，具体的定义我们不做赘述，想要进行更深入了解可以前往官网查看，在此我们只介绍需要用到的知识。

在 CoolQ 中，图片的 CQ 码的格式类似于 [CQ:image,file=/Shadowscapes/Ace_of_Cups.jpg] .

CQ:image 表明本处加载了图片文件
file=/Shadowscapes/Ace_of_Cups.jpg 指出了文件位置，本处说明文件位置位于 CoolQ 根目录/data/image/Shasowscapes 文件夹，文件名为 Ace_of_Cups.jpg

由于大部分 Dice! 插件使用了 CoolQ Air 版本，因此本处不赘述图片牌堆的问题，仅仅给出一段示例：

{
    "花影塔罗": [
        "[CQ:image,file=/Shadowscapes/Ace_of_Cups.jpg]\nAce of Cups  圣杯首牌\n爱意初临、万物和谐的音律、只觉得刺痛、未来的悲伤、情怀和智慧之光、情感的律动",
        "[CQ:image,file=/Shadowscapes/Ace_of_Pentacles.jpg]\nAce of Pentacles  星币首牌\n实现财富、保障生活的机会、辛勤工作带来的繁荣、健康和富贵、走出迷幻和梦境、进入现实的世界",
        "[CQ:image,file=/Shadowscapes/Ace_of_Swords.jpg]\nAce of Swords  宝剑首牌\n绝对的正义、斩断阻碍真理的荆棘、智慧和公正、傲慢和狂躁"
        "[CQ:image,file=/Shadowscapes/Ace_of_Wands.jpg]\nAce of Wands  权杖首牌\n创造力带来的无限可能、兴奋、激动、探险、带着勇气和信心开始冒险"
    ]
}

Hikari Sakurai

2.1 引例

想要实现更多的功能自然需要更为复杂的牌堆文件，以 .draw 韵律源点 为例，在 Tencent QQ 中得到的返回结果如下：

AzusaFracture 9:55:46 PM
	@Hikari(Fracture) .draw 韵律源点

Hikari(Fracture) 9:55:47 PM
    这位摘星人,你随机到的曲目是
    [图片]
    Memory Forest
    Binary Enfold曲目
    曲师：ETIA.
    曲目：Memory Forest [FTR]
    难度：9
    Note数：978
    谱师：Kurorak
    Memory FarLost.jpg
    速度：2速

这个牌堆的工作量相对来说并不小，为防止占用过多篇幅，这里给出牌堆内容截图：

如此巨大的工程手动录入显然是不现实的，首先 json 文件的各种标点要求就已经使犯错概率极大提高了，那么我们有什么简化方案呢？

Hikari Sakurai

2.2 用YAML格式编写牌堆（以 Visual Studio Code 为例）

我们介绍一种代码格式，即 YAML 格式，它的示例如下：

目标1:
  - 参数1
  - 参数2
  - 参数n

其对应的 json 牌堆的内容如下：

{
	"目标1": [
		"参数1",
		"参数2",
		"参数n"
	]
}

可以看到 YAML 格式相对于 json 格式明显更适合阅读，但是，当前版本的 Dice! 并无法直接读取 YAML 牌堆（如果你自行魔改了请无视，不过你既然能魔改源码还需要看这份文档吗）

该问题的解决方案很简单，在 Visual Studio Code 中有一个第三方的加载项 json2yaml ，利用该加载项即可快速实现 json 文件和 yaml 文件的格式转换。

下面介绍 Visual Studio Code 中 json2yaml 加载项的安装方法，如你对 Visual Studio Code十分了解，可以略去这一部分。

`json2yaml` 加载项的安装

在软件界面最左侧找到加载项，输入 json2yaml ，点击对应的插件右下方的 install 按钮进行安装。

安装结束后，你可以打开任意一个 json 文件。并使用键盘上的 F1 键打开操作，如没有问题，你应当看到这个工具的菜单（可能同时提供了其他的工具的菜单）。如果没有看到，尝试在此处输入 json 或 yaml ，成功安装后会出现这两个菜单。

利用如上操作，你可以快速进行 json 和 yaml 的文件转换，该转换方案不受文件的拓展名（即后缀）决定，仅仅取决于你是否使用了正确的代码格式。

`YAML` 格式说明

YAML 格式文件的后缀名为 .yml ，示例格式如下：

韵律源点:
    - |-
        这位摘星人,你随机到的曲目是
        {韵律源点改后数据}
        速度：{速度}
速度:
    - 1速
    - 1速
    - 2速
    - 2速
    - 2速
韵律源点改后数据:
    - "{PST}"
    - "{PRS}"
    - "{PRS}"
    - "{PRS}"
PST:
    - |-
        [CQ:image,file=/Arcaea/auxesia.jpg]
        Auxesia
        Memory Archive曲目
        曲师：ginkiha
        曲目：Auxesia [PST]
        难度：3
        Note数：385
        封面的光酱好可爱。
    - |-
        [CQ:image,file=/Arcaea/crosssoul.jpg]
        CROSS✝︎SOUL
        Memory Archive曲目
        曲师：HyuN
        曲目：CROSS✝︎SOUL [PST]
        难度：4
        Note数：606
        魔能蛇曲

在 yaml 格式中，

缩进被视为格式的一部分（这一点在 json 格式中不做要求），为 4 个半角空格或一个 TAB 键；
多行内容前用 |- 声明多行，并直接换行后在内容前空 8 个空格或两个 TAB 键；
不得在 - 后直接以 [] 开头；

以及一些不做强制的格式，如引用其他词条时单独的花括号 {} 不必须以半角双引号 "" 包裹。如你的代码格式存在问题，可以在底部看到错误提示。

简化的 `YAML` 处理方案

尽管 YAML 格式已经对于 JSON 格式进行了大幅度的简化，但对于编程基础稍弱的作者来说仍然容易出错。在此做出如下建议：

如软件不报错，则不需在直接单独引用其他词条而无其他内容时以 "" 包裹内容：即
```
   韵律源点改后数据:
       - {PST}
```
而非
```
   韵律源点改后数据:
       - "{PST}"
```
在处理换行时，仍然采用 JSON 文件的 \n 进行描述：
```
   PST:
       - \n[CQ:image,file=/Arcaea/auxesia.jpg]\nAuxesia\nMemory Archive曲目\n曲师：ginkiha\n曲目：Auxesia [PST]\n难度：3\nNote数：385\n封面的光酱好可爱。
```
但是这样处理后，使用 json2yaml 插件转换为 JSON 格式会将全部的 \n 转换为 \\n ，因此还需要使用“替换”功能将全部的 \\n 替换为原本的 \n

在 Visual Studio Code 中，替换功能的快捷键为 Ctrl+H

通过如上操作，你可以使用更为简洁的 YAML 格式编写牌堆并转换为可用的 JSON 牌堆。

Hikari Sakurai

2.3 用 Excel 编写牌堆

在一些牌堆中，存在大量的相同格式，如上述名为 PST 的词条，其内容完全为如下格式：

曲绘  [CQ:image,file=/Arcaea/crosssoul.jpg]
曲名  CROSS✝︎SOUL
曲包  Memory Archive曲目
曲师  曲师：HyuN
曲目  曲目：CROSS✝︎SOUL [PST]
难度  难度：4
物量  Note数：606
描述  魔能蛇曲

在这种情况下，笔者建议使用 Excel 进行编写。

以 花影塔罗 的牌堆为例，原始数据经过整理变成了如下的 Excel 表格（为节省篇幅仅仅给出部分内容）

我们只需将单元格内的文字连接成我们希望在 JSON 文件中所写的内容，这一点利用 Excel 的函数十分容易实现：

Excel 连接两个单元格内容或单元格与一段文字的连接

在 Excel 中，可以使用 & 进行两个单元格内容的连接，如连接上图中 A1 和 B1 单元格并在 D1 单元格中输出结果，只需在 D1 单元格中输入：

=A1&B1

所得结果为：

Ace of Cups圣杯首牌

但是我们想要在中英文之间添加一个破折号，尽管可以通过在一个新的单元格中输入并按照上述方法连接，但如果需要添加多次，那创建太多列也不是好的选择。而 Excel 中，连接纯文本并非难事。为了使实现上述操作，我们可以改变一下公式：

=A1&"——"&B1

可以看到我们使用了 "——" 来添加了一个破折号。在 Excel 中，连接纯文本只需要使用 &"" 进行连接。

仍然需要注意的是，这里面的双引号也为半角字符，请注意切换你的输入法状态。

连接的字符有双引号怎么办？

由于 "" 被作为了函数的一部分，直接使用 """ 会导致 Excel 无法识别，因此我们需要对其进行转义， Excel 公式中用两个引号代表一个引号，如：

="abc""abc"

会得到 abc"abc

=""""&"abc"&""""

会得到字符串"abc"

如对示例表格中的数据进行连接得到如下 JSON 牌堆：

{
    "花影塔罗（部分）": [
        "Ace of Cups  圣杯首牌\n爱意初临、万物和谐的音律、只觉得刺痛、未来的悲伤、情怀和智慧之光、情感的律动",
        "Ace of Pentacles  星币首牌\n实现财富、保障生活的机会、辛勤工作带来的繁荣、健康和富贵、走出迷幻和梦境、进入现实的世界",
        "Ace of Swords  宝剑首牌\n绝对的正义、斩断阻碍真理的荆棘、智慧和公正、傲慢和狂躁",
        "Ace of Wands  权杖首牌\n创造力带来的无限可能、兴奋、激动、探险、带着勇气和信心开始冒险"
    ]
}

以第一行为例，我们需要在 Excel 中输入如下内容以转换为 json 格式

=""""&A1&"  "&B1&"\n"&C1&""","

再使用填充柄进行填充即可得到 JSON 格式的输出。请注意，这种方法需要注意删除最后一行的 , ，否则牌堆将会报错。

Hikari Sakurai

结语

当你看到这里，恭喜你，你已经是一个编写 JSON 牌堆的专业人士了，尽情为你的骰娘编写属于自己的牌堆吧！

本教程或许还有一些纰漏和未尽事宜，但如果你认真看完了，你大可以推测出我们没有想到并写在这份文档里面的内容。

感谢看到这里的你，也感谢所有为这份文档提供帮助的人w

白渡子

\雨笙/

twfx1207

最近在看json牌堆，有个问题想问一下。
如果我做了很多引用用的子牌堆（比如文中奶茶.json中的大小、甜度之类的），那么我的.help draw会变得非常冗长，而且用户可以绕过主牌堆直接抽子牌堆，有没有什么办法能让dice只显示主牌堆吗？
另外，我之前在master手册里看到

牌堆名以 “_” 开头时，无法直接使用 draw 命令抽取。

但是我实际试了一下，在牌堆名前加上"_ “后（”_甜度"）还是会被显示在.help draw中并可以被直接抽取，是使用方法有问题还是这个功能本身不可用了呢？

Hikari Sakurai

twfx1207
关于概率实现问题：如果想要尽可能缩减牌堆体积并且保留概率实现，请尽快使用 563 及以上版本，其中添加了单独的概率实现方法。
关于不可见牌堆问题：请确认你的版本（当然同样建议升级）

twfx1207

Hikari Sakurai 我现在的版本是2.3.8Express10(556)，由于563有一些文字编码问题就一直没升级。想问下不可见牌堆的正确写法是怎样的呢