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

# 자동 조정

> 비속어, 초대, 링크, 대문자, 스포일러, 대량 멘션, 스팸에 대한 규칙 기반 메시지 필터링 — 자동 처벌 에스컬레이션 포함.

자동 조정은 메시지가 전송되는 순간 검사하여 활성화한 규칙을 위반하는 메시지에 조치를 취합니다. 모든 등급에서 무료입니다.

<Warning>
  **8개 규칙은 모두 비활성 상태로 배송됩니다.** 원하는 규칙을 켜기 전까지 자동 조정은 아무 일도 하지 않습니다.
</Warning>

<Warning>
  **Administrator를 가진 멤버는 절대 필터링되지 않습니다.** 설정과 관계없이 모든 규칙이 그들에게는 건너뜁니다. 이는 인터페이스 어디에도 표시되지 않습니다.

  관리자로 규칙을 테스트하면 작동하지 않는 것처럼 보입니다. 일반 계정으로 테스트하세요.
</Warning>

## 8개 규칙

<AccordionGroup>
  <Accordion title="비속어" icon="comment-slash">
    목록에 있는 단어를 포함한 메시지를 차단합니다. 각 항목은 최대 60자.
  </Accordion>

  <Accordion title="반복 텍스트" icon="repeat">
    반복 문자와 과도한 이모지를 잡습니다.
  </Accordion>

  <Accordion title="Discord 초대" icon="link-slash">
    Discord 초대 링크와 코드를 차단합니다.

    <Note>
      이 규칙에는 **구성 화면이 없습니다**. 켜거나 끄기만 가능하며 — 대시보드에서 특정 서버를 허용할 방법이 없습니다.
    </Note>
  </Accordion>

  <Accordion title="외부 링크" icon="globe">
    Discord 외부 사이트의 링크를 필터링하며, 허용 도메인 목록을 지원합니다.

    <Warning>
      **비어 있는 허용 도메인 목록은 모든 외부 링크를 차단합니다.** 도메인을 추가하지 않고 이 규칙을 활성화하면 모든 링크가 필터링됩니다. 먼저 허용할 도메인을 추가하세요.
    </Warning>
  </Accordion>

  <Accordion title="과도한 대문자" icon="font">
    대부분이 대문자인 메시지에 발동됩니다. 최소 7자 이상 메시지에만 적용되며 이모지는 계산에서 제외됩니다.
  </Accordion>

  <Accordion title="과도한 스포일러" icon="eye-slash">
    메시지가 포함할 수 있는 스포일러 태그 수를 제한합니다.
  </Accordion>

  <Accordion title="대량 멘션" icon="at">
    메시지가 멘션할 수 있는 사용자 또는 역할 수를 제한합니다.

    <Warning>
      제한은 **포함 방식**입니다 — 구성한 최대값과 정확히 같은 수를 멘션하는 메시지가 이미 규칙 위반입니다. 실제로 허용하려는 수보다 하나 더 크게 설정하세요.

      `@everyone`과 `@here`는 숫자와 관계없이 항상 이 규칙을 위반합니다.
    </Warning>
  </Accordion>

  <Accordion title="안티 스팸" icon="gauge-high">
    멤버당 메시지를 속도 제한합니다.

    <Warning>
      **"Interval (seconds)" 필드는 아무 것도 하지 않습니다.** 저장되지만 봇은 다른 저장 값을 읽으며 설정한 간격은 절대 적용되지 않습니다. 메시지 한도만 유효합니다.
    </Warning>
  </Accordion>
</AccordionGroup>

## 메시지당 하나의 규칙만 발동됩니다

<Warning>
  규칙은 순서대로 평가되며 **첫 번째 일치가 이깁니다**. 3개 규칙을 어긴 메시지도 하나만 트리거합니다 — 목록에서 가장 앞선 것.

  한 메시지에 대해 3개의 별도 조치를 볼 수는 없습니다.
</Warning>

## 조치

| 조치                 | 효과                    |
| ------------------ | --------------------- |
| **Block Message**  | 위반 메시지를 삭제            |
| **Send Alert**     | 선택한 채널에 안내 게시         |
| **Timeout Member** | 멤버를 고정된 기간 동안 timeout |

Timeout 기간은 고정 세트입니다: 60초, 5분, 10분, 1시간, 1일, 1주일.

<Warning>
  알아둘 만한 두 가지 조용한 동작:

  * **반복 텍스트와 안티 스팸에서는 Send Alert가 아무 것도 하지 않습니다.** 스위치는 저장되지만 알림이 게시되지 않습니다.
  * **Automated Action이 하나라도 구성되면 모든 규칙에서 Timeout이 억제됩니다.** 스위치는 켜진 채로 남고 기간도 유지되지만 timeout은 발동되지 않습니다 — Automated Actions가 처벌을 완전히 인수합니다.
</Warning>

규칙은 약 1분 이내에는 같은 멤버에게 두 번 조치하지 않으므로, 메시지 폭발은 10회가 아닌 1회 조치를 낳습니다.

## 제외

각 규칙에는 자체 **비활성 채널**과 **비활성 역할**이 있습니다. 제외 역할을 가진 멤버나 제외 채널에서는 규칙 전체가 건너뜁니다.

