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

# Comandos de moderación de miembros

> Baneos, expulsiones, silenciamientos, timeouts, advertencias, puntos y gestión de roles: 24 comandos para actuar sobre miembros.

Veintitrés comandos que actúan sobre un miembro. Todos requieren un permiso de Discord.

<Warning>
  **El rol de Vetox debe estar por encima del rol más alto del objetivo**, o Discord rechazará la acción sin importar los permisos. Esta es la causa más común de "el comando no hizo nada".
</Warning>

## Baneos y expulsiones

| Comando      | Necesitas         | Vetox necesita    | Enfriamiento |
| ------------ | ----------------- | ----------------- | ------------ |
| `/ban`       | Banear miembros   | Banear miembros   | 10 s         |
| `/unban`     | Banear miembros   | Banear miembros   | 5 s          |
| `/unban-all` | **Administrador** | Banear miembros   | 20 s         |
| `/kick`      | Expulsar miembros | Expulsar miembros | 10 s         |

<AccordionGroup>
  <Accordion title="Opciones de /ban" icon="hammer">
    | Opción            | Requerida | Notas                                                   |
    | ----------------- | --------- | ------------------------------------------------------- |
    | `user`            | **Sí**    |                                                         |
    | `duration`        | No        | `7d`, `2h30m`, `permanent`. **Por defecto, permanente** |
    | `reason`          | No        |                                                         |
    | `delete_messages` | No        | 0, 1, 3 o 7 días de historial de mensajes               |

    Una duración lo convierte en un baneo temporal, que se levanta automáticamente.
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` es requerido y acepta una mención, el selector o un ID en crudo, útil ya que un miembro baneado no puede mencionarse de forma normal. `reason` es opcional.
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    Sin opciones. **Levanta el baneo de todos los usuarios baneados del servidor.** Solo Administrador, enfriamiento de 20 s, y no hay confirmación previa ni deshacer.
  </Accordion>
</AccordionGroup>

## Timeouts y silenciamientos

Tres mecanismos distintos: no los confundas.

| Comando                        | Mecanismo                    | Necesitas          | Vetox necesita      |
| ------------------------------ | ---------------------------- | ------------------ | ------------------- |
| `/timeout`, `/untimeout`       | Timeout nativo de Discord    | Moderar miembros   | Moderar miembros    |
| `/mute-text`, `/unmute-text`   | Un **rol** de silencio       | Moderar miembros   | **Gestionar roles** |
| `/mute-voice`, `/unmute-voice` | Silencio de voz del servidor | Silenciar miembros | Silenciar miembros  |

Todos toman `user` (requerido), más `duration` y `reason` opcionales. Enfriamientos de 5 a 10 s.

<Note>
  **`/mute-text` aplica un rol**, por lo que necesita Gestionar roles y depende de que las sobreescrituras de canal de ese rol sean correctas. `/timeout` usa el timeout nativo de Discord y no necesita ningún rol.
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — quién está silenciado" icon="magnifying-glass">
    Requiere **Gestionar mensajes**. `user` opcional: omítelo para listar a todos los miembros silenciados por texto. Enfriamiento 5 s.
  </Accordion>
</AccordionGroup>

## Voz

| Comando  | Necesitas      | Vetox necesita | Notas                      |
| -------- | -------------- | -------------- | -------------------------- |
| `/vkick` | Mover miembros | Mover miembros | Desconecta de la voz       |
| `/move`  | Mover miembros | Mover miembros | Mueve entre canales de voz |

<Warning>
  **`/move` sin `user` te mueve a ti.** Todas las opciones son opcionales, y omitir el objetivo hace que sea, por defecto, la persona que ejecuta el comando. Especifica siempre `user`.
</Warning>

`/move` toma `user`, `to-user` (mover al canal en el que esté esa persona) y `to-channel`.

## Advertencias y puntos

| Comando         | Necesitas          | Enfriamiento |
| --------------- | ------------------ | ------------ |
| `/warn-add`     | Gestionar mensajes | 5 s          |
| `/warn-remove`  | Gestionar mensajes | 5 s          |
| `/warnings`     | Gestionar mensajes | 5 s          |
| `/points`       | Gestionar servidor | 5 s          |
| `/points-reset` | Gestionar servidor | 5 s          |

<AccordionGroup>
  <Accordion title="/warn-add" icon="triangle-exclamation">
    `user` requerido, `reason` opcional.

    <Warning>
      **El motivo está limitado a 250 caracteres, pero Discord te dejará escribir más.** Un motivo más largo lo acepta la caja de entrada y luego se rechaza al enviar. Mantenlo por debajo de 250.
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` requerido. `warning-code` opcional: **omitirlo elimina todas las advertencias** que tenga ese miembro.
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` opcional: omítelo para listar a todos los miembros amonestados. Paginado, con controles de eliminación.
  </Accordion>

  <Accordion title="/points y /points-reset" icon="hashtag">
    `/points` toma `user` y `amount`, donde amount acepta `+5`, `-5` o `5`. `/points-reset` toma un `user` opcional: **omítelo para restablecer a todos**.
  </Accordion>
</AccordionGroup>

## Roles

| Comando          | Necesitas          | Vetox necesita   | Enfriamiento |
| ---------------- | ------------------ | ---------------- | ------------ |
| `/role`          | Gestionar roles    | Gestionar roles  | 3 s          |
| `/temprole`      | Gestionar roles    | Gestionar roles  | 5 s          |
| `/rar`           | Gestionar roles    | Gestionar roles  | 10 s         |
| `/role-multiple` | **Administrador**  | Gestionar roles  | 30 s         |
| `/setnick`       | Gestionar apodos   | Gestionar apodos | 5 s          |
| `/inrole`        | Gestionar servidor | —                | 10 s         |

<AccordionGroup>
  <Accordion title="/role — conmutar un rol" icon="user-tag">
    `member` y `role` ambos requeridos. Añade el rol si no lo tiene, lo quita si lo tiene.
  </Accordion>

  <Accordion title="/temprole — rol con tiempo limitado" icon="clock">
    `member`, `role` y `duration` todos requeridos. El rol se elimina automáticamente al expirar.
  </Accordion>

  <Accordion title="/rar — quitar todos los roles" icon="user-minus">
    `user` requerido. Retira todos los roles que Vetox pueda eliminar.
  </Accordion>

  <Accordion title="/role-multiple — cambio masivo de roles" icon="users">
    Solo Administrador, enfriamiento 30 s.

    | Opción          | Requerida | Notas                                                                                  |
    | --------------- | --------- | -------------------------------------------------------------------------------------- |
    | `type`          | **Sí**    | `give` o `remove`                                                                      |
    | `role`          | **Sí**    |                                                                                        |
    | `pick_type`     | **Sí**    | `all`, `bots`, `humans` o `role`                                                       |
    | `required_role` | No        | **Solo se usa cuando `pick_type` es `role`**; se ignora silenciosamente en otros casos |

    <Warning>
      Esto afecta a la vez a todos los miembros coincidentes y no se puede deshacer en bloque.
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` requerido, `nickname` opcional: omítelo para restablecer. **Vetox nunca puede renombrar al dueño del servidor**; es una restricción de Discord.
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` requerido. Lista a todos los que lo tienen.
  </Accordion>
</AccordionGroup>

## Solución de problemas

<AccordionGroup>
  <Accordion title="Vetox dice que no puede actuar sobre ese miembro">
    Jerarquía de roles: mueve el rol de Vetox por encima del suyo. Los dueños de servidor nunca se pueden accionar.
  </Accordion>

  <Accordion title="/mute-text no hace nada visible">
    Aplica un rol. Si ese rol no tiene sobreescrituras de canal que denieguen Enviar mensajes, el miembro no está realmente silenciado.
  </Accordion>

  <Accordion title="Ejecuté /move y me moví a mí mismo">
    Se omitió `user`, que por defecto eres tú.
  </Accordion>

  <Accordion title="Mi motivo de advertencia fue rechazado">
    Más de 250 caracteres. La caja de entrada no te impide escribir más.
  </Accordion>

  <Accordion title="/warn-remove eliminó todas las advertencias">
    Se omitió `warning-code`, lo que las elimina todas.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Moderación del servidor" icon="shield-halved" href="/es/commands/server-moderation">
    Canales, limpieza, sorteos y tickets.
  </Card>

  <Card title="Herramientas de moderación" icon="wrench" href="/es/moderation/moderation-tools">
    Los equivalentes en el panel.
  </Card>
</CardGroup>