포인트 상점

상점 아이템 설정

상점 아이템 등록 (대시보드)

대시보드 → 포인트 상점 탭의 판매 아이템 카드에서 + 아이템 추가를 누르면 편집 창이 열립니다. 한 서버에 최대 20개까지 등록할 수 있고, 편집 창 맨 위에서 웹 상점에 보일 모습을 미리 볼 수 있습니다. 이미 있는 아이템은 같은 목록에서 수정 · 복제 · 삭제하고, 끌어 놓거나 ↑ ↓ 버튼으로 순서를 바꿉니다. Discord 명령어로는 아이템을 등록·수정할 수 없습니다.
항목설명필수
이름아이템 이름 (최대 50자)
가격판매 가격 (1 ~ 1,000,000,000 P)
설명웹 상점에 보이는 짧은 설명 (최대 200자)
아이콘 · 이미지웹 상점 썸네일 — 아이콘 36종 중 하나(고르지 않으면 이름에 맞춰 자동) 또는 직접 올린 이미지(PNG · JPG · GIF · WebP · BMP, 5MB, 권장 512 × 512 정사각형)
지급 역할구매 시 지급할 역할 (1~5개)
구매 제한「제한 없음」 또는 「횟수 제한」 — 횟수와 초기화 방식(매달 초기화 · 매년 초기화 · 마지막 구매 후 쿨타임)
쿨타임[마지막 구매 후 쿨타임일 때] 다시 살 수 있을 때까지의 기간 — 숫자 + 일마다 · 주마다 · 개월마다 · 년마다
역할 기간「영구」 또는 「기간제」(1~365일) — 기간제는 기간이 지나면 역할을 자동으로 회수

구매 제한 옵션

매달·매년 초기화는 달력 기준으로 리셋되는 방식이고, 쿨타임은 그 사람이 실제로 구매한 시점부터 기간을 세는 방식이라 서로 초기화 타이밍이 다릅니다. 쿨타임 단위는 일 · 주 · 개월 · 년 중 선택할 수 있어 「3일마다」부터 「2년마다」까지 세밀하게 조절할 수 있습니다. 편집 창의 구매 제한을 제한 없음으로 두면 어떤 쿨타임도 적용되지 않고 바로바로 재구매할 수 있습니다.
옵션초기화 시점활용 예시
매달 초기화달력 기준 — 다음달 1일 00:00 KSTVIP 역할 월 1회 구매 제한
매년 초기화달력 기준 — 다음해 1월 1일 00:00 KST연간 특별 역할 1회 제공
쿨타임 (일 · days)개인 기준 — 마지막 구매 시점으로부터 지정한 일수가 지나야 재구매 가능「출석 보상 역할」처럼 짧은 주기로 반복 판매
쿨타임 (주 · weeks)개인 기준 — 마지막 구매 시점으로부터 지정한 주 수가 지나야 재구매 가능「주간 이벤트 역할」 2주 주기 판매
쿨타임 (개월 · months)개인 기준 — 마지막 구매 시점으로부터 지정한 개월 수가 지나야 재구매 가능「분기 이벤트 역할」처럼 달력과 무관하게 3개월 주기로 판매
쿨타임 (년 · years)개인 기준 — 마지막 구매 시점으로부터 지정한 년 수가 지나야 재구매 가능「기념 역할」 1~2년 주기 한정 판매
제한 없음초기화 없음 (쿨타임 자체가 없음)영구 구매 가능 역할, 여러 번 반복 구매해도 되는 소모성 아이템

아이템 이미지 올리기

