> ## 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 の大部分の問題を解決するチェック手順。

順番に進めてください。最初の 3 項目でほとんどの問い合わせは解決します。

## 最初の 3 つのチェック

<Steps>
  <Step title="モジュールはオンになっているか?">
    ほとんどの機能は **既定でオフ** です。機能ページで設定しても、[サーバーセットアップ](/ja/server-management/setup) のスイッチがオンになるまでは何も起きません。

    「設定したのに何も起きなかった」の最大の原因はこれです。
  </Step>

  <Step title="Vetox のロールは十分に上位か?">
    ロールやメンバーに関わる操作では、**Vetox のロールが対象の最上位ロールより上位である必要があります**。サーバー設定 → ロールでドラッグして上げてください。

    Discord は権限に関係なくこれらの操作を拒否します。Vetox のいくつかの部分はこの状態で **黙って** 失敗します — 特にチケットは何もエラーを返しません。
  </Step>

  <Step title="Vetox にチャンネル権限があるか?">
    サーバー全体のロールではなく、そのチャンネルでの *実効* 権限を確認してください。最も欠けやすいのは **Embed Links** です。
  </Step>
</Steps>

## 症状別

<AccordionGroup>
  <Accordion title="自動モデレーションが何もフィルタしない" icon="filter">
    1. 8 つのルールはすべて **無効** で出荷 — 使いたいものをオンに
    2. **管理者は決してフィルタされません。** 通常アカウントでテスト
    3. メッセージごとに、最初にマッチしたルールのみ発火
    4. ルール自身の無効チャンネルとロールを確認
    5. Automated Action が存在する場合、どこでもルール単位のタイムアウトは抑制されます
  </Accordion>

  <Accordion title="通知が届かない" icon="bell">
    1. **サーバーセットアップ** のプラットフォームトグル — 既定オフで、通知ページは状態を表示しません
    2. アクティブな **Basic** プレミアム以上
    3. 対象チャンネルの **Embed Links**
    4. Twitch と Kick では、既に配信中のストリーマーを追加しても次回配信まで何も告知されません
    5. プレミアム失効中に公開されたものは既読扱いとなり、再配信されません
  </Accordion>

  <Accordion title="ロールが付与されない" icon="user-tag">
    1. ロールは Vetox のロールより **下** にある必要がある
    2. Vetox に **Manage Roles** が必要
    3. Vetox は Administrator、Manage Server、Manage Roles を持つロールを報酬として付与しません — これは上書き不可
    4. ロール未選択の報酬ロール行は、保存時に黙って破棄されます
  </Accordion>

  <Accordion title="スタッフがチケットで閲覧・操作できない" icon="ticket">
    ほぼ確実に **ロール階層** です。Vetox のロールをすべてのサポートロールより上に移動してください。

    チケットの権限失敗ではエラーもログもなく、スタッフが操作できないこと以外に目に見える症状は出ません。
  </Accordion>

  <Accordion title="埋め込みフィールドが消え続ける" icon="rectangle-list">
    タイトルまたは値が空文字列に解決され、空のフィールドは破棄されます。ほぼ確実に変数のスペルミスか、その機能で存在しない変数です — [変数](/ja/help/variables) を参照。
  </Accordion>

  <Accordion title="設定は保存されたのに反映されない" icon="floppy-disk">
    設定は通常数秒でボットに届きます。通知を取りこぼした場合、ボットのキャッシュが期限切れになるまで — **最大 10 分ほど** — 旧値のままです。

    再保存する前に 10 分待ってください。
  </Accordion>

  <Accordion title="メンバーが XP を獲得しない" icon="chart-line">
    1. サーバーセットアップで Leveling をオン
    2. チャンネルが除外されておらず、メンバーが除外ロールを持っていない
    3. **Starter** ではテキスト／ボイス／リアクションのオン・オフスイッチは効きません — ボットは常に標準レートを使います
  </Accordion>

  <Accordion title="ウェルカムメッセージが投稿されない" icon="hand-wave">
    1. サーバーセットアップで Welcomer をオン、チャンネルを設定、メッセージスイッチをオン
    2. 画像には **Attach Files**
    3. `[Server]` がリテラルで出るなら、`[ServerName]` に置き換えてください
    4. 埋め込みが戻ってしまう場合、保存時にメッセージタイプを **Embed** に設定する必要があります
  </Accordion>

  <Accordion title="アプリケーションを送信できない" icon="clipboard-list">
    ダイアログ形式のフォームで質問が 5 個を超え、後ろの質問が必須の場合、**絶対に** 送信できません — Discord は 5 個までしか表示しませんが、6 個目以降も検証されます。

    プライベートメッセージフローに切り替えるか、6 個目以降を任意にしてください。
  </Accordion>

  <Accordion title="コマンドが表示されない" icon="terminal">
    1. すべてのコマンドは **ギルド専用** — DM では動作しません
    2. [コマンド](/ja/server-management/command-management) ページで無効化・制限されている可能性
    3. Discord クライアントを再起動してコマンド一覧を更新
  </Accordion>

  <Accordion title="AI 機能が動かなくなった" icon="sparkles">
    [AI 使用状況](/ja/moderation/ai-usage) でトークン残高を確認してください。

    自動モデレーションは 3,000 トークン未満で停止、サーバー制御は 30,000 トークン未満で拒否します。自動モデレーションはフェイルクローズド — 予算を確認できない場合はスキャンしません。
  </Accordion>

  <Accordion title="AI サーバー制御が完全に無視する" icon="wand-magic-sparkles">
    アクセス失敗すべてに対して、応答なしが通常の挙動です。順に:

    1. ボットに **直接** メンション — ロール ping や返信 ping はトリガーになりません
    2. サーバーセットアップで AI サーバー制御がオン
    3. チャンネルが対象範囲内
    4. Administrator であるか、*Allowlist bypasses Administrator* をオンにしたうえで許可リストに載っている — 許可リスト単体では効きません
    5. レート制限にかかっていない
  </Accordion>

  <Accordion title="購入が反映されない" icon="credit-card">
    通常は 1 秒以内に反映されます。15 分ほど待ってからサポートに連絡してください — **重複購入はしないでください**。
  </Accordion>

  <Accordion title="ダウングレード後にデータが消えた" icon="triangle-exclamation">
    9 つのカテゴリは無効化ではなく完全に削除されます — 特に **新しい上限を超えるアプリケーション質問** です。[機能上限](/ja/premium/feature-limits) を参照。
  </Accordion>

  <Accordion title="スケジュールが違う時刻に発火する" icon="clock">
    サーバーセットアップの **Server Timezone** を確認してください — ストリーク、リセット、スケジュールされたアクションはこれに従います。

    リマインダーだけは例外で、作成時のブラウザのタイムゾーンを取得し、設定項目はありません。
  </Accordion>
