> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 自选角色

> 让成员通过反应、下拉或按钮面板给自己授予角色，提供五种分配模式。所有等级免费。

成员从你设计的面板中挑选自己的角色——代词、通知偏好、游戏兴趣。

<Info>
  **在每个等级都免费**，无数量限制。
</Info>

## 你需要先有一条嵌入消息

<Warning>
  自选角色附着于 **已经发送到频道** 的现有 [嵌入消息](/zh-CN/utility/embed-messages)。它不自己创建消息。

  若你没有嵌入，创建页面会告知并链接到构建流程。若你有嵌入但没有一条被 **发送**，消息选择器即使存在嵌入也会为空——请先发送一条。
</Warning>

## 面板类型

<CardGroup cols={3}>
  <Card title="表情" icon="face-smile">
    成员用反应。最多 **20** 个角色。
  </Card>

  <Card title="按钮" icon="square">
    四种颜色的可点击按钮。最多 **25** 个角色。
  </Card>

  <Card title="下拉" icon="list">
    带占位符的选择菜单。最多 **25** 个角色。
  </Card>
</CardGroup>

## 行为

对于表情和按钮面板，你需要选择一个主要行为：

| 模式      | 效果            |
| ------- | ------------- |
| **切换**  | 选择授予角色，再次选择移除 |
| **仅授予** | 只添加——成员不能自己移除 |
| **仅移除** | 只移除           |

然后可选地，从两种互斥模式中选一：

| 模式       | 效果                     |
| -------- | ---------------------- |
| **自动替换** | 取一个角色会移除面板上其他所有角色      |
| **严格单选** | 若成员已持有面板上的另一个角色，则拒绝该选择 |

<Warning>
  **自动替换和严格单选替换而不是添加到你的主要选择。** 选择其中之一会丢弃切换/仅授予/仅移除设置。

  之后你重新打开面板时，无论你最初选择的是什么，主要模式都会显示为 **切换**。这是显示问题——实际存储和应用的是互斥模式。
</Warning>

<Note>
  下拉面板没有行为选择器。它们始终切换，始终单选。
</Note>

<Tip>
  **自动替换** 适合互斥的选项，如地区或技能等级——成员可以改变主意并始终最终只拥有一个。
</Tip>

## 通知

成员获得或失去角色时可以收到私信，每种可分别配置消息。用 `[Role]` 插入角色名称。

## 列表表格显示什么

<Warning>
  面板列表上有三列不可靠：

  * **行为** 始终读作 "Standard"，无论你设置的模式如何
  * **创建** 始终为每个面板显示今天的日期
  * **类型** 显示未翻译的英文单词

  只有 **名称** 和 **反应** 列可信。请打开面板查看其真实设置。
</Warning>

## 无法到达的设置

两个已存储的选项没有仪表板控件，保持其默认值：

* **每角色成员上限** ——每个角色可持有人数的底层限制始终为无限
* **多选下拉** ——下拉面板始终为单选

<Note>
  面板的名称取自其附着的嵌入消息。重命名嵌入会在你下次保存面板时重命名面板。
</Note>

## 更改面板

<Warning>
  切换面板类型会重建其 Discord 消息——旧反应或按钮在新的出现之前被移除。成员会短暂看到一个没有控件的面板。

  若底层的 Discord 消息已被删除，更新会静悄悄地失败，面板仍列出。请删除它并针对新消息重建。
</Warning>

<Warning>
  面板上每个角色都必须位于 Vetox 角色 **之下**，否则无法分配。参见 [权限](/zh-CN/permissions)。
</Warning>

<Card title="自动角色" icon="user-plus" horizontal href="/zh-CN/engagement/auto-roles">
  自动授予而非自选的角色。
</Card>
