> ## 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 を含むすべてのプランで無料**です。テンプレートの適用は、内部的には [サーバーバックアップ](/ja/server-management/server-backup) の復元なので、同じセーフティコピーを作成し、同じ進行状況カードを表示します。ただし、プレミアム制限はかかりません。
</Info>

<Note>
  **カタログは英語で書かれています。** テンプレートの価値は、サーバーに書き込まれるチャンネル名とロール名そのものにあり、それらはそのまま反映されます。チャンネル名が英語のままなのにページだけを翻訳すると、日本語のサーバーを約束しておいて英語のサーバーを渡すことになるため、カタログはあえて英語のみとしています。ほかの Vetox ドキュメントページとダッシュボード自体は、これまでどおりあなたの言語で表示されます。
</Note>

## テンプレートに含まれるもの

| 含まれるもの          | 補足                                                                      |
| --------------- | ----------------------------------------------------------------------- |
| **カテゴリーとチャンネル** | テキスト、ボイス、アナウンス、ステージ、フォーラムのすべての種類。トピック、低速モード、チャンネルごとの権限の上書きも含みます         |
| **ロール**         | 名前、色、メンバーを別枠で表示するかどうか、メンションを許可するかどうか、そしてそのロールが持つべき権限のセット                |
| **サーバー設定**      | 認証レベル、コンテンツフィルター、通知の既定値、AFK タイムアウト、そしてどのチャンネルをシステム・ルール・アップデートのチャンネルにするか |

<Warning>
  テンプレートはあくまで **レイアウト** です。メッセージ、メンバー、BAN、絵文字、スタンプが含まれることは一切なく、ほかのサーバーの中身をあなたのサーバーへ持ち込むこともできません。