</AccordionGroup>

## 壊れているように見えるが仕様のもの

<Note>
  | 挙動                                 | 理由                   |
  | ---------------------------------- | -------------------- |
  | 管理者が自動モデレーションをすり抜ける                | 仕様、UI には表示されない       |
  | メッセージあたり自動モデルールは 1 つだけ発火           | 仕様 — 最初のマッチが勝つ       |
  | 配信中に追加したストリーマーは何も告知しない             | ライブ追跡は状態遷移で発火        |
  | Vito のランクが残高から遅れる                  | リーダーボードは 12 時間ごとに再計算 |
  | 単発リマインダーが発火後もリストに残る                | 記録として保持、完了マーク付き      |
  | サーバーセットアップの 7 カードが初回読み込みで一瞬「有効」と表示 | 表示上の問題、Disabled 状態が正 |
  | ユーザー指定なしの `/move` が自分を移動           | オプションが呼び出し元に既定化される   |
</Note>

## それでも解決しない

<CardGroup cols={2}>
  <Card title="サポートサーバー" icon="discord" href="https://discord.gg/vetox">
    Vetox の Discord で質問。
  </Card>

  <Card title="ヘルプが必要" icon="life-ring" href="/ja/server-management/support-sessions">
    エージェントにダッシュボードをライブで見てもらう。
  </Card>
</CardGroup>
