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

# 服务器模板

> 现成的服务器布局——频道、身份组和权限——只需一步就能搭建进你的服务器，来源可以是模板目录，也可以是 Discord 模板链接。

服务器模板是现成的服务器布局——频道、分类、身份组和权限，作为一整套来设计——Vetox 只需一步就能把它搭建进你的服务器。在 [vetox.io/templates](https://vetox.io/templates) 浏览模板，或者在 Discord 里用 [`/template`](#template-命令) 直接应用。

<Info>
  **所有套餐均免费**，包括 Starter。应用模板在底层就是一次[服务器备份](/zh-CN/server-management/server-backup)还原，所以它同样会先做一份安全副本，并显示同样的进度卡片——只是它没有任何高级版门槛。
</Info>

<Note>
  **模板目录是英文的。** 一个模板的价值，就在于它写进你服务器里的那些确切频道名和身份组名，而这些名称会原样写入。如果把周围的说明译成中文、频道名却仍是英文，就等于承诺给你一个中文服务器、交付的却是英文服务器，所以模板目录刻意只提供英文。Vetox 其他所有文档页面以及控制面板本身，都会保持你的语言。
</Note>

## 模板包含什么

| 包含内容      | 说明                                            |
| --------- | --------------------------------------------- |
| **分类与频道** | 所有类型——文字、语音、公告、舞台、论坛——连同主题、慢速模式以及各自的权限覆盖设置    |
| **身份组**   | 名称、颜色、是否单独显示、是否可被提及，以及每个身份组应当拥有的那套权限          |
| **服务器设置** | 验证等级、内容过滤、默认通知设置、AFK 超时，以及哪个频道是系统频道、规则频道和更新频道 |

<Warning>
  模板只是一份**布局**。它绝不包含消息、成员、封禁记录、表情或贴纸，也绝不会把别的服务器的内容带进你的服务器。
</Warning>

<Note>
  **模板绝不会改动你服务器的名称。** 它只应用自己设计的那份布局，你服务器本身的名称和简介会原封不动——两种模式下都是如此。
</Note>

## 模板目录

22 个类别下共 220 个模板：

|                   |                   |                     |
| ----------------- | ----------------- | ------------------- |
| Gaming            | Esports           | Clans & Guilds      |
| Community         | Friends & Private | Support & Help Desk |
| Developers        | Education         | Study Groups        |
| Content Creators  | YouTube           | Streaming           |
| Anime & Manga     | Roleplay          | Music               |
| Art & Design      | Business          | Startups            |
| Local Communities | Web3 & Crypto     | Events              |
| Social & Hobbies  |                   |                     |

每个模板页面都会在你应用任何东西之前，完整展示它的频道树和身份组列表，并说明它适合谁、该怎么运营，以及它刻意规避的那些常见错误。在目录主页可以搜索、按规模和语言筛选，并按热门程度排序。

## 从网站应用模板

<Steps>
  <Step title="打开模板并点击应用">
    在 [vetox.io/templates](https://vetox.io/templates) 上该模板的页面里操作。若未登录，Vetox 会先请你用 Discord 登录，然后把你带回来。
  </Step>

  <Step title="选择服务器">
    只有你有权配置的服务器才会列出。
  </Step>

  <Step title="选择合并或替换">
    对话框会在该服务器的服务器备份页面打开，模板已经选好。参见[两种模式](#两种模式)。
  </Step>

  <Step title="阅读方案">
    Vetox 会读取你当前的服务器，在任何操作发生之前，准确告诉你将有多少频道和身份组被**创建**、**复用**和**删除**。
  </Step>

  <Step title="确认">
    替换模式会先要求你输入服务器的名称。随后 Vetox 会做一份安全备份并开始搭建模板，进度就显示在页面上。
  </Step>
</Steps>

<Tip>
  不用网站也能打开同一个对话框：在服务器的控制面板里打开 **备份 → 服务器备份**。
</Tip>

## 两种模式

|             | 合并 *（默认）*                | 替换       |
| ----------- | ------------------------ | -------- |
| 已经存在的频道和身份组 | **复用**——把模板的设置应用到你现有的对象上 | 先删除      |
| 服务器里的其他一切   | 保留                       | 删除       |
| 服务器设置       | 不改动                      | 按模板应用    |
| 你服务器的名称和简介  | 保留                       | 保留       |
| 确认方式        | 确认按钮                     | 输入服务器的名称 |
| 所需的备份权限     | 创建                       | 破坏性      |

<Tip>
  **合并是安全的那一个，也是默认选项。** 它补上缺少的部分，并沿用已经存在的部分，所以把同一个模板再合并一次，既不会改变什么，也不会产生重复。
</Tip>

合并按**名称**匹配，不区分大小写。一个身份组会匹配同名且非集成托管的现有身份组。一个频道要同名、同类型**并且**在同一个父分类下才算匹配——所以 **Text** 下的 `#general` 和 **Voice Text** 下的 `#general` 仍然是两个不同的频道。被复用的频道和身份组会保持你原来给它们的位置，只有新建的才由模板来排位。

<Warning>
  **替换会在搭建之前删除服务器里的每一个频道和身份组。** 成员永远不会被踢出，但其他一切都会消失，而且模板不会恢复消息。事先做好的那份安全备份，才是撤销它的办法。
</Warning>

## 安全备份

在应用模板之前，Vetox 会把你服务器此刻的样子拍成快照——频道、身份组、设置、表情和贴纸——并作为一份**安全**备份存放在备份标签页里。

<Note>
  如果安全副本失败，**模板绝不会被应用**。什么都不会改变。安全副本保留 7 天，且不计入你的备份数量上限。还原其中一份，就能让服务器回到原来的样子。
</Note>

## `/template` 命令

`/template` 是模板目录在 Discord 这一侧的入口。两个子命令，回复都是仅你可见。

| 要求           | 内容                        |
| ------------ | ------------------------- |
| **你需要**      | 管理服务器，**并且**需要管理员权限才能应用模板 |
| **Vetox 需要** | 查看频道——搭建布局还需要更多权限         |
| **冷却时间**     | 5s                        |
| **适用范围**     | 仅限服务器。私信中不可用              |

<AccordionGroup>
  <Accordion title="/template load — 把模板搭建进当前服务器" icon="wand-magic-sparkles">
    | 选项         | 必填    | 说明                                    |
    | ---------- | ----- | ------------------------------------- |
    | `template` | **是** | 目录中的名称或 ID，也可以是一个 Discord 模板链接。支持自动补全 |
    | `mode`     | 否     | `merge`（默认）或 `replace`                |

    第一次点击不会应用任何东西。Vetox 会回复方案，并附上**确认**和**取消**两个按钮，它们在 **60 秒**后失效；只有点了确认，它才会做安全备份并开始搭建。
  </Accordion>

  <Accordion title="/template info — 模板包含什么" icon="circle-info">
    | 选项         | 必填    | 说明                |
    | ---------- | ----- | ----------------- |
    | `template` | **是** | 目录中的名称或 ID。支持自动补全 |

    它的频道数和身份组数、它的用途，以及指向它页面的链接。`/template info` 只覆盖 Vetox 模板目录——Discord 模板链接没有对应的目录页面可供描述，这种情况请改用 `/template load`。
  </Accordion>
</AccordionGroup>

### `template` 里可以填什么

一个输入框，接受四种内容：

| 你输入                 | 示例                                 |
| ------------------- | ---------------------------------- |
| 模板的**名称**           | `Starter Community Hub`            |
| 它的 **ID**           | `community/starter-community-hub`  |
| 只写 **slug**         | `starter-community-hub`            |
| **Discord 模板**链接或代码 | `https://discord.new/H5qAZdEEeWdR` |

<Note>
  如果一个名称同时匹配到两个模板，Vetox 会拒绝执行而不是替你猜——请从自动补全里选一个，或者用它的 ID。自动补全只提供目录中的模板；Discord 链接需要自己输入。
</Note>

```text theme={null}
/template info template:community/starter-community-hub
/template load template:Starter Community Hub
/template load template:https://discord.com/template/H5qAZdEEeWdR
/template load template:gaming/multi-game-hangout mode:replace
```

## Discord 自带的模板

Discord 允许服务器所有者在 **服务器设置 → 服务器模板** 里把自己的服务器发布成模板，这会生成一个形如 `https://discord.new/H5qAZdEEeWdR` 的链接。

<Tip>
  **Vetox 能把这类链接应用到你已经拥有的服务器上**——把它粘贴进 `/template load`，或者粘贴到服务器备份页面上的**导入**对话框里。Discord 自己的链接永远只会创建一个**全新的空**服务器；要在你正在运营的服务器上用它，就得靠 Vetox。
</Tip>

<Note>
  反过来则行不通：Vetox 目录里的模板没有 `discord.new` 链接，因为 Discord 只会从它能读取的真实服务器生成这种链接。想分享你搭建好的布局，可以把自己的服务器发布成 Discord 模板并分享那个链接，或者把服务器导出为备份文件。
</Note>

## 权限

应用模板会改动你的服务器，所以它有两道门槛。

| 门槛            | 规则                                                                                                                   |
| ------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Discord**   | 用 `/template load` 应用模板需要**管理员**权限。从控制面板操作时，则按 **备份** 板块的常规[访问控制](/zh-CN/server-management/dashboard-permissions)来判断 |
| **服务器备份权限级别** | 合并算作创建操作，替换算作破坏性操作。在默认级别下——*管理员不能执行破坏性操作*——替换只有服务器所有者能用                                                              |

该级别位于服务器备份页面的 **设置 → 权限** 下，且只有服务器所有者才能更改。参见[权限](/zh-CN/server-management/server-backup)。

### Vetox 需要什么

<Warning>
  在应用模板之前，请给 Vetox **管理员**权限，并确认它的身份组排在模板所创建的那些身份组**之上**。Discord 不允许机器人授予它自己都没有的权限——遇到这种情况，身份组仍会被创建，只是不带那些权限，Vetox 也会明确告诉你。
</Warning>

## Discord 的频道与身份组上限

<Warning>
  一个服务器最多容纳 **250 个身份组和 500 个频道**，而且 Discord 只允许机器人在同一个服务器上于 **48 小时内**最多创建 250 个身份组或 500 个频道。如果服务器里两者本来就已经很多，一个大型模板可能会撞上其中任何一条。
</Warning>

Vetox 会在你确认之前检查服务器的容量上限，如果模板会让服务器超出上限，就会提前告诉你——请先删掉一些，或者用替换模式让旧的那些一并消失。Discord 的 48 小时创建额度是另一回事，删除任何东西都换不回来；如果一次搭建撞上了它，任务会停下并保留进度，`/backup status` 会显示额度何时恢复。

## 疑难解答

<AccordionGroup>
  <Accordion title="该模板不存在">
    名称、ID 或链接没有匹配到任何已发布的模板。请从自动补全里挑一个，或者到 [vetox.io/templates](https://vetox.io/templates) 浏览。Discord 链接必须是**模板**链接（`discord.new/…` 或 `discord.com/template/…`），而不是邀请链接。
  </Accordion>

  <Accordion title="从 Discord 创建备份需要管理员权限">
    应用模板会先给整个服务器做一份安全备份，因此需要管理员权限——只有管理服务器权限的话，可能存在一些对你隐藏、但快照仍会包含的频道。
  </Accordion>

  <Accordion title="只有服务器备份权限允许的人才能执行此操作">
    该服务器的服务器备份权限级别把这个操作留给了所有者。要么由所有者来应用模板，要么由所有者在 **设置 → 权限** 下调整级别。
  </Accordion>

  <Accordion title="这会让服务器超出 Discord 的上限">
    模板加上你已有的内容会超过 250 个身份组或 500 个频道。请删掉一些、改用替换模式，或者选一个更小的模板。
  </Accordion>

  <Accordion title="该服务器上已有另一个备份任务在运行">
    每个服务器在同一时间只能进行一次备份、还原或模板应用。请等待正在运行的任务，或者从它的进度卡片上取消它。
  </Accordion>

  <Accordion title="有些身份组排在 Vetox 之上">
    那些身份组已被记录下来并原样保留——Discord 不允许机器人编辑排在自己之上的身份组。把 Vetox 的身份组往上移，然后重新应用。
  </Accordion>

  <Accordion title="模板应用成功了，但我原有的一个频道被复用而不是重新创建">
    这正是合并的设计行为：同名、同类型且父分类相同的频道会被沿用，而不是复制一份。如果你想让模板从零搭建，请使用替换。
  </Accordion>
</AccordionGroup>

## 相关内容

<CardGroup cols={2}>
  <Card title="服务器备份" icon="server" href="/zh-CN/server-management/server-backup">
    快照、还原、计划任务，以及应用模板时使用的那份安全副本。
  </Card>

  <Card title="/backup 命令" icon="terminal" href="/zh-CN/commands/backup">
    如何导入 Discord 模板文件，以及每一条备份子命令。
  </Card>

  <Card title="访问控制" icon="user-lock" href="/zh-CN/server-management/dashboard-permissions">
    把备份板块授权给所有者以外的人。
  </Card>

  <Card title="权限" icon="shield-halved" href="/zh-CN/permissions">
    身份组层级，以及 Vetox 需要哪些权限。
  </Card>
</CardGroup>