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

# 역할·닉네임 자동화

> 인증 상태에 따라 Discord 역할과 닉네임을 자동으로 맞추고, 로블록스 그룹 가입을 조건으로 걸어 둘 수 있습니다.

인증은 한 번 하고 끝나는 게 아니라 **상태**입니다. 이 상태가 바뀔 때마다 Discord 쪽을 자동으로 따라가게 만드는 것이 이 페이지의 내용입니다.

대시보드의 **서버 → 모듈 → 인증** 에서 설정합니다.

## 역할 동기화

플레이어의 인증 상태가 바뀔 때마다 두 역할을 서로 바꿔 달아 줍니다.

<CardGroup cols={2}>
  <Card title="검증 역할" icon="circle-check">
    인증을 마치고 조건을 충족하는 동안 붙어 있는 역할입니다.
  </Card>

  <Card title="미검증 역할" icon="circle-dashed">
    아직 인증하지 않았거나 조건을 잃은 사람에게 붙는 역할입니다.
  </Card>
</CardGroup>

**Discord 역할 동기화** 를 켜고 두 역할을 지정하면 됩니다. 한 쪽만 쓰고 싶다면 나머지는 비워 두셔도 됩니다.

<Tip>
  인증 전 멤버가 대부분의 채널을 못 보게 하려면, **미검증 역할**을 만들고 그 역할의 채널 권한을 좁힌 뒤 여기 지정하세요. 인증을 마치면 자동으로 벗겨집니다.
</Tip>

## 닉네임 자동 설정

인증을 마친 멤버의 Discord 닉네임을 정해둔 형식으로 바꿉니다. 검증을 잃으면 원래 이름으로 되돌립니다.

템플릿에는 다음 변수를 쓸 수 있습니다.

| 변수          | 들어가는 값             |
| ----------- | ------------------ |
| `{로블록스닉네임}` | 연결된 로블록스 계정의 표시 이름 |
| `{디스코드이름}`  | Discord 계정의 이름     |
| `{주민등록번호}`  | 주민등록번호 방식일 때만      |
| `{고유번호}`    | 고유번호 방식일 때만        |

예를 들어 `[{고유번호}] {로블록스닉네임}` 으로 두면 `[1024] RouteOneKim` 처럼 바뀝니다.

<Warning>
  Discord 닉네임은 **32자**까지만 허용됩니다. 넘치면 Route One 이 뒤쪽을 잘라내고 줄임표를 붙입니다. 고정 텍스트를 짧게 쓰면 잘리는 일을 줄일 수 있습니다.
</Warning>

<Note>
  서버 설정에서 쓰는 신분 번호 방식에 해당하는 변수만 쓸 수 있습니다. 고유번호 방식인데 `{주민등록번호}` 를 넣으면 저장이 거부됩니다.
</Note>

## 검증 정책: 로블록스 그룹 조건

「인증만 하면 끝」이 아니라, **특정 로블록스 그룹에 가입해 있어야 검증으로 치는** 조건을 추가할 수 있습니다.

<Steps>
  <Step title="그룹을 연결합니다">
    **Roblox 그룹 링크** 에 그룹 주소 또는 초대 링크를 붙여넣습니다. 그룹 ID 는 자동으로 읽힙니다.
  </Step>

  <Step title="그룹 역할 목록을 불러옵니다">
    **역할 새로고침** 을 요청하면 그룹의 역할이 목록으로 채워집니다. 바로 채워지지 않고 잠시 후에 반영됩니다.
  </Step>

  <Step title="최소 역할을 정합니다">
    **최소 그룹 역할** 을 고르면, 그 이상의 역할을 가진 사람만 검증으로 인정됩니다.
  </Step>
</Steps>

<Warning>
  그룹 조건을 켜 둔 상태에서 그룹을 연결하지 않으면, 아무도 검증을 통과하지 못합니다. 조건을 켰다면 그룹 연결 상태도 반드시 확인하세요.
</Warning>

## 상태가 바뀔 때 일어나는 일

```mermaid theme={null}
flowchart LR
  A[인증하기 버튼] --> B{프로필에 문구가 있나}
  B -- 없음 --> A
  B -- 있음 --> C{그룹 조건을 켰나}
  C -- 꺼짐 --> D[검증 상태]
  C -- 켜짐 --> E{최소 역할 이상인가}
  E -- 예 --> D
  E -- 아니오 --> F[미검증 상태]
  D --> G[검증 역할 부여 · 닉네임 변경]
  F --> H[미검증 역할 부여 · 닉네임 복구]
```

## 자동화가 안 먹힐 때

<AccordionGroup>
  <Accordion title="역할이 부여되지 않습니다" icon="shield-alert">
    Route One 봇의 역할이 부여하려는 역할보다 **위에** 있어야 합니다. Discord 서버 설정 → 역할 에서 순서를 확인하세요.
  </Accordion>

  <Accordion title="특정 몇 명만 닉네임이 안 바뀝니다" icon="crown">
    그 몇 명이 **서버 소유자**이거나 봇보다 높은 역할을 가졌을 가능성이 큽니다. Discord 구조상 봇이 건드릴 수 없으며, 설정으로 풀 수 없습니다.
  </Accordion>

  <Accordion title="그룹 역할 목록이 비어 있습니다" icon="list-x">
    그룹 링크가 올바른지, 그리고 **역할 새로고침** 을 요청했는지 확인하세요. 요청은 접수된 뒤 잠시 뒤에 채워집니다.
  </Accordion>
</AccordionGroup>

## 다음 단계

<Card title="경제 시스템 개요" icon="wallet" href="/economy">
  인증이 돌아간다면 돈을 열어 줍니다.
</Card>