</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="統合か置き換えを選ぶ">
    ダイアログは、テンプレートが選択済みの状態で、そのサーバーのサーバーバックアップページ上に開きます。[2つのモード](#2つのモード)を参照してください。
  </Step>

  <Step title="計画を確認する">
    Vetox は現在のサーバーを読み取り、何かが実行される前に、いくつのチャンネルとロールが **作成**、**再利用**、**削除** されるかを正確に伝えます。
  </Step>

  <Step title="確定する">
    置き換えの場合は、先にサーバー名の入力を求められます。そのあと Vetox がセーフティバックアップを作成してテンプレートを構築し、進行状況をページに表示します。
  </Step>
</Steps>

<Tip>
  同じダイアログはウェブサイトを使わずに開けます。サーバーのダッシュボードで **バックアップ → サーバーバックアップ** を開いてください。
</Tip>

## 2つのモード

|                  | 統合 *(既定)*                        | 置き換え           |
| ---------------- | -------------------------------- | -------------- |
| すでに存在するチャンネルとロール | **再利用** — テンプレートの設定が既存のものに適用されます | 先に削除されます       |
| サーバー内のそれ以外のもの    | そのまま残ります                         | 削除されます         |
| サーバー設定           | 変更されません                          | テンプレートから適用されます |
| サーバーの名前と説明       | そのまま                             | そのまま           |
| 確認方法             | 確認ボタン                            | サーバー名を入力       |
| 必要なバックアップ権限      | 作成                               | 破壊的            |

<Tip>
  **統合が安全なほうで、こちらが既定です。** 不足しているものを追加し、すでにあるものはそのまま取り込むので、同じテンプレートをもう一度統合しても何も変わらず、何も重複しません。
</Tip>

統合は **名前** で照合し、大文字と小文字は区別しません。ロールは、同じ名前で連携によって管理されていない既存のロールと一致します。チャンネルは、名前、種類、**そして** 親カテゴリーがすべて同じものと一致します。そのため **Text** の下の `#general` と **Voice Text** の下の `#general` は、別々のチャンネルのままです。再利用されたチャンネルとロールは、あなたが決めた位置を保ちます。テンプレートが位置を決めるのは、新しく作られたものだけです。

<Warning>
  **置き換えは、構築を始める前にサーバー内のすべてのチャンネルとロールを削除します。** メンバーがキックされることは決してありませんが、それ以外はすべて消え、メッセージがテンプレートで復元されることもありません。元に戻せるのは、事前に作成されたセーフティバックアップです。
</Warning>

## セーフティバックアップ

テンプレートを適用する前に、Vetox はその時点のサーバー — チャンネル、ロール、設定、絵文字、スタンプ — をそのまま記録し、バックアップタブに **セーフティ** バックアップとして保存します。

<Note>
  セーフティコピーの作成に失敗した場合、**テンプレートは適用されません**。何も変更されません。セーフティコピーは 7 日間保管され、バックアップの上限にはカウントされません。復元すれば、サーバーは元どおりになります。
</Note>

## `/template` コマンド

`/template` はカタログの Discord 側の入り口です。サブコマンドは 2 つあり、どちらの応答も本人にしか表示されません。

| 要件               | 内容                                 |
| ---------------- | ---------------------------------- |
| **あなたに必要な権限**    | サーバー管理。**さらに**、適用するには管理者           |
| **Vetox に必要な権限** | チャンネルを見る — レイアウトの構築にはさらに多くの権限が必要です |
| **クールダウン**       | 5s                                 |
| **使える場所**        | サーバー内のみ。DM では使えません                 |

<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` に入力できるもの

入力欄は 1 つ、受け付けるものは 4 種類です:

| 入力するもの                        | 例                                  |
| ----------------------------- | ---------------------------------- |
| テンプレートの **名前**                | `Starter Community Hub`            |
| その **ID**                     | `community/starter-community-hub`  |
| **スラッグ** だけ                   | `starter-community-hub`            |
| **Discord テンプレート** のリンクまたはコード | `https://discord.new/H5qAZdEEeWdR` |

<Note>
  2 つのテンプレートに一致する名前は、推測されずに拒否されます。オートコンプリートから選ぶか、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>

## 権限

テンプレートの適用はサーバーを変更する操作なので、2 段階で保護されています。

| 保護                   | ルール                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Discord**          | `/template load` からテンプレートを適用するには **管理者** が必要です。ダッシュボードからの場合は、**バックアップ** セクションに対する通常の [アクセス制御](/ja/server-management/dashboard-permissions) が適用されます |
| **サーバーバックアップの権限レベル** | 統合は作成、置き換えは破壊的な操作として扱われます。既定のレベル — *管理者は破壊的な操作を実行できない* — では、置き換えは所有者だけの操作になります                                                                     |

このレベルはサーバーバックアップページの **設定 → 権限** にあり、変更できるのはサーバーの所有者だけです。[権限](/ja/server-management/server-backup) を参照してください。

### Vetox に必要なもの

<Warning>
  テンプレートを適用する前に Vetox に **管理者** を付与し、Vetox のロールがテンプレートで作成されるロールより **上** にあることを確認してください。Discord は、ボット自身が持っていない権限をボットが付与することを認めていません。その場合でもロールは作成されますが、該当する権限は付かず、Vetox がその旨を知らせます。
</Warning>

## Discord のチャンネル数とロール数の上限

<Warning>
  1 つのサーバーが持てるのは最大で **250 のロールと 500 のチャンネル** までで、さらに Discord は、ボットが 1 つのサーバーで **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="このサーバーでは別のバックアップ処理がすでに実行中です">
    1 つのサーバーにつき、バックアップ・復元・テンプレートの適用は同時に 1 つだけです。実行中の処理が終わるのを待つか、進行状況カードからキャンセルしてください。
  </Accordion>

  <Accordion title="一部のロールがロール一覧で Vetox より上にあります">
    それらのロールは報告されたうえで、変更されずに残されました。Discord は、自分より上のロールをボットが編集することを認めていません。Vetox のロールをもっと上に移動してから、もう一度適用してください。
  </Accordion>

  <Accordion title="テンプレートは適用されたが、既存のチャンネルが作り直されずに再利用された">
    それは統合が設計どおりに動作している結果です。名前、種類、親カテゴリーが同じチャンネルは、重複して作られるのではなく引き継がれます。テンプレートを一から構築したい場合は、置き換えを使ってください。
  </Accordion>
</AccordionGroup>

## 関連ページ

<CardGroup cols={2}>
  <Card title="サーバーバックアップ" icon="server" href="/ja/server-management/server-backup">
    スナップショット、復元、スケジュール、そしてテンプレートの適用が使うセーフティコピーについて。
  </Card>

  <Card title="/backup コマンド" icon="terminal" href="/ja/commands/backup">
    Discord のテンプレートファイルの取り込みと、すべてのバックアップサブコマンド。
  </Card>

  <Card title="アクセス制御" icon="user-lock" href="/ja/server-management/dashboard-permissions">
    所有者以外にバックアップセクションの権限を与える方法。
  </Card>

  <Card title="権限" icon="shield-halved" href="/ja/permissions">
    ロールの階層と、Vetox に必要なもの。
  </Card>
</CardGroup>