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

# カスタムボット

> Vetox の全機能を、あなた独自のボット名・アバター・プロフィールで動作させます。Max および Black のアドオンです。

Vetox のすべての機能を、**あなた自身の**ボットアカウント（あなたの名前・アバター・ステータス）で動作させます。

<Info>
  **Max** と **Black** のアドオンとして提供されます: **Max+** と **Black+**。価格は [Server Premium](/ja/premium/overview) を参照してください。
</Info>

<Warning>
  **カスタムボットは AI アクセスを付与しません。** これはあなたのティアとは別のフラグであり、AI はティアのみで制御されます。**Max+ に AI はありません。** AI を利用できるのは Black と Black+ のみです。
</Warning>

## 変更される内容

|                   | 効果                                              |
| ----------------- | ----------------------------------------------- |
| **名前、アバター、バナー**   | あなたのボット独自のもの                                    |
| **説明**            | 最大 400 文字                                       |
| **ステータス**         | プレイ中、視聴中、聴取中、または対戦中                             |
| **スラッシュコマンド**     | あなた自身のアプリケーションに登録されます                           |
| **公開版 Vetox ボット** | **そのサーバーでは沈黙します** — 2 つのボットが同時に応答しないように反応を停止します |

<Note>
  Discord はボットが単純なカスタムステータスを使うことを許可していません。ステータスは 4 つのアクティビティタイプのいずれかである必要があります。
</Note>

<Note>
  アイデンティティの更新は追加的です。フィールドを空にしても、以前の値が削除されるのではなくそのまま残ります — 代わりに置き換えの値を設定してください。
</Note>

## 1 つのボットにつき 1 サーバー

<Warning>
  カスタムボットは**1 つのサーバー**にのみ対応します。起動時に、追加されている他のすべてのサーバーから退出します。

  同じボットアプリケーションを複数のコミュニティで使用しないでください。
</Warning>

## セットアップ

<Steps>
  <Step title="Discord アプリケーションを作成する">
    Discord Developer Portal でアプリケーションを作成し、ボットを追加します。
  </Step>

  <Step title="特権インテントを有効にする">
    **Server Members**、**Presence**、**Message Content** のすべてが必要です。これらがないとボットは起動できません。
  </Step>

  <Step title="トークンをコピーして送信する">
    ダッシュボードに貼り付けます。Vetox は受け付ける前に Discord に対してトークンを検証します。

    <Warning>
      **トークンは書き込み専用です。** 送信後は Vetox から読み出すことはできません。事前に自分でコピーを保存してください — 紛失した場合は Developer Portal で再生成し、新しいトークンを送信する必要があります。
    </Warning>
  </Step>

  <Step title="ボットをサーバーに招待する">
    自分のアプリケーションの招待リンクを使用し、Vetox が必要とする権限で招待します。
  </Step>

  <Step title="オンラインになるのを待つ">
    ボットは短時間で起動します。その後、公開版 Vetox ボットはそのサーバーで応答を停止します。
  </Step>
</Steps>

<Note>
  トークンは保存時に暗号化されます。Vetox は受け付ける前に、フォーマットを検証し、ボットアカウントに属することを確認し、アプリケーションをチェックし、3 つの必須インテントを検証します。
</Note>

## 別のサーバーへの移行

カスタムボットの移行は 2 段階の確認が必要で、リクエストは **30 分**で有効期限が切れます。

<Warning>
  移行は確定すると取り消せません。ボットは古いサーバーから退出し、そのサーバーでは公開版 Vetox ボットが再開します。
</Warning>

## 無効化

無効化するとボットが停止し、**保存されているトークンが削除されます**。ブランディング設定と監査ログは保持されます。

再度有効化するには、トークンをもう一度送信してください。

## クラッシュした場合

1 分以内に 3 回クラッシュしたボットは、プラットフォーム保護のため自動的に停止されます。原因（通常は取り消されたトークンやインテント不足）を修正してから、再度有効化してください。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ボットがオンラインにならない">
    Developer Portal で 3 つの特権インテントすべて（Server Members、Presence、Message Content）を有効にする必要があります。これが最も一般的な原因です。
  </Accordion>

  <Accordion title="両方のボットがすべてに応答する">
    公開版ボットが沈黙するのは、カスタムボットが担当しているサーバーだけです。両方が反応している場合、カスタムボットが起動していない可能性があります — ダッシュボードでステータスを確認してください。
  </Accordion>

  <Accordion title="トークンを紛失した">
    Vetox はトークンを表示できません。Developer Portal で再生成し、新しいものを送信してください。
  </Accordion>

  <Accordion title="ボットが勝手にサーバーから退出した">
    正常な動作です — カスタムボットは 1 サーバーのみで動作し、起動時に他のサーバーを退出します。
  </Accordion>

  <Accordion title="Max+ を利用しているが AI がロックされている">
    正しい挙動です。カスタムボットはティアの変更ではなく、AI には Black が必要です。
  </Accordion>

  <Accordion title="アバターを変更したが古いものが表示されたまま">
    Discord はボットアバターを積極的にキャッシュします。再送信する前にしばらく時間を置いてください。
  </Accordion>
</AccordionGroup>

<Card title="ボット管理" icon="gauge" horizontal href="/ja/account/manage-bots">
  この設定を行うダッシュボードページです。
</Card>