> ## 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.

# 欢迎器

> 用消息、生成的图片或两者一起欢迎新成员——加上告别消息和临时问候。

一个页面上三种模式：**欢迎**、**告别** 和 **问候**。

<Note>
  三者共享 **一个保存栏**。在它们之间切换不会丢失编辑——保存时一切一起提交。
</Note>

## 欢迎和告别

各有三个标签页。

### 设置

频道、消息是否开启、图片是否开启，以及文字相对于图片的位置——之前、之后或在其上。

### 消息

三种格式：

| 格式              | 等级        |
| --------------- | --------- |
| **消息** ——纯文本    | 免费        |
| **嵌入消息**        | **Basic** |
| **高级消息** ——组件布局 | **Basic** |

<Note>
  在 Starter 上，点击嵌入或高级会打开升级对话框而不是切换标签页。什么都没有被隐藏。
</Note>

欢迎消息的变量：

| 变量             | 插入       |
| -------------- | -------- |
| `[User]`       | 成员       |
| `[ServerName]` | 你服务器的名称  |
| `[Inviter]`    | 邀请他们的人   |
| `[Code]`       | 所用邀请代码   |
| `[UsersCount]` | 新的成员数    |
| `[CountUrl]`   | 计数图片 URL |

告别消息支持 `[User]`、`[ServerName]` 和 `[UsersCount]`。

<Warning>
  **默认欢迎消息包含 `[Server]`，这不是真实变量**，会在你的欢迎消息中字面显示。请将其替换为 `[ServerName]`。
</Warning>

<Warning>
  **除非在你保存时消息类型设为嵌入，否则嵌入编辑会被丢弃。** 若你构建嵌入然后在保存前切换回消息标签页，之前的嵌入会被写回覆盖你的工作。

  在编辑时请让消息类型保持为嵌入，然后保存。
</Warning>

### 图片

一个画布编辑器。设置背景、定位成员头像、其名字和一行文字。

* 背景：上传的图片，或透明
* 上传最大 **3 MB**，PNG、JPG 或 GIF
* 头像：圆形或方形，带大小和位置
* 名字和文字：字体大小、颜色、对齐、大小和位置

<Note>
  长用户名在图片上被缩短，以免溢出画布。
</Note>

<Tip>
  上传背景后使用 **适配舞台**，让画布匹配图片，而不是将图片拉伸到错误形状的画布。
</Tip>

## 问候

有人加入时发布的简短提及，它会自我删除。

* **自动删除** ——从不，或在 3、5、10、15、30 或 60 秒后
* **问候频道** ——一个频道加最多 500 字符的消息，每频道一行

<Info>
  问候频道：Starter **5**，Basic **15**，Max 无限。
</Info>

<Warning>
  **在 Black 等级上，页面显示"无限"问候频道但保存超过 5 会被拒。** 这是限制表中的已知缺陷。在修正之前，请将 Black 服务器保持在 5 个问候频道。
</Warning>

<Tip>
  问候用于在最忙的聊天频道中快速发一句 "welcome @member 👋"，那里完整的欢迎卡片会显得侵扰。请将其与专门频道中的合适欢迎消息一起使用，而不是替代它。
</Tip>

## 故障排查

<AccordionGroup>
  <Accordion title="有人加入时什么都没发布">
    请检查欢迎器模块在 [服务器设置](/zh-CN/server-management/setup) 中已开启、已设置频道、消息开关已开启，且 Vetox 可以在该频道发送消息和附加文件。
  </Accordion>

  <Accordion title="消息发布但图片没有">
    Vetox 需要 **附加文件** 权限。还请检查设置标签页上的图片开关。
  </Accordion>

  <Accordion title="`[Server]` 在我的欢迎消息中字面出现">
    它不是变量。请改为 `[ServerName]`。
  </Accordion>

  <Accordion title="我的嵌入不断回退">
    请将消息类型设为嵌入，并在保存时保持它。
  </Accordion>

  <Accordion title="保存 Black 等级的问候设置失败并显示高级版错误">
    问候频道上限对 Black 等级读取错误。请减少到 5 个频道。
  </Accordion>

  <Accordion title="`[Inviter]` 为空">
    Vetox 需要 **管理服务器** 权限来读取邀请并弄清谁邀请了谁。
  </Accordion>
</AccordionGroup>

<Card title="自动角色" icon="user-plus" horizontal href="/zh-CN/engagement/auto-roles">
  在欢迎之外也在加入时授予角色。
</Card>