편집 창의 아이콘 · 이미지에서 내 이미지를 고르면 아이콘 대신 직접 올린 이미지를 웹 상점에 보여 줍니다. 이미지는 대시보드에서만 올릴 수 있습니다.
  • PNG · JPG(JPEG) · GIF · WebP · BMP를 한 장에 5MB까지 올릴 수 있고, 권장 해상도는 512 × 512 정사각형입니다. 칸에 끌어 놓거나 「파일 고르기」로 고르면 바로 올라갑니다.
  • 가로세로가 다르면 가운데를 기준으로 정사각형으로 잘라 256 × 256 WebP로 줄여 둡니다. 움직이는 GIF는 움직이는 그대로 줄이고, BMP도 그대로 받습니다.
  • 파일 내용으로 형식을 확인하므로 이름만 바꾼 파일 · 손상된 파일 · SVG는 받지 않습니다.
  • 올린 이미지는 해나봇 서버에 암호화(AES-256-GCM)해 보관하고, 웹 상점에서는 판매 중인 아이템의 이미지만 그 서버 상점을 볼 수 있는 사람에게 보여 줍니다.
  • 「아이콘」으로 바꾸거나 이미지를 빼면 다시 아이콘으로 보입니다. 어느 아이템 · 패널에도 쓰지 않는 이미지는 올린 때부터 12시간이 지나면 자동으로 지웁니다.

구매 순서

아이템 목록과 구매는 웹 상점에서만 합니다. 디스코드에는 /웹상점 패널생성으로 올린 안내 패널이 웹 상점으로 가는 문 역할을 합니다.
  1. 01
    아이템 등록
    대시보드 포인트 상점 탭에서 판매할 역할 아이템을 등록합니다. (최대 20개)
  2. 02
    패널 게시
    안내할 채널에서 /웹상점 패널생성을 실행하면 웹 상점 패널이 올라갑니다. 문구 · 색 · 그림은 대시보드에서 꾸밉니다.
  3. 03
    구매 확인
    멤버가 웹 상점에서 Discord 계정으로 로그인하고 구매 버튼을 누르면, 보유 포인트 · 가격 · 구매 후 잔액이 담긴 확인 창이 먼저 열립니다.
  4. 04
    역할 지급
    구매 완료 시 설정된 역할(최대 5개)이 즉시 자동으로 부여됩니다.

역할 묶음 판매 활용법 (최대 5개)

편집 창의 지급 역할에서 역할을 여러 개 고르면 하나의 아이템으로 최대 5개 역할을 한 번에 지급할 수 있습니다.
  • 세트 역할 — 「VIP」역할 + 「VIP 전용 채널 접근」역할을 묶어 한 번에 판매
  • 색상 + 칭호 — 색상 역할과 칭호 역할을 하나의 패키지로 구성
  • 권한 묶음 — 닉네임 변경 권한 역할 + 특별 이모티콘 역할 동시 지급

구매 확인창 동작 방식

웹 상점에서 구매 버튼을 누르면 바로 사지 않고 영수증 모양의 확인 창이 먼저 열립니다. 확인 창에는 다음 정보가 포함됩니다.
  • 아이템 이름 · 지급되는 역할 수 · 역할 기간
  • 보유 포인트 → 가격 → 구매 후 남는 포인트
  • 구매 / 취소 버튼 (구매 제한에 걸린 아이템은 처음부터 「구매 한도 도달」로 잠겨 있어 창이 열리지 않음)

구매 영수증 (DM)

웹 상점에서 구매가 끝나면 구매자에게 영수증 카드가 DM으로 전송됩니다. 영수증 이미지에는 결제한 포인트, 구매한 아이템, 지급된 역할, 구매 전 포인트 · 결제 · 남은 포인트 · 역할 기간(기간제면 만료일)이 담기고, 웹 상점으로 바로 가는 버튼이 함께 붙습니다.
  • 역할 일부를 지급하지 못했으면 영수증에 어떤 역할이 실패했는지 표시됩니다. 서버 관리자에게 영수증을 보여 주면 확인이 빠릅니다.
  • DM을 막아 두었으면 영수증만 전송되지 않을 뿐, 구매와 역할 지급은 그대로 처리됩니다.

한도 도달 시 안내

구매 한도에 도달한 아이템은 웹 상점에서 구매 버튼이 구매 한도 도달로 잠기고, 칩에 이번 주기에 산 횟수와 초기화 방식(예: 1/1회 · 매달 초기화)이 표시됩니다. 매달·매년 초기화 아이템은 다음 초기화 시점에, 쿨타임 아이템은 아래 방식으로 계산한 다음 구매 가능일에 다시 살 수 있습니다.

다음 구매 가능일 계산 방식

쿨타임 아이템의 다음 구매 가능일은 다음 공식으로 계산됩니다.