<Tip>
  링크와 초대 규칙에서 조정자 역할을 제외하세요 — 그렇지 않으면 정당한 참고 링크를 게시하는 조정자가 자기 서버의 규칙에 걸립니다.
</Tip>

## 배타 설정

8개 규칙과 별개로, 채널이 무엇을 수용할지를 제어합니다:

| 설정                   | 효과                            |
| -------------------- | ----------------------------- |
| **Only Commands**    | 채널이 명령어만 수용                   |
| **No Commands**      | 채널이 명령어를 거부, 구성 가능한 접두어 목록 지원 |
| **Only Attachments** | 첨부가 있는 메시지만 수용                |

각각 우회할 수 있는 **허용 역할** 목록이 있습니다. 차단 접두어 목록을 비워두면 기본값 `/`, `!`, `#`, `+`, `$`가 차단됩니다.

## Automated Actions

한 규칙 내가 아닌 여러 규칙에 걸친 멤버의 위반 횟수를 기반으로 하는 단계적 처벌입니다.

각 조치마다 처벌, 발동 위반 횟수, 위반을 집계하는 시간 창, 선택적으로 어떤 단일 규칙을 카운트할지 설정합니다.

<Warning>
  **Warn은 아무 일도 하지 않습니다.** 선택 시 봇의 로그에 한 줄을 기록할 뿐 어떠한 조치도 취하지 않습니다 — 멤버에게 경고가 발행되지 않고 경고 이력에도 남지 않습니다.

  실제 결과를 원한다면 Timeout이나 Mute를 사용하세요.
</Warning>

<Note>
  **Mute는 mute 역할이 아니라 Discord timeout으로 적용됩니다.** Mute와 Timeout은 동일하게 동작합니다.
</Note>

조치는 **위반 횟수가 가장 높은 것부터 아래로** 평가되며, 자격을 충족하는 첫 번째가 발동됩니다. 조치가 트리거되면 멤버의 위반 이력 전체가 지워지므로 에스컬레이션은 0에서 다시 시작됩니다.

<Info>
  Automated Actions는 자동 조정에서 등급 제한이 있는 유일한 부분입니다: **Starter는 1개**, **모든 유료 등급은 50개**. 한도에서는 추가 버튼이 비활성화되며 — 업그레이드 링크는 없습니다.
</Info>

## 저장

<Warning>
  **규칙 토글은 한 번에 하나씩 저장됩니다.** 중간에 하나가 실패하면 이미 적용된 토글은 유지되고 나머지는 적용되지 않습니다. 전체 저장이 롤백되었다고 가정하기보다 페이지를 다시 열어 실제 상태를 확인하세요.
</Warning>

비어 있는 배타 설정 목록은 빈 목록이 아니라 "unset"으로 저장됩니다 — 정상 동작이며 손실된 설정이 아닙니다.

## 존재하지만 접근할 수 없는 설정

일부 저장 설정은 봇이 읽지만 **대시보드 컨트롤이 없습니다**: 초대 허용 및 차단 목록, 외부 링크 차단 목록, 비속어가 긴 단어 안에서도 일치하는지 여부, 규칙별 mute 에스컬레이션 카운트 등입니다.

이 값들은 보유한 값을 그대로 유지하며 여기에서 변경할 수 없습니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="테스트할 때 아무것도 필터링되지 않아요">
    관리자로 테스트하고 있을 가능성이 매우 높습니다. 관리자는 모든 규칙에서 면제됩니다.
  </Accordion>

  <Accordion title="규칙이 켜져 있는데 트리거되지 않아요">
    규칙의 비활성 채널과 역할을 확인하고, 메시지당 첫 번째 일치 규칙만 발동된다는 점을 기억하세요.
  </Accordion>

  <Accordion title="Timeout이 구성되었는데 아무도 timeout되지 않아요">
    Automated Action이 하나 이상 있습니다. 그것이 모든 곳에서 규칙 수준 timeout을 비활성화합니다.
  </Accordion>

  <Accordion title="스팸이나 반복 텍스트에 알림이 게시되지 않아요">
    스위치가 있음에도 이 두 규칙은 알림을 지원하지 않습니다.
  </Accordion>

  <Accordion title="모든 링크가 차단되고 있어요">
    허용 도메인 목록이 비어 있습니다. 허용할 도메인을 추가하세요.
  </Accordion>

  <Accordion title="변경 사항이 저장됐는데 반영되지 않아요">
    구성은 일반적으로 약 30초 안에 봇에 도달하지만, 알림을 놓치는 경우 최대 10분이 걸릴 수 있습니다. 다시 저장하기 전에 기다리세요.
  </Accordion>
</AccordionGroup>

## 관련

<CardGroup cols={2}>
  <Card title="AI 자동 조정" icon="sparkles" href="/ko/moderation/ai-auto-mod">
    정확한 텍스트가 아닌 의도를 잡습니다.
  </Card>

  <Card title="로깅" icon="scroll" href="/ko/moderation/logs">
    자동 조정 조치를 검토용으로 기록합니다.
  </Card>
</CardGroup>