상점 아이템 설정
상점 아이템 추가
/상점 추가 명령어로 판매할 역할 아이템을 등록합니다. 한 서버에 최대 9개까지 등록 가능합니다.| 옵션 | 설명 | 필수 |
|---|---|---|
| 이름 | 아이템 이름 (최대 50자) | ✅ |
| 가격 | 판매 가격 (포인트) | ✅ |
| 역할1 | 구매 시 지급할 첫 번째 역할 | ✅ |
| 역할2~역할5 | 추가로 같이 지급할 역할 (최대 4개 더, 총 5개) | ❌ |
| 구매제한 | 초기화 주기당 최대 구매 횟수 (0=무제한) | ❌ |
| 초기화 | 구매 횟수 초기화 방식 (매달/매년/쿨타임/없음) | ❌ |
| 쿨타임단위 | [초기화=쿨타임 선택 시] 기간 단위 — 일(days) / 주(weeks) / 개월(months) / 년(years) | ❌ |
| 쿨타임기간 | [초기화=쿨타임 선택 시] 마지막 구매 후 재구매까지 대기할 기간 (단위 기준, 기본 1) | ❌ |
구매 제한 옵션
매달·매년 초기화는 달력 기준으로 리셋되는 방식이고, 쿨타임은 그 사람이 실제로 구매한 시점부터 기간을 세는 방식이라 서로 초기화 타이밍이 다릅니다. 쿨타임 단위는 일 · 주 · 개월 · 년 중 선택할 수 있어 「3일마다」부터 「2년마다」까지 세밀하게 조절할 수 있습니다.
구매제한을 0(무제한)으로 두거나 초기화를 제한 없음으로 선택하면 어떤 쿨타임도 적용되지 않고 바로바로 재구매할 수 있습니다.| 옵션 | 초기화 시점 | 활용 예시 |
|---|---|---|
| 매달 초기화 | 달력 기준 — 다음달 1일 00:00 KST | VIP 역할 월 1회 구매 제한 |
| 매년 초기화 | 달력 기준 — 다음해 1월 1일 00:00 KST | 연간 특별 역할 1회 제공 |
| 쿨타임 (일 · days) | 개인 기준 — 마지막 구매 시점으로부터 지정한 일수가 지나야 재구매 가능 | 「출석 보상 역할」처럼 짧은 주기로 반복 판매 |
| 쿨타임 (주 · weeks) | 개인 기준 — 마지막 구매 시점으로부터 지정한 주 수가 지나야 재구매 가능 | 「주간 이벤트 역할」 2주 주기 판매 |
| 쿨타임 (개월 · months) | 개인 기준 — 마지막 구매 시점으로부터 지정한 개월 수가 지나야 재구매 가능 | 「분기 이벤트 역할」처럼 달력과 무관하게 3개월 주기로 판매 |
| 쿨타임 (년 · years) | 개인 기준 — 마지막 구매 시점으로부터 지정한 년 수가 지나야 재구매 가능 | 「기념 역할」 1~2년 주기 한정 판매 |
| 제한 없음 | 초기화 없음 (쿨타임 자체가 없음) | 영구 구매 가능 역할, 여러 번 반복 구매해도 되는 소모성 아이템 |
상점 패널 게시
/상점 열기 명령어를 사용하면 현재 채널에 아이템 목록과 구매 버튼이 담긴 패널 임베드가 게시됩니다. 구매 버튼은 클릭한 사람에게만 보이는 확인창을 표시합니다.01
아이템 등록
/상점 추가 로 판매할 역할을 등록합니다. (최대 9개)02
패널 게시
상점 채널에서
/상점 열기 를 실행하면 구매 버튼 패널이 게시됩니다.03
구매 확인
멤버가 구매 버튼을 클릭하면 본인에게만 보이는 확인창이 표시됩니다. 가격·보유 포인트·구매 제한을 확인 후 구매합니다.
04
역할 지급
구매 완료 시 설정된 역할(최대 5개)이 즉시 자동으로 부여됩니다.
역할 묶음 판매 활용법 (최대 5개)
역할1~역할5를 함께 설정하면 하나의 아이템으로 최대 5개 역할을 한 번에 지급할 수 있습니다.
- 세트 역할 — 「VIP」역할 + 「VIP 전용 채널 접근」역할을 묶어 한 번에 판매
- 색상 + 칭호 — 색상 역할과 칭호 역할을 하나의 패키지로 구성
- 권한 묶음 — 닉네임 변경 권한 역할 + 특별 이모티콘 역할 동시 지급
구매 확인창 동작 방식
구매 버튼을 클릭하면 본인에게만 보이는 확인창이 표시됩니다. 확인창에는 다음 정보가 포함됩니다.
- 지급될 역할 목록
- 아이템 가격과 구매 후 남는 잔액 미리보기
- 이번 주기 남은 구매 가능 횟수 (제한 설정 시)
- 구매 확인 / 취소 버튼
한도 도달 시 안내
구매 제한에 걸린 아이템을 다시 구매하려 하면 안내 메시지가 표시됩니다. 매달·매년 초기화 아이템은 다음 초기화 시점을 안내하고, 쿨타임 아이템은 실제 다음 구매 가능일(YYYY.MM.DD, KST)을 계산해 함께 보여줍니다.
다음 구매 가능일 계산 방식
쿨타임 아이템의 다음 구매 가능일은 다음 공식으로 계산됩니다.
단위별 환산일수는 아래와 같으며,
다음 구매 가능일 = 마지막 구매 시각 + (쿨타임기간 × 단위 환산일수)단위별 환산일수는 아래와 같으며,
days/weeks는 정확한 일수인 반면 months/years는 실제 달력의 월/년 길이(28~31일, 윤년 등)와 무관한 근사값을 사용합니다 — "매달 초기화"처럼 달력에 딱 맞춰 리셋되는 방식이 아니라, 구매한 시점 기준으로 정확히 그만큼의 시간이 지나야 하는 개인별 타이머이기 때문입니다.| 쿨타임단위 값 | 1단위당 환산일수 | 예시 (쿨타임기간=3일 때) |
|---|---|---|
| days | 1일 (정확) | 마지막 구매 + 3일 후 재구매 가능 |
| weeks | 7일 (정확) | 마지막 구매 + 21일 후 재구매 가능 |
| months | 30일 (근사) | 마지막 구매 + 90일 후 재구매 가능 |
| years | 365일 (근사) | 마지막 구매 + 1,095일 후 재구매 가능 |
아이템 설계 팁
- 가격 균형 — 하루 채팅 활동으로 얻을 수 있는 포인트의 7~14일치를 아이템 가격으로 설정하면 적당한 목표감을 줄 수 있습니다.
- 월정 역할 — 매달 초기화 + 구매제한 1회로 「이달의 서포터」같은 월정 역할을 만들 수 있습니다.
- 짧은 주기 소모품 — 쿨타임을 「일」·「주」 단위로 짧게 설정하면 출석·주간 이벤트 보상처럼 자주 반복 구매하는 아이템을 만들 수 있습니다.
- 분기·반기·연간 역할 — 쿨타임을 「개월」(예: 3개월, 6개월) 또는 「년」 단위로 설정 + 구매제한 1회로, 달력과 무관하게 「구매 시점 기준」으로 다음 구매 시점을 관리하고 싶을 때 사용하세요.
- 반복 구매 소모품 — 쿨타임 없이 계속 구매 가능한 아이템은
구매제한을 0으로 두거나초기화를 「제한 없음」으로 선택하세요. - 이름 명확히 — 아이템 이름은 「VIP」보다 「VIP 역할 (30일 유효)」처럼 구체적으로 쓰면 혼동을 줄일 수 있습니다.
- 순서 정렬 — /상점 목록에서 번호순으로 표시되므로, 인기 있는 아이템을 1번으로 등록하세요.
- 역할 위치 확인 — 봇 역할이 지급할 역할보다 서버 역할 목록에서 위에 있어야 역할이 정상 지급됩니다.
상점 패널 업데이트
아이템을 추가·제거한 후 반드시
/상점 열기를 다시 실행해야 패널에 반영됩니다. 이전 패널 메시지는 자동으로 삭제되고 새 패널이 게시됩니다.주의사항
- 상점 아이템은 서버당 최대 9개까지 등록할 수 있습니다.
- 아이템 제거 후 해당 아이템의 구매 기록은 삭제되지 않으며, 이미 지급된 역할도 자동으로 회수되지 않습니다.
- 구매 제한은 구매 횟수를 제한할 뿐, 역할이 이미 있는 사람의 재구매를 자동으로 막지는 않습니다.
- 설정한 역할 중 하나라도 지급에 실패하면 구매 완료 메시지에 오류 안내가 표시되지만 포인트는 차감됩니다. 봇 역할 순서를 먼저 확인하세요.
관리 명령어
>_
/상점 추가아이템 등록 (이름/가격/역할/구매제한/초기화/쿨타임단위/쿨타임기간 설정)
>_
/상점 제거 <번호>등록된 아이템 제거
>_
/상점 목록현재 등록된 아이템 전체 확인
>_
/상점 열기현재 채널에 상점 패널 게시 (기존 패널 자동 삭제)