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

# メンバーモデレーションコマンド

> BAN、キック、ミュート、タイムアウト、警告、ポイント、ロール管理 — メンバーに対する 24 コマンド。

メンバーに対して作用する 23 コマンド。すべて Discord 権限が必要です。

<Warning>
  **Vetox のロールは対象の最上位ロールより上位である必要があります**。そうでないと、権限に関係なく Discord が操作を拒否します。「コマンドが効かない」原因の大半はこれです。
</Warning>

## BAN とキック

| コマンド         | 必要権限（あなた）         | 必要権限（Vetox）  | クールダウン |
| ------------ | ----------------- | ------------ | ------ |
| `/ban`       | Ban Members       | Ban Members  | 10 秒   |
| `/unban`     | Ban Members       | Ban Members  | 5 秒    |
| `/unban-all` | **Administrator** | Ban Members  | 20 秒   |
| `/kick`      | Kick Members      | Kick Members | 10 秒   |

<AccordionGroup>
  <Accordion title="/ban のオプション" icon="hammer">
    | オプション             | 必須     | 備考                                         |
    | ----------------- | ------ | ------------------------------------------ |
    | `user`            | **はい** |                                            |
    | `duration`        | いいえ    | `7d`、`2h30m`、`permanent`。**既定は permanent** |
    | `reason`          | いいえ    |                                            |
    | `delete_messages` | いいえ    | 0、1、3、7 日分のメッセージ履歴                         |

    期間指定で一時 BAN になり、自動で解除されます。
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` は必須で、メンション、ピッカー、生の ID を受け付けます — BAN 中のメンバーは通常メンションできないため便利です。`reason` は任意。
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    オプションなし。**サーバー内の BAN 済みユーザーを全員解除します。** Administrator 専用、クールダウン 20 秒、確認ダイアログや取り消しはありません。
  </Accordion>
</AccordionGroup>

## タイムアウトとミュート

3 つの異なる仕組みがあります — 混同しないでください。

| コマンド                           | 仕組み                  | 必要権限（あなた）        | 必要権限（Vetox）      |
| ------------------------------ | -------------------- | ---------------- | ---------------- |
| `/timeout`, `/untimeout`       | Discord のネイティブタイムアウト | Moderate Members | Moderate Members |
| `/mute-text`, `/unmute-text`   | ミュート **ロール**         | Moderate Members | **Manage Roles** |
| `/mute-voice`, `/unmute-voice` | サーバーボイスミュート          | Mute Members     | Mute Members     |

いずれも `user`（必須）に加え、任意の `duration` と `reason` を受け付けます。クールダウン 5〜10 秒。

<Note>
  **`/mute-text` はロールを付与する方式** のため、Manage Roles が必要で、そのロールのチャンネル上書きが正しく設定されている必要があります。`/timeout` は Discord 組み込みのタイムアウトを使うためロールは不要です。
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — ミュート中のメンバーを確認" icon="magnifying-glass">
    **Manage Messages** が必要。`user` は任意 — 省略すると全テキストミュートメンバーを一覧表示します。クールダウン 5 秒。
  </Accordion>
</AccordionGroup>

## ボイス

| コマンド     | 必要権限（あなた）    | 必要権限（Vetox）  | 備考           |
| -------- | ------------ | ------------ | ------------ |
| `/vkick` | Move Members | Move Members | ボイスから切断      |
| `/move`  | Move Members | Move Members | ボイスチャンネル間で移動 |

<Warning>
  **`user` なしの `/move` は自分自身を移動します。** すべてのオプションが任意で、対象を省略するとコマンド実行者が既定になります。必ず `user` を指定してください。
</Warning>

`/move` は `user`、`to-user`（その人のいるチャンネルへ移動）、`to-channel` を受け付けます。

## 警告とポイント

| コマンド            | 必要権限（あなた）       | クールダウン |
| --------------- | --------------- | ------ |
| `/warn-add`     | Manage Messages | 5 秒    |
| `/warn-remove`  | Manage Messages | 5 秒    |
| `/warnings`     | Manage Messages | 5 秒    |
| `/points`       | Manage Server   | 5 秒    |
| `/points-reset` | Manage Server   | 5 秒    |

<AccordionGroup>
  <Accordion title="/warn-add" icon="triangle-exclamation">
    `user` 必須、`reason` 任意。

    <Warning>
      **理由は 250 文字までですが、Discord はそれ以上入力できてしまいます。** 入力ボックス自体は受け付けても、送信時に拒否されます。250 文字以内に収めてください。
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` 必須。`warning-code` は任意 — **省略すると、そのメンバーの全警告が削除されます**。
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` 任意 — 省略すると警告のある全メンバーを一覧表示。ページ送りと削除操作あり。
  </Accordion>

  <Accordion title="/points と /points-reset" icon="hashtag">
    `/points` は `user` と `amount` を受け取り、amount は `+5`、`-5`、`5` を受け付けます。`/points-reset` は任意の `user` を受け取り、**省略すると全員がリセットされます**。
  </Accordion>
</AccordionGroup>

## ロール

| コマンド             | 必要権限（あなた）         | 必要権限（Vetox）      | クールダウン |
| ---------------- | ----------------- | ---------------- | ------ |
| `/role`          | Manage Roles      | Manage Roles     | 3 秒    |
| `/temprole`      | Manage Roles      | Manage Roles     | 5 秒    |
| `/rar`           | Manage Roles      | Manage Roles     | 10 秒   |
| `/role-multiple` | **Administrator** | Manage Roles     | 30 秒   |
| `/setnick`       | Manage Nicknames  | Manage Nicknames | 5 秒    |
| `/inrole`        | Manage Server     | —                | 10 秒   |

<AccordionGroup>
  <Accordion title="/role — ロールをトグル" icon="user-tag">
    `member` と `role` は共に必須。ロールがなければ付与し、あれば剥奪します。
  </Accordion>

  <Accordion title="/temprole — 期間限定ロール" icon="clock">
    `member`、`role`、`duration` すべて必須。期限が来ると自動で剥奪されます。
  </Accordion>

  <Accordion title="/rar — 全ロールを剥奪" icon="user-minus">
    `user` 必須。Vetox が剥奪可能なロールをすべて外します。
  </Accordion>

  <Accordion title="/role-multiple — 一括ロール変更" icon="users">
    Administrator 専用、クールダウン 30 秒。

    | オプション           | 必須     | 備考                                                 |
    | --------------- | ------ | -------------------------------------------------- |
    | `type`          | **はい** | `give` または `remove`                                |
    | `role`          | **はい** |                                                    |
    | `pick_type`     | **はい** | `all`、`bots`、`humans`、`role`                       |
    | `required_role` | いいえ    | **`pick_type` が `role` のときのみ使用** — それ以外では黙って無視されます |

    <Warning>
      これは該当する全メンバーに一括で作用し、まとめて取り消すことはできません。
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` 必須、`nickname` 任意 — 省略でリセット。**Vetox はサーバーオーナーの名前を変更できません**。これは Discord の制限です。
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` 必須。そのロールを持つ全員を一覧表示します。
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Vetox が「そのメンバーには操作できない」と言う">
    ロール階層です — Vetox のロールを対象より上に移動してください。サーバーオーナーには操作できません。
  </Accordion>

  <Accordion title="/mute-text で見た目に変化がない">
    これはロールを付与する方式です。そのロールに Send Messages を拒否するチャンネル上書きがなければ、実際にはミュートされません。
  </Accordion>

  <Accordion title="/move を実行したら自分が移動した">
    `user` を省略しました。既定はあなたです。
  </Accordion>

  <Accordion title="警告の理由が拒否された">
    250 文字を超えています。入力ボックスは入力を止めてくれません。
  </Accordion>

  <Accordion title="/warn-remove で全警告が消えた">
    `warning-code` を省略したためです。省略で全削除になります。
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="サーバーモデレーション" icon="shield-halved" href="/ja/commands/server-moderation">
    チャンネル、クリーンアップ、ギブアウェイ、チケット。
  </Card>

  <Card title="モデレーションツール" icon="wrench" href="/ja/moderation/moderation-tools">
    ダッシュボード版。
  </Card>
</CardGroup>
