BuzzBuild-Coupon — 개요

BuzzBuild-Coupon은 서버에서 쿠폰 코드와 보상을 관리하고, 플레이어가 명령어나 Fabric 입력 화면으로 쿠폰을 사용하는 기능입니다. 운영자는 Paper의 상자 GUI에서 아이템 보상과 활성 상태를 편집할 수 있습니다.

핵심 기능

코드별 전체·개인 사용 한도, 만료 시각, 활성·비활성 상태와 사용 기록을 관리합니다.
아이템, 콘솔 명령어, Vault 입금, 채팅 메시지 보상을 지원합니다.
/쿠폰 <코드>로 사용하며, /쿠폰은 Fabric 입력 화면을 요청합니다.
/bbcoupon은 목록 GUI를 엽니다. 보상 상자를 닫거나 목록으로 돌아가면 아이템 보상을 저장합니다.
Framework의 MariaDB 연결과 메시징 버스를 사용합니다. 사용 기록을 먼저 확정한 뒤 보상을 지급하며, 일부 지급 실패 시에도 사용 기록은 남습니다.

난수·배치 생성과 손 아이템 복사 기능은 Fabric 생성 화면 및 서버 요청 처리 코드에 있습니다. 그러나 이 플러그인의 기본 명령어에서 해당 생성 화면을 여는 경로는 확인되지 않았습니다. 사용법에서 일반 운영 절차와 확인 필요 기능을 구분합니다.

아래는 실제 Gradle·메타데이터의 대상이며, 호환성 시험 결과가 아닙니다.

항목	확인한 값
플러그인 버전	`0.1.0`
Minecraft	`26.1.2`
서버	Paper API `26.1.2.build.69-stable`, `api-version: '26.1.2'`
Java	컴파일·도구 체인 `25`, Fabric 메타데이터 `>=25`
클라이언트	Fabric 전용, `environment: client`
Fabric Loader	빌드 `0.19.3`, 메타데이터 `>=0.19.3`
Fabric API	빌드 `0.155.2+26.1.2`, 메타데이터는 버전 제한 `*`

다른 Minecraft 버전, Spigot·Folia·Forge·NeoForge 지원은 확인되지 않았습니다.

구성	필수·선택	용도
서버의 BuzzBuild-Framework	필수	DB 연결, 테이블 등록, 메시징, 기능 서비스 등록
Framework의 MariaDB	필수	`database.enabled=true` 및 정상 연결 필요. 준비되지 않으면 Coupon 비활성화
Vault와 Economy 제공 플러그인	선택	금액 보상을 쓰려면 둘 다 필요
Nexo	선택	GUI 하단 아이템. 없거나 조회 실패 시 기본 Material로 대체
Fabric Loader·Fabric API·Framework Fabric·Coupon Fabric	입력 화면 사용 시 필수	서버의 화면 열기 요청 수신과 쿠폰 입력

직접 코드 명령과 Paper 관리 상자 GUI에는 Coupon Fabric 화면 코드가 관여하지 않습니다. 클라이언트 모드가 없는 환경의 실제 접속·사용 시험은 하지 않았습니다. ItemsAdder 전용 연동은 없습니다.

2026-10-05 기준 Gradle, 메타데이터, 명령어, 권한 검사, 기본 설정, DB 처리, GUI 이벤트 및 Framework 메시징 송수신 코드를 정적으로 확인했습니다. 게임 내 동작은 미검증입니다.