> ## 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](/ko/premium/overview) 참고.
</Info>

<Warning>
  **Custom Bot은 AI 접근을 부여하지 않습니다.** 등급과 별개의 플래그이며, AI는 등급 하나로만 게이팅됩니다. **Max+에는 AI가 없습니다.** Black과 Black+에만 있습니다.
</Warning>

## 무엇이 바뀌나

|                 | 효과                                          |
| --------------- | ------------------------------------------- |
| **이름, 아바타, 배너** | 여러분의 봇 자체                                   |
| **설명**          | 최대 400자                                     |
| **상태**          | Playing, Watching, Listening 또는 Competing   |
| **슬래시 명령어**     | 여러분 애플리케이션에 등록됨                             |
| **공용 Vetox 봇**  | **해당 서버에서 침묵합니다** — 응답을 멈추어 둘 다 답하지 않도록 합니다 |

<Note>
  Discord는 봇에게 일반 커스텀 상태를 허용하지 않습니다. 상태는 네 가지 활동 유형 중 하나여야 합니다.
</Note>

<Note>
  아이덴티티 업데이트는 추가 방식입니다. 필드를 비워두면 이전 값이 유지됩니다 — 대신 대체 값을 설정하세요.
</Note>

## 봇당 하나의 서버

<Warning>
  Custom Bot은 **하나의 서버**를 담당합니다. 시작 시 추가되어 있던 다른 서버를 떠납니다.

  같은 봇 애플리케이션을 여러 커뮤니티에 걸쳐 사용하지 마세요.
</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는 형식을 검증하고, 봇 계정에 속하는지 확인하며, 애플리케이션을 확인하고, 세 가지 필수 인텐트가 있는지 검증한 후 승인합니다.
</Note>

## 다른 서버로 이전

Custom Bot 이동은 2단계 확인이며 요청은 **30분** 후 만료됩니다.

<Warning>
  확정된 이전은 최종입니다. 봇은 이전 서버를 떠나고 그곳에서는 공용 Vetox 봇이 다시 활성화됩니다.
</Warning>

## 비활성화

비활성화는 봇을 중지하고 **저장된 토큰을 삭제합니다**. 브랜딩 설정과 활동 로그는 유지됩니다.

다시 활성화하려면 토큰을 다시 제출하세요.

## 크래시 발생 시

1분 안에 세 번 크래시한 봇은 플랫폼 보호를 위해 자동으로 중지됩니다. 원인 — 대개 취소된 토큰이나 누락된 인텐트 — 을 해결한 후 다시 활성화하세요.

## 문제 해결

<AccordionGroup>
  <Accordion title="봇이 온라인이 되지 않아요">
    세 가지 특권 인텐트 — Server Members, Presence, Message Content — 가 모두 Developer Portal에서 활성화되어 있어야 합니다. 가장 흔한 원인입니다.
  </Accordion>

  <Accordion title="두 봇이 모두 응답해요">
    공용 봇은 Custom Bot이 담당하는 서버에서만 침묵합니다. 둘 다 보인다면 Custom Bot이 시작되지 않았을 수 있습니다 — 대시보드에서 상태를 확인하세요.
  </Accordion>

  <Accordion title="토큰을 잃어버렸어요">
    Vetox가 보여줄 수 없습니다. Developer Portal에서 재생성한 후 새 토큰을 제출하세요.
  </Accordion>

  <Accordion title="봇이 스스로 서버를 떠났어요">
    예상된 동작입니다 — Custom Bot은 하나의 서버를 담당하며 시작 시 나머지를 떠납니다.
  </Accordion>

  <Accordion title="Max+인데 AI가 잠겼어요">
    맞습니다. Custom Bot은 등급 변경이 아닙니다; AI는 Black이 필요합니다.
  </Accordion>

  <Accordion title="아바타를 바꿨는데 이전 것이 그대로예요">
    Discord가 봇 아바타를 공격적으로 캐시합니다. 재제출하기 전에 시간을 주세요.
  </Accordion>
</AccordionGroup>

<Card title="봇 관리" icon="gauge" horizontal href="/ko/account/manage-bots">
  이를 설정하는 대시보드 페이지.
</Card>