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

# 환영 메시지

> 새 멤버를 메시지, 생성된 이미지, 또는 둘 다로 환영합니다. 작별 메시지와 임시 greet 기능도 포함.

Welcomer는 세 가지를 다룹니다. 누군가 참여할 때의 **welcome**, 나갈 때의 **goodbye**, 그리고 다른 채널의 짧은 **greets**입니다.

<Note>
  welcome 메시지와 welcome 이미지는 모두 **기본으로 꺼져 있으며**, 각각 자체 스위치를 가집니다.
</Note>

## Welcome 메시지

채널을 선택하고 메시지를 작성합니다. 세 가지 형식:

| 형식           | 필요 등급 |
| ------------ | ----- |
| **일반 메시지**   | 무료    |
| **임베드**      | Basic |
| **Advanced** | Basic |

Advanced 형식은 최대 20개의 컴포넌트로 더 풍부한 레이아웃을 구성합니다. 배너, 임베드, 콘텐츠 블록, 링크 버튼, welcome 이미지 등입니다.

### 변수

| 변수             | 해석           |
| -------------- | ------------ |
| `[User]`       | 새 멤버         |
| `[ServerName]` | 서버 이름        |
| `[UsersCount]` | 참여 후 멤버 수    |
| `[Inviter]`    | 초대한 사람       |
| `[Code]`       | 사용한 초대 코드    |
| `[CountUrl]`   | 멤버 수 이미지 URL |

<Warning>
  기본으로 배포되는 메시지에는 `[Server]`가 포함되어 있는데, 이는 **지원되는 변수가 아니며** 대체되지 않습니다. 편집할 때 `[ServerName]`을 대신 사용하세요.
</Warning>

## Welcome 이미지

Vetox는 각 새 멤버를 위해 이미지를 생성할 수 있으며, 당신이 제공하는 배경 위에 아바타와 이름이 표시됩니다.

캔버스는 기본 **500 x 300**이며, 위치와 스타일을 조정할 수 있는 세 요소를 담습니다.

| 요소      | 비고                      |
| ------- | ----------------------- |
| **아바타** | 원형 또는 사각형, 위치와 크기 조정 가능 |
| **이름**  | 멤버 이름, 크기, 색상, 정렬       |
| **텍스트** | 고정 캡션, 크기, 색상, 정렬       |

이미지에 대한 텍스트 위치(앞, 뒤 또는 결합)를 설정할 수 있습니다.

<Tip>
  캔버스 크기에 맞춰 배경을 업로드하세요. 크기가 맞지 않는 배경이 이미지가 늘어지거나 잘려 보이는 일반적인 원인입니다.
</Tip>

## Goodbye 메시지

동일한 옵션이지만 멤버가 나갈 때 트리거됩니다. Goodbye는 `[User]`, `[ServerName]`, `[UsersCount]`를 지원합니다.

Goodbye는 자체 캔버스와 자체 컴포넌트를 가지며 welcome 이미지와 별도로 설정됩니다.

## Greets

Greets는 누군가 참여할 때 **다른** 채널에 짧은 메시지를 게시합니다. 예를 들어 자기소개 채널에서의 유도.

각 greet 채널은 자체 메시지를 가지며, greets는 **몇 초 후 자동 삭제됩니다**(기본 5초, 최대 60, 또는 영구 유지하려면 0).

Greets는 `[User]`, `[ServerName]`, `[UsersCount]`를 지원합니다.

<Note>
  설정할 수 있는 greet 채널 수는 제한되며 등급에 따라 증가합니다.
</Note>

## 흔한 문제

<AccordionGroup>
  <Accordion title="누군가 참여해도 아무것도 게시되지 않아요">
    [Setup](/ko/server-management/setup) 페이지의 **Welcomer** 스위치를 확인한 뒤, 메시지 토글 자체가 켜져 있고 채널이 선택되었는지 확인하세요. 둘 다 기본으로 꺼져 있습니다.
  </Accordion>

  <Accordion title="변수가 메시지에 문자 그대로 나타나요">
    오타이거나 해당 메시지 유형에서 지원되지 않는 변수입니다. 변수는 대소문자를 구분하며 대괄호를 사용합니다. `[Server]`는 유효하지 않으므로 `[ServerName]`을 사용하세요.
  </Accordion>

  <Accordion title="임베드나 advanced 형식이 저장되지 않아요">
    둘 다 **Basic** 이상이 필요합니다. Starter에서는 일반 메시지 형식만 저장할 수 있습니다.
  </Accordion>

  <Accordion title="이미지가 나타나지 않아요">
    Vetox가 welcome 채널에서 **파일 첨부(Attach Files)** 권한을 가지고 있는지 확인하세요.
  </Accordion>
</AccordionGroup>