> ## Documentation Index
> Fetch the complete documentation index at: https://docs.route-one.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제가 생겼을 때

> 연결, 인증, 명령어에서 자주 막히는 지점과 해결 순서입니다.

증상별로 묶었습니다. 위에서부터 순서대로 확인하세요.

## 연결이 안 될 때

<AccordionGroup>
  <Accordion title="연결할 Discord 서버 목록이 비어 있습니다" icon="list-x">
    로그인한 Discord 계정이 어느 서버에서도 소유자가 아니거나 「서버 관리하기」 권한이 없는 상태입니다.

    브라우저에 다른 Discord 계정이 로그인되어 있지 않은지도 확인하세요. → [Discord 서버 연결](/connect/discord)
  </Accordion>

  <Accordion title="서버 신호가 오지 않습니다" icon="wifi-off">
    대부분 이 둘 중 하나입니다.

    1. Studio 의 **게임 설정 → 보안 → HTTP 요청 허용**이 꺼져 있음
    2. 플러그인만 설치하고 경험을 실행하지 않았음

    → [연결 확인하기](/connect/test)
  </Accordion>

  <Accordion title="연결 요청이 만료됐다고 나옵니다" icon="timer-off">
    승인 링크를 오래 두면 만료됩니다. Studio 의 Route One 창에서 버튼을 다시 눌러 새 요청을 만드세요.
  </Accordion>
</AccordionGroup>

## 인증이 안 될 때

<AccordionGroup>
  <Accordion title="문구를 붙였는데 인증이 안 됩니다" icon="clipboard-x">
    로블록스 프로필 소개글 수정이 **실제로 저장됐는지** 확인하세요. 모바일 앱에서 저장이 누락되는 경우가 있습니다.

    로블록스가 소개글을 검토 중이면 반영이 늦을 수도 있습니다. 잠시 뒤에 확인 버튼을 다시 누르세요.
  </Accordion>

  <Accordion title="인증하기 버튼을 눌렀는데 응답이 없습니다" icon="message-square-x">
    그 채널에서 봇이 메시지를 보낼 수 있는지 확인하세요. 채널별 권한으로 막혀 있으면 응답 자체가 불가능합니다.

    **인증 메시지 활성화** 가 꺼져 있으면 버튼은 있지만 비활성 응답만 돌아옵니다. → [인증 패널](/identity/panel)
  </Accordion>

  <Accordion title="인증은 됐는데 역할이 안 붙습니다" icon="shield-alert">
    Route One 봇의 역할이 부여하려는 역할보다 **위에** 있어야 합니다.

    대상이 서버 소유자라면 Discord 구조상 불가능합니다. → [역할과 닉네임](/identity/policy)
  </Accordion>

  <Accordion title="그룹 조건을 켰더니 아무도 검증이 안 됩니다" icon="users-round">
    그룹 조건을 켜 둔 상태에서 그룹을 연결하지 않았거나, 최소 그룹 역할을 너무 높게 잡은 경우입니다.
  </Accordion>
</AccordionGroup>

## 명령어가 안 될 때

<AccordionGroup>
  <Accordion title="명령어가 목록에 안 보입니다" icon="terminal">
    봇을 방금 초대했다면 Discord 가 목록을 반영하는 데 잠시 걸립니다. Discord 앱을 완전히 재시작해 보세요.
  </Accordion>

  <Accordion title="연동된 계정이 없다고 나옵니다" icon="unlink">
    그 서버에서 아직 인증을 안 한 상태입니다. 인증은 **서버마다 따로** 해야 합니다.
  </Accordion>

  <Accordion title="관리자인데 관리자 명령어가 안 보입니다" icon="lock">
    Discord 서버 설정 → 연동 → Route One 에서 해당 명령어가 막혀 있을 수 있습니다. → [운영진 권한](/connect/staff)
  </Accordion>

  <Accordion title="응시 코드가 거부됩니다" icon="key-round">
    사유가 여럿입니다. 증상별 표를 [접수와 응시](/license/exam) 에 정리해 두었습니다.
  </Accordion>
</AccordionGroup>

## 그래도 안 될 때

<Card title="문의하기" icon="life-buoy" href="/help/contact">
  서버 이름과 증상, 그리고 언제부터 그러는지를 같이 알려 주세요.
</Card>