自定义文案
自定义文案允许你对骰子返回的结果文案进行修改。目前我们支持对绝大多数的骰子结果文案进行自定义。也支持使用插件进行更细粒度的控制。
自定义文案配置包含如下功能要素：
文案内容
自定义文案的编辑和自定义回复功能非常类似。在文本框中输入想要回复的文本内容。支持换行，可以通过输入框右下角拖动改变高度。
文案内容支持多条随机，可以为每一条内容设置不同的权重，根据权重随机一条内容返回。
变量
文本中可以通过 {{xxx}} 语法插入变量。进阶地说，插入变量的格式遵循 mustache 语法。
不同的文案中支持的变量不同。每条文案可使用的变量已在输入框下方列出。先把光标放在输入框中你想插入变量的位置，再点击变量按钮，就可以快捷插入这个变量。
举例说明一些常用的变量：
例如用户 Maca，关联了一张人物卡，名字为【铃木翼】，他的【侦查】技能为 60。此时他进行了一次侦查检定，结果如下：
.r侦察
Maca 🎲 侦察 d%: [84] = 84 / 60 失败
此时，和这次检定相关的变量如下：
| 变量名 | 变量值 | 备注 |
|---|---|---|
| 用户名 | Maca | 用户在平台的昵称 |
| 人物卡名 | 铃木翼 | 用户当前关联的人物卡名（除 nn 指令外，如果用户未关联人物卡，则取用户名） |
| at用户 | @Maca | |
| 目标值 | 60 | 成功/失败的临界线 |
| 原始指令 | r侦察 | 用户输入的原始指令 |
| 描述 | 侦察 | 从原始指令中解析出的骰子描述 |
| 掷骰结果 | 84 | |
| 掷骰表达式 | d% | |
| 掷骰输出 | d%: [84] = 84 | |
| coc | true | 本次掷骰是否遵循 coc 规则 |
| 普通检定 | true | 本次掷骰是否存在检定结果（不包括 sc、en 等特殊指令） |
| 普通掷骰 | false | 是否只是一次普通掷骰（不存在检定结果） |
示例：使用人物卡名替换用户昵称
掷骰结果默认回显用户的昵称，这是因为【掷骰-起始】的文案模板默认是 {{用户名}} 🎲 {{描述}}。 假如我们希望默认回显用户的人物卡名，只需将这句文案修改为 {{人物卡名}} 🎲 {{描述}} 就可以了。
变量类型
变量分为两种不同类型，以不同的颜色区分。这两种变量的语法使用起来也稍有不同。
在上节中的例子，都是文本类型的变量，在渲染时会直接使用变量值替换 {{变量名}} 的位置。
还有时候，我们需要根据条件判断，此时就需要布尔类型的变量（即 true 或 false）。使用 {{#变量名}}xxx{{/变量名}} 表示符合这一条件时展示的内容；使用 {{^变量名}}xxx{{/变量名}} 表示不符合这一条件时展示的内容。
示例：对理智检定特殊处理
【检定-成功】的文案模板默认是 / {{目标值}} 成功。假如我们希望对于理智检定成功时，展示不同的文案，就可以修改为 / {{目标值}} {{#sc}}理智检定成功{{/sc}}{{^sc}}成功{{/sc}}。
.侦查
Maca 🎲 侦查 d%: [58] = 58 / 60 成功
.sc 0/1
Maca 🎲 d% = 10 / 26 理智检定成功
示例：使用 $end$ 提前结束
当文案中遇到 $end$ 时，文案会在此处截断，无视后面的内容。这有助于简化复杂条件判断的书写。
所有文案词条
通用文案
| 名称 | key | 默认模板 |
|---|---|---|
| 掷骰-起始 | roll.start | {{用户名}} 🎲 {{描述}} |
| 中间骰-起始步骤 | roll.inline.first | 先是 🎲 |
| 中间骰-中间步骤 | roll.inline.middle | 然后 🎲 |
| 中间骰-最终步骤 | roll.inline.last | 最后 🎲 |
| 掷骰输出（完整） | roll.result | {{掷骰输出}} |
| 掷骰输出（简略） | roll.result.quiet | {{掷骰表达式}} = {{掷骰结果}} |
| 暗骰 | roll.hidden | {{用户名}} 在帷幕后面偷偷地 🎲 {{描述}}，猜猜结果是什么 |
| 检定-大失败 | test.worst | 大失败 |
| 检定-大成功 | test.best | 大成功 |
| 检定-失败 | test.fail | / {{目标值}} 失败 |
| 检定-成功（极难） | test.exsuccess | / {{目标值}} 成功 |
| 检定-成功（困难） | test.hardsuccess | / {{目标值}} 成功 |
| 检定-成功 | test.success | / {{目标值}} 成功 |
| 对抗检定标记 | roll.vs.prompt | > 回复本条消息以进行对抗 |
| 对抗检定 | roll.vs.result | {{#胜}}🟩{{/胜}}{{#负}}🟥{{/负}}{{#平}}🟨{{/平}} {{用户名}} {{描述}}{{#coc}}({{技能值}}) {{成功等级}}{{/coc}}{{#dnd}} {{掷骰结果}}{{/dnd}} ↔️ {{对方用户名}} {{对方描述}}{{#coc}}({{对方技能值}}) {{对方成功等级}}{{/coc}}{{#dnd}} {{对方掷骰结果}}{{/dnd}} {{#对方胜}}🟩{{/对方胜}}{{#对方负}}🟥{{/对方负}}{{#对方平}}🟨{{/对方平}} |
| 人物卡-未关联 | card.empty | {{目标用户}}没有关联人物卡 |
| 人物卡-无操作权限 | card.nopermission | {{用户名}} 没有操作人物卡的权限 |
人物卡操作
| 名称 | key | 默认模板 |
|---|---|---|
| 人物卡-设置提示 | roll.st.prompt | {{at用户}}请指定想要设置的属性名与属性值 |
| 人物卡-展示条目列表 | roll.st.show | {{at用户}}({{人物卡名}}):\n{{#条目列表}}{{条目}}{{^last}} {{/last}}{{/条目列表}} |
| 人物卡-设置条目列表 | roll.st.set | {{at用户}}({{人物卡名}}) 设置:\n{{#条目列表}}{{条目}}{{^last}}\n{{/last}}{{/条目列表}} |
| 人物卡关联-展示已关联人物卡 | nn.show | {{at用户}}当前{{#人物卡名}}已关联人物卡：{{人物卡名}}{{/人物卡名}}{{^人物卡名}}未关联人物卡{{/人物卡名}} |
| 人物卡关联-关联成功 | nn.link | {{at用户}}已关联人物卡：{{人物卡名}} |
| 人物卡关联-取消关联 | nn.clear | {{at用户}}已取消关联人物卡 |
| 人物卡关联-关键词搜索 | nn.search | {{at用户}}请选择想要关联的人物卡：\n{{#人物卡列表}}{{人物卡名}}{{^last}}\n{{/last}}{{/人物卡列表}}\n{{^人物卡列表}}未找到名字包含{{关键词}}的人物卡{{/人物卡列表}} |
先攻
| 名称 | key | 默认模板 |
|---|---|---|
| 先攻-删除人物 | roll.ri.del | {{用户名}} 删除先攻：{{#人物列表}}{{人物名}}{{^last}}、{{/last}}{{/人物列表}} |
| 先攻-清空列表 | roll.ri.clear | *先攻列表已清空 |
COC 理智检定
| 名称 | key | 默认模板 |
|---|---|---|
| 理智检定-不支持 | roll.sc.unsupported | ……未指定理智值，成功了吗？ |
| 理智检定-附加语 | roll.sc.extra | \n{{#掷骰结果}}理智变化：{{旧值}} → {{新值}}{{/掷骰结果}} |
COC 成长检定
| 名称 | key | 默认模板 |
|---|---|---|
| 成长检定-不支持 | roll.en.empty | {{用户名}} 当前暂无可成长的技能或不支持成长 |
| 成长检定-列出技能 | roll.en.list | {{用户名}} 当前可成长的技能：\n{{#技能列表}}{{技能名}}{{^last}}、{{/last}}{{/技能列表}} |
| 成长检定-附加语 | roll.en.extra | \n{{描述}}变化：{{旧值}} → {{新值}} |
| 成长检定-打标记 | roll.en.mark | {{用户名}} 已{{#添加}}添加{{/添加}}{{^添加}}移除{{/添加}}以下技能成长标记：\n{{#技能列表}}{{技能名}}{{^last}}、{{/last}}{{/技能列表}} |
| 成长检定-清除所有标记 | roll.en.markclear | {{用户名}} 已移除所有的技能成长标记 |
DND 死亡豁免
| 名称 | key | 默认模板 |
|---|---|---|
| 死亡豁免-起死回生 | roll.ds.best | 起死回生，HP+1 |
| 死亡豁免-二次失败 | roll.ds.worst | 二次失败 |
| 死亡豁免-伤势稳定 | roll.ds.tostable | \n成功三次，伤势稳定了 |
| 死亡豁免-去世 | roll.ds.todeath | \n失败三次，去世了 |