使用《署名—非商业性使用—相同方式共享 4.0 协议国际版》（CC BY-NC-SA 4.0）进行授权 https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.zh-Hans 本文基础篇参考了星空的原版指南，参考内容已获授权。本文进阶篇参考了雨笙的同名指南，参考内容遵守 CC BY-NC-SA 4.0 。本文件基于 OlivaDice青果骰系列骰娘编写，希望可以给你的牌堆编写带来帮助。在开始之前，请确认以下内容：请确认使用插件是否为仑质开发的 OlivaDice青果骰，方法为输入 .bot 后返回语句包含 OlivaDice By lunzhiPenxil ，并请记住你的具体版本号（如 3.2.14(1044) ）请确认你有足够的耐心看完本文档，并且在操作时对自己有足够的包容心。如果你是第一次编写牌堆，出现任何问题都是很正常的，请勿仓促放弃。如果你已经做好了这些准备，你可以开始学习如何编写属于你的第一个牌堆了~

目录一、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 编写牌堆三、结语

一、JSON牌堆编写：入门篇这一部分我们将会介绍 JSON 牌堆的一些基础知识，并尽量采用通俗易懂的语言说明。如果你认真阅读了这一部分，你应当可以编写一个简单的牌堆了。 1.0 编写建议尽管使用 Windows 默认的记事本完全可以达到编写牌堆的条件，但是还是建议使用 Notepad++、Visual Studio Code 等软件编写。如您使用其他的 IDE ，也可以保持您原有的习惯。尽管询问群友或网友是一个解决问题的方案，但是笔者仍然建议在此之前先查看已有的正确的牌堆文件进行研究——在这个方面，自行“踩雷”后编写牌堆有助于你编写其他的牌堆。一个命名方面的警告：由于历史原因（其他更为古老的骰系的设计），如果有两个相同的抽取关键词则有可能导致调用错误。因此，尽量不要使用常用命名如时间，天气，性别等。

1.1 牌堆文件组成首先我们打开一个牌堆文件 { "点心": ["橙子", "荔枝", "巧克力", "樱桃", "青苹果", "山楂", "牛奶", "葡萄酒", "啤酒", "白巧克力", "圣代", "奶茶", "红茶","马卡龙","布丁", "咖啡", ,"可乐", "鱼子酱", "蘑菇浓汤", "罗宋汤", "调制酒"], "食物": ["汉堡", "面条", "肉泥", "牛排", . "猪排", "羊排", "奶酪", "披萨", "面包", "香肠", "方便面", "热狗", "火腿", "三明治", "蛋挞", ."空心粉", "沙拉", "烤鱼", "土豆饼"], "今天吃什么": ["\n您今天的伙食如下一\n早餐: [{%食物}] 和[{%点心}] \n午餐: [{%食物}] , [{%食物}] 搭配[{%点心}] \n晚餐: [{%食物}] 搭配[{%点心}] "] } 可以看到牌堆组成并不复杂，整个文本被 { } 花括号包裹，（以第二行为例子）由类别 "点心" 参数 [“橙子”,……,”调制酒”] 组成，另外还包含（第四行为例） {%食物} 引用， \n 换行符组成。

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}"] 是不是很简单？现在让我们加入写牌堆队伍中吧~

二、JSON牌堆编写：进阶篇很高兴你已经是一位牌堆的作者了，也很高兴你有兴趣继续学习牌堆的更多写法。后面介绍的内容对你可能会有一些挑战，但是没关系，慢慢读下去。相信看完这部分，你会发现更多有趣的编写思路。

2.0 JSON和牌堆的一些理论基础这一节的目的是告诉你更多的你可以在牌堆中实现的内容。请注意，这一节有的内容可能不适用于某些版本，请在尝试本节内容之前确认版本！

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 文档的标准格式无关，更多的是因为容易检查和阅读。

2.0.2 是不是放回抽取？你可能会发现，在使用 draw 命令的时候，有的牌堆是放回抽取，有的是不放回抽取。那么如何控制是否放回？如果你观察过很多牌堆，会发现在引用牌堆时有两种情况，以奶茶.json 已有的词条为例，为节省空间仅仅给出部分： { "奶茶生成":[ "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{奶茶菜单}", ] } 可以看到，有两种引用方式： {%奶茶菜单} 和 {奶茶菜单} ，唯一的区别在于有没有 % 作为起始。在牌堆文件中，含有 % 将采取放回抽取，否则为不放回抽取。

2.0.3 权重不同怎么办？在理论上，不放回抽取并且设定不同权重的牌堆是可以实现模拟氪金抽卡游戏的。这一点很容易实现。仍然以奶茶.json 为例： { "奶茶生成": [ "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}\n恭喜你成为云喝奶茶幸运用户，额外获得一份\n{%奶茶菜单}", "你走进一家奶茶店，点了一份：\n{%奶茶菜单}，\n以及{%甜点菜单}" ], } 可以看到， "你走进一家奶茶店，点了一份：\n{%奶茶菜单}" 重复了很多次，在当前版本的牌堆文件中，只需多次重复内容即可设定权重。重复次数越多权重越大。现在，你可以使用更简单的方法设定不同牌数。牌堆权重使用方法: 条目前增加 ::权重:: , 即 ::牌数::牌堆内容牌数必须为正整数，且小于999999 牌数则相当于牌堆中有牌数个此项目示例: { "抽卡": [ "::500::1星", "::400::2星", "::80::3星", "::15::4星", "::5::5星" ] } 以上牌堆则有 50% 抽到 1 星，40% 2 星，8% 3 星，1.5% 4 星，0.5% 5 星

2.0.5 可以发送图片吗？该功能的实现依赖于 CQ 码，具体的定义我们不做赘述，在此我们只介绍需要用到的知识。在 CoolQ 中，图片的 CQ 码的格式类似于 [CQ:image,file=/Shadowscapes/Ace_of_Cups.jpg] . 在 OlivOS 中，图片的 CQ 码的格式还支持 [CQ:image,file=url] . 即文件路径为图片链接 CQ:image 表明本处加载了图片文件 file=/Shadowscapes/Ace_of_Cups.jpg 指出了文件位置，本处说明文件位置位于 CoolQ 根目录/data/image/Shasowscapes 文件夹，文件名为 Ace_of_Cups.jpg { "花影塔罗": [ "[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创造力带来的无限可能、兴奋、激动、探险、带着勇气和信心开始冒险" ] }

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

dzwn

realllllChi 是不是打成中文}了

buguilu

realllllChi 确认一下是不是中文的{}，得用英文的

« 上一页