BuzzBuild-Coupon — 사용법

아래 코드는 실제 배포 코드가 아닌 가상 예시입니다. 명령 문법은 명령어·권한을 참고하세요.

메시지·아이템 쿠폰 만들기

관리자 플레이어가 다음 명령으로 전체 100회, 개인 1회, 168시간 유효 쿠폰을 생성합니다.
```
/bbcoupon create EXAMPLE2026 -max 100 -per 1 -expire 168 -msg 예시 이벤트 보상입니다!
```
생성 성공 시 아이템 보상 상자가 열립니다. 상단 0~26번 슬롯에 보상 아이템을 배치합니다.
상자를 닫거나 하단 목록으로 버튼을 누르면 저장됩니다. 별도 취소 저장 버튼은 없습니다. 편집 중 아이템은 일반 인벤토리 이동을 사용하며, 넣은 원본을 자동 반환하는 처리는 없습니다.
/bbcoupon reward EXAMPLE2026으로 다시 열어 저장된 아이템을 확인합니다. 기존 command, vault, message 보상은 유지하고 item 보상만 교체합니다.
/bbcoupon info EXAMPLE2026으로 활성 상태·한도·만료·보상을 확인합니다. 생성 직후부터 활성 상태이므로 보상 준비 중에는 /bbcoupon disable EXAMPLE2026으로 닫고, 준비 후 enable로 배포합니다.

편집기는 아이템 보상 정의를 저장하는 관리 도구입니다. 저장된 보상 아이템이 상자에 다시 구성되므로 일반 플레이어에게 관리자 권한을 주지 않습니다. 동시에 여러 관리자가 같은 코드를 편집하는 충돌 처리는 확인되지 않았습니다.

목록에서 관리하기

/bbcoupon 또는 /bbcoupon list로 목록을 엽니다. 기본 한 페이지는 45개이며 생성 순서의 역순입니다.

쿠폰 아이콘 조작	처리
좌클릭	정보 채팅 출력
Shift+좌클릭	아이템 보상 편집기
Shift+우클릭	Vault 금액 채팅 입력 시작
우클릭	활성·비활성 전환

하단 이전·다음 버튼으로 이동합니다. 다음 페이지는 마지막 페이지에서 자동 차단하지 않으므로 빈 페이지가 표시될 수 있습니다.

Vault 금액 추가·제거

Vault와 Economy 제공 플러그인이 연동되고 integrations.vault-rewards: true인지 확인합니다.
목록의 쿠폰을 Shift+우클릭하고 채팅에 1000을 입력합니다. 대기 중 채팅은 일반 채팅 전송을 취소하고 금액 입력으로 처리합니다.
0을 입력하면 Vault 보상을 제거합니다. cancel, 취소 또는 웅크리기로 입력을 취소할 수 있습니다. 접속 종료 시 입력 세션을 정리합니다.
명령으로도 /bbcoupon vault EXAMPLE2026 1000 또는 /bbcoupon vault EXAMPLE2026 0을 사용할 수 있습니다. 쉼표가 있는 금액도 이 설정 명령과 채팅 입력에서 처리합니다.

플레이어가 쿠폰 사용하기

/쿠폰 EXAMPLE2026을 입력합니다. Fabric 입력 화면이 준비된 환경에서는 /쿠폰으로 열고 코드를 입력한 뒤 Enter 또는 제출 버튼을 누를 수 있습니다.
서버가 정규화·쿨다운·활성 상태·만료·전체 한도·개인 한도를 확인합니다. 기본 쿨다운은 플레이어당 3초이며, 존재하지 않는 코드 등 실패한 조회도 쿨다운에 영향을 줍니다.
조건을 통과하면 DB에 사용 기록을 확정한 뒤 보상을 지급합니다. 인벤토리에 들어가지 않은 아이템은 플레이어 위치에 드롭합니다.
관리자는 /bbcoupon uses EXAMPLE2026으로 최근 사용 기록을 확인합니다.

보상 일부 실패도 사용 완료로 처리되며 자동 취소·재지급되지 않습니다. Vault 비활성화·미연동도 여기에 해당합니다. 재입력만으로 복구하려 하지 말고 사용 기록과 보상 로그를 대조합니다. 부분 실패도 성공 상태 응답을 보내므로 Fabric 입력란이 비워지고 성공 사운드가 호출될 수 있습니다.

구현되어 있으나 진입 경로 확인이 필요한 기능

Fabric 생성 화면에는 코드 미입력 시 난수 생성, 배치 생성, 재료 검색, 손 아이템 스냅샷 추가가 있습니다. 서버는 admin_open을 보낼 수 있고 클라이언트는 이를 받으면 생성 화면을 엽니다. 하지만 Coupon의 기본 명령어에는 이 호출을 연결한 분기가 없습니다. /bbcoupon create는 채팅 인자로 생성한 뒤 Paper 상자를 엽니다.

따라서 Fabric 생성 화면의 실행 절차와 외부 진입점은 별도 연동 확인이 필요합니다. 클라이언트에는 배치 50개·아이템 27개 상한과 한도 초깃값 1이 고정되어 있으며, 서버 설정을 높여도 자동 반영되지 않습니다. 이 화면 경로의 만료 시간은 비어 있거나 0 이하이면 만료 없음으로 처리되어 CLI와 다릅니다.

BuzzBuild-Esc의 기본 메뉴에는 쿠폰입력 호출이 남아 있으나 Coupon은 해당 명령을 등록하지 않습니다. 해당 메뉴와의 연결은 검증된 사용 경로가 아닙니다.

확인 범위

2026-10-05 기준 명령·GUI 클릭/드래그/닫기·채팅/웅크리기/접속 종료 이벤트, 보상 저장 및 지급 코드를 확인했습니다. 게임 내 동작은 미검증입니다.