> For the complete documentation index, see [llms.txt](https://bothelp.hktrpg.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bothelp.hktrpg.com/guide/zh-hans/trpg-gong-neng/kai-shi-jin-hang-trpg/jiao-se-ka.md).
# 角色卡
{% hint style="info" %}
**小知识:** 网页版角色卡功能可以连动聊天软件，在网页上掷骰，结果可以直接出现在软件上。
{% endhint %}
### 1. 添加角色卡
使用的第一步，是需要你拥有聊天软件的帐号，然后对HKTRPG输入以下的添加指令(或按以下格式输入自己的角色卡)\
\&#xNAN;**`.char add name[Sad或你想要的名字]~`**\
\&#xNAN;**`state[HP:15/15;MP:10/10;San:80]~`**\
\&#xNAN;**`roll[斗殴: cc 50;sc:cc {san};]~`**\
\&#xNAN;**`notes[笔记:这是测试,请试试在群组输入 .char use Sad或你想要的名字;]~`**
\
弹出**添加/修改成功**代表你已经添加角色卡
### 2. 编辑角色卡
{% hint style="info" %}
注: 这里的编辑通常是指添加一些固定会出现的数值/字段，\
例如力量，智力，星爆气流斩等角色的能力，属性，\
而不是你被扣了1血，就用这个方式去扣血。
{% endhint %}
添加角色卡后，你可以继续在聊天软件上编辑角色卡内容，\
修改角色卡的格式和添加角色卡一样，\
但比较方便的方法还是以网页的方式，以可视化的方式修改。
### i) 网页上编辑角色卡
**而为了使用网页版角色卡，你需要添加管理用的帐号**
输入 **`.admin account (username) (password)`**
然后进入 [`角色卡管理库`](https://card.hktrpg.com/)
在网页 输入帐号密码， 就可以管理你的角色卡，进行修改。
 
想修改内容，只要直接修改数字然后按右上角的保存角色卡就可以了。
### ii) 聊天软件上编辑角色卡
文本式的编辑角色卡，与添加角色卡一样。
格式\
\&#xNAN;**`.char edit`**\
\&#xNAN;**`name[Sad或你想要的名字]~`**\
\&#xNAN;**`state[HP:15/15;MP:10/10;San:80]~`**\
\&#xNAN;**`roll[斗殴: cc 50;sc:cc {san};]~`**\
\&#xNAN;**`notes[笔记:这是测试,请试试在群组输入 .char use Sad或你想要的名字;]~`**
### **`3. 使用角色卡`**
现在你已经把角色卡准备好，就可以正式使用。
方法很简单，只要你在需要使用角色的频道里输入
`.char use 角色卡名字 就可以了`
` 如上面就输入 .char use`` `` `**`Sad或你想要的名字`**
接着，就可以在该频道使用
把结果发送到已登记的Discord，TG，LINE上的聊天群组的登记方法:
由该群组的Admin授权允许 输入 .admin allowrolling\
登记该群组到自己的名单中 输入 .admin registerChannel\
取消方法 由该群组的Admin取消授权 输入 .admin disallowrolling\
取消登记该群组到名单 输入 .admin unregisterChannel
最后网站会显示群组名称，点击就可以使用了
### 另一种使用方式 - Button 按钮化 - Discord 限定
#### 使用方式
**`.ch button`** 或\
\&#xNAN;**`.char button 角色名字`** 可以产生你的角色卡按钮
两种产生的按钮指令会有所不同，前者调用**`.ch`**後者产生直接掷骰的指令
{% hint style="info" %}
.char button 产生的角色卡不支持 {}功能，所以 {San}无效
因为 {} 是.ch 的技术 读取.ch里注册了的角色卡
{% endhint %}
{% hint style="info" %}
按钮产生后，可以按右键点击Pin，方便自己掷骰时可以找到角色卡位置
{% endhint %}
### 与 `.forward`、`.re` 搭配（Discord）
跑团时常见做法：把按钮放在准备频道，结果转发到公开频道。
1. 产生按钮：`.ch button` 或 `.char button 角色名`（或 GM 用 [`.re`](/guide/zh-hans/trpg-gong-neng/yao-qiu-zhi-tou.md) 要求玩家点击掷骰）
2. 复制该则消息链接
3. 到目标频道输入 [`.forward 消息链接`](/guide/zh-hans/xi-tong-gong-ju/discord-an-niu-zhuan-fa.md)
之后点击按钮，结果会出现在已设置的转发频道。转发上限见 [开发支持（VIP）](https://bothelp.hktrpg.com/guide/zh-hans/trpg-gong-neng/kai-shi-jin-hang-trpg/pages/viC6Rl0qDY63xHhScNU5#vip-权益对照)。
若要对外分享「好看的角色介绍图」而非 Bot 状态卡，可用网页 [TRPG 名片与喜好卡](/guide/zh-hans/trpg-gong-neng/trpg-ming-pian-yu-xi-hao-ka-gong-neng.md) 导出 PNG。
### 功能一覧
#### `.char`
`.char add name[Sad]~ state[HP:15/15;con:60;san:60]~`\
`roll[斗殴: cc 50;投掷: cc 15;sc:cc {san}]~`\
`notes[笔记:这是测试,请试试在群组输入 .char use Sad;]~`
**可以添加及更新角色卡**
`.char Show` - **可以显示角色卡列表**
`.char Show0` - **可以显示0号角色卡内容 0可以用其他数字取代**
`.char edit name[角色卡名字]~` - **可以以add的格式修改指定角色卡**
`.char use 角色卡名字` - **可以在该群组中使用指定角色卡**
`.char nonuse` - **可以在该群组中取消使用角色卡**
`.char delete 角色卡名字` - **可以删除指定角色卡**
`.char button 角色卡名字` - **Discord限定，产生掷骰按钮**
#### `.ch 功能`
在群组中使用.char use (角色名) 后, 就可以启动角色卡功能
`.ch 项目名称 项目名称` - **没有加减的话, 会单纯显示数据或掷骰**
`.ch 项目名称 (数字)` - **可以立即把如HP变成该数字**
`.ch 项目名称 (+-`*`/数字)` - **可以立即对如HP进行四则运算***
*`.ch 项目名称 (+-`*`/xDy)` - **可以对如HP进行掷骰四则运算**
`.ch set 项目名称 新内容` - **直接更改内容**
`.ch show` - **显示角色卡的state 和roll 内容**
`.ch showall` - **显示角色卡的所有内容**
`.ch button` - **Discord限定，产生掷骰按钮**
## 表达式
### state
这是用来保存浮动数据，支持进行运算 如: `.ch HP +3`\
`.ch HP +1d3`
### roll
这是用来保存掷骰指令, 快速使用 如 `.ch 空手斗殴`\
注意项目名称请不要有空格
#### {}符号
这可以用来指定state 的参数, 如`{db}`就会变成 1d3\
可以进行简单运算 如`1+{HP}` 就会变成 `1+15 -> 16`
`<>`符号
这个可以用来进行**基本掷骰**，**高端掷骰**及**COC掷骰**的运算，\
它支持比较长的命令，\
不会显示过程，只会取得运算后的最后一个数字\
<1d3> -> 2\
<.sc san 1/1d5> 的本来显示结果是`现在San值是x点`\
所以结果是x，而不是1或1d5
### notes
这是用来保存数据, 以后可以查看 如 `.ch 笔记`
## 使用范例
`.ch set 护甲 3` - 设置护甲为3\
`.ch hp 10` - 设置 hp 为10\
`.ch HP +3 MP 6 san -10 笔记` - 设置hp增加3点，MP为6，San减少10及显示笔记\
`.ch HP +3d6` - 设置hp增加3d6\
`.ch san -<1d3>` - 设置hp减少1d3\
`.ch san <.sc san 1/1d3>` - 设置san进行san check\
\
`.ch str <3D6dl2>` - 设置str 为 3d6dl2\
`.ch hp *3/2` - 设置hp 乘3除以2\
\
`.ch 斗殴` - 进行斗殴\
`.ch san` - 显示现时San\
`dr .ch 魔法` - 暗骰\
\