다음 구매 가능일 = 마지막 구매 시각 + (쿨타임기간 × 단위 환산일수)

단위별 환산일수는 아래와 같으며, days/weeks는 정확한 일수인 반면 months/years는 실제 달력의 월/년 길이(28~31일, 윤년 등)와 무관한 근사값을 사용합니다 — "매달 초기화"처럼 달력에 딱 맞춰 리셋되는 방식이 아니라, 구매한 시점 기준으로 정확히 그만큼의 시간이 지나야 하는 개인별 타이머이기 때문입니다.
쿨타임단위 값1단위당 환산일수예시 (쿨타임기간=3일 때)
days1일 (정확)마지막 구매 + 3일 후 재구매 가능
weeks7일 (정확)마지막 구매 + 21일 후 재구매 가능
months30일 (근사)마지막 구매 + 90일 후 재구매 가능
years365일 (근사)마지막 구매 + 1,095일 후 재구매 가능

아이템 설계 팁

  • 가격 균형 — 하루 채팅 활동으로 얻을 수 있는 포인트의 7~14일치를 아이템 가격으로 설정하면 적당한 목표감을 줄 수 있습니다.
  • 월정 역할 — 매달 초기화 + 구매제한 1회로 「이달의 서포터」같은 월정 역할을 만들 수 있습니다.
  • 짧은 주기 소모품 — 쿨타임을 「일」·「주」 단위로 짧게 설정하면 출석·주간 이벤트 보상처럼 자주 반복 구매하는 아이템을 만들 수 있습니다.
  • 분기·반기·연간 역할 — 쿨타임을 「개월」(예: 3개월, 6개월) 또는 「년」 단위로 설정 + 구매제한 1회로, 달력과 무관하게 「구매 시점 기준」으로 다음 구매 시점을 관리하고 싶을 때 사용하세요.
  • 반복 구매 소모품 — 쿨타임 없이 계속 구매 가능한 아이템은 편집 창의 구매 제한을 「제한 없음」으로 두세요.
  • 이름 명확히 — 아이템 이름은 「VIP」보다 「VIP 역할 (30일 유효)」처럼 구체적으로 쓰면 혼동을 줄일 수 있습니다.
  • 순서 정렬 — 대시보드 목록에서 끌어 놓거나 ↑ ↓ 버튼으로 순서를 바꾸면 웹 상점(등록순)이 그 순서를 따릅니다. 아이템이 2개 이상이면 웹 상점 맨 위 대표 아이템 자리에 가장 비싼 아이템이 크게 보입니다.
  • 역할 위치 확인 — 봇 역할이 지급할 역할보다 서버 역할 목록에서 위에 있어야 역할이 정상 지급됩니다.

웹 상점 패널 업데이트

대시보드에서 아이템을 저장하면 올라가 있는 웹 상점 패널의 장부 줄(아이템 수 · 가격 범위 · 대표 아이템)도 몇 초 안에 자동으로 갱신됩니다. 예전 /상점 열기로 올린 목록 패널은 다음에 상점을 저장할 때(또는 누가 그 패널의 구매 버튼을 누를 때) 그 자리에서 새 웹 상점 패널로 바뀝니다.

주의사항

  • 상점 아이템은 서버당 최대 20개까지 등록할 수 있습니다.
  • 아이템 제거 후 해당 아이템의 구매 기록은 삭제되지 않으며, 이미 지급된 역할도 자동으로 회수되지 않습니다.
  • 구매 제한은 구매 횟수를 제한할 뿐, 역할이 이미 있는 사람의 재구매를 자동으로 막지는 않습니다.
  • 설정한 역할 중 하나라도 지급에 실패하면 구매 완료 메시지와 영수증 DM에 실패한 역할이 표시되지만 포인트는 차감됩니다. 봇 역할 순서를 먼저 확인하세요.

관리 명령어

/웹상점 패널생성
관리자
현재 채널에 웹 상점 패널 게시 — 꾸미기는 대시보드에서, 서버마다 최근 5개까지 자동 갱신
/웹상점 로그 <채널>
관리자
웹 상점 구매 · 경험치 변환 기록을 카드로 남길 채널 지정
/웹상점 로그해제
관리자
웹 상점 기록 채널 해제