BuzzBuild-Coupon — 설치

서버 운영자가 Paper 기능을 설치하고, 필요한 플레이어에게 Fabric 입력 화면을 배포하는 절차입니다. 아래 경로는 서버 또는 게임 프로필 기준 상대 경로입니다.

설치할 파일

위치	구성
서버 `plugins/`	배포용 `BuzzBuild-Coupon-Paper-0.1.0.jar`와 호환되는 Framework Paper
클라이언트 프로필 `mods/`	배포용 `BuzzBuild-Coupon-Fabric-0.1.0.jar`, Framework Fabric, Fabric API

파일명은 Gradle 배포 산출물 설정 기준입니다. 소스·API 전용 JAR이나 shared 모듈을 별도 플러그인으로 설치하지 않습니다. Fabric 모드는 클라이언트 전용이므로 Paper의 plugins/에 넣지 않습니다.

지원 환경에 맞는 Minecraft 26.1.2·Java 25 환경을 준비합니다.
서버에 Framework를 먼저 설치하고, Framework의 database.enabled 및 MariaDB 연결을 구성합니다. Coupon은 자체 DB 연결 설정이나 파일 DB 대체 기능을 제공하지 않습니다.
금액 보상을 사용할 경우 Vault와 Economy 제공 플러그인을 함께 준비합니다. Vault API의 빌드 의존성은 1.7.1이며, 실제 제공 플러그인별 호환 버전은 확인이 필요합니다.
Nexo GUI 아이템을 사용할 경우 blank 또는 별도로 준비한 아이템 ID를 확인합니다. Nexo의 특정 지원 버전은 소스에 명시되어 있지 않습니다.

운영자가 정한 점검·적용 시간에 서버 plugins/에 배포 JAR을 배치합니다.
운영자가 서버를 정상 시작한 뒤 Coupon의 활성화 로그를 확인합니다. 이 문서 작성 과정에서는 서버를 실행하지 않았습니다.
plugins/BuzzBuild-Coupon/config.yml이 생성됩니다. 정상 초기화 흐름에서 gui.yml도 생성됩니다.
Framework 서비스와 DB가 준비되어 있으면 bb_coupon_coupons, bb_coupon_uses 테이블 생성 구문을 등록·적용합니다. DB가 준비되지 않으면 Coupon은 비활성화됩니다.
설정을 참고해 쿨다운·기본 한도·메시지를 조정합니다. DB 주소·계정은 Coupon 설정에 추가하지 않습니다.
관리자는 /bbcoupon help와 /bbcoupon list로 명령 등록을 확인합니다. 실제 생성·사용 시험은 사용법의 가상 코드 예시로 별도 수행합니다.

변경 대상	적용 방법
Coupon `config.yml`	`/bbcoupon reload`로 Coupon 설정 다시 읽기
Coupon `gui.yml`	GUI를 닫고 다시 열기. 화면을 열 때마다 파일을 읽음
기존 쿠폰 보상·활성 상태	관리자 명령이나 상자 GUI에서 저장
플러그인 JAR·필수 의존성·Framework DB 설정	운영자가 별도 적용 절차 결정. Coupon reload로 재초기화되지 않음

/bbcoupon reload는 서버 전체 reload가 아닙니다. DB 저장소·테이블·메시징 채널을 재생성하지 않으며 Vault Economy 재탐지도 하지 않습니다. 기본 한도 설정 변경은 기존 쿠폰의 한도를 수정하지 않습니다.

해당 Fabric 프로필에 필요한 모드를 설치한 뒤 서버에 접속해 /쿠폰을 입력합니다. 코드 입력란과 제출 버튼이 표시되도록 구현되어 있습니다. 화면이 필요 없으면 /쿠폰 EXAMPLE2026처럼 코드를 명령에 직접 전달할 수 있습니다.

2026-10-05 기준 배포 파일명 설정, 의존성 선언, 초기화 순서와 파일 로딩을 확인했습니다. 배포 JAR 실행·DB 연결·게임 내 동작은 미검증입니다.