BuzzBuild-Coupon — 명령어·권한

<값>은 필수 인자이고 [값]은 선택 인자입니다. 서버 콘솔에서는 맨 앞 /를 생략합니다.

명령어와 권한

명령어	권한 노드	기본 허용	콘솔
`/쿠폰 [코드]`	`buzzbuild.coupon.use`	`true` — 일반 플레이어 포함	불가
`/bbcoupon [하위 명령]`	`buzzbuild.coupon.admin`	`op` — 기본 OP 허용	하위 명령별 상이

최상위 명령 별칭은 선언되어 있지 않습니다. /coupon, /쿠폰입력은 이 플러그인의 등록 명령이 아닙니다. 권한은 plugin.yml의 명령 permission으로 적용됩니다. Fabric의 create, hand_item 요청은 서버에서 관리자 권한을 추가 검사하지만, open, redeem 처리에는 사용 권한 재검사가 없습니다. 따라서 사용 권한만으로 모든 메시징 요청을 제한한다고 보장할 수 없습니다.

플레이어 명령

문법	동작	예시
`/쿠폰`	Fabric 쿠폰 입력 화면 열기 요청	`/쿠폰`
`/쿠폰 <코드>`	전달된 인자를 공백으로 합친 뒤 쿠폰 사용 처리	`/쿠폰 EXAMPLE2026`

기본 정규화는 공백 제거·대문자 변환입니다. 예를 들어 example 2026은 EXAMPLE2026으로 조회됩니다. 자동 완성에 쿠폰 코드는 표시하지 않습니다.

관리자 하위 명령

모두 buzzbuild.coupon.admin 권한을 사용합니다.

문법	하위 명령 별칭	동작	콘솔
`/bbcoupon`	없음	플레이어: 목록 GUI, 콘솔: 도움말	가능
`/bbcoupon list`	`목록`, `gui`	플레이어: 목록 GUI, 콘솔: 최신 최대 50개 출력	가능
`/bbcoupon create <코드> [옵션]`	`생성`	쿠폰 생성. 플레이어는 생성 후 보상 상자 열기	가능
`/bbcoupon reward <코드>`	`보상`	기존 쿠폰의 아이템 보상 상자 열기	불가
`/bbcoupon vault <코드> <금액>`	`금액`	기존 Vault 보상을 교체. `0`이면 제거	가능
`/bbcoupon enable <코드>`	`활성화`	쿠폰 활성화	가능
`/bbcoupon disable <코드>`	`비활성화`	쿠폰 비활성화	가능
`/bbcoupon info <코드>`	`정보`	한도·만료·사용 수·메모·보상 JSON 조회	가능
`/bbcoupon uses <코드>`	`사용`	최근 사용 기록 최대 30개 조회	가능
`/bbcoupon reload`	`리로드`	Coupon `config.yml` 다시 읽기	가능
`/bbcoupon help`	`도움말`	도움말 출력	가능

영문 하위 명령은 대소문자를 구분하지 않습니다. 자동 완성은 첫 하위 인자의 영문 이름만 제안합니다. 기록에는 플레이어 이름·UUID·사용 시각이 포함되므로 공개 채널에 원문을 게시하지 않습니다. 표시 시각은 서버 시스템 시간대 기준입니다.

생성 옵션

옵션	타입·기본값	동작
`-max N`	정수, `defaults.max-uses` 기본 `1`	쿠폰 전체 사용 한도. `0`은 무제한
`-per N`	정수, `defaults.per-player` 기본 `1`	플레이어 UUID별 사용 한도. `0`은 무제한
`-expire 시간`	정수, 생략 시 만료 없음	생성 시점에서 지정 시간 후 만료
`-memo 값`	문자열, 생략 시 없음	다음 인자 한 개만 메모로 저장
`-vault N`	실수, 생략 시 없음	Vault 입금 보상 추가
`-cmd 명령어…`	문자열, 생략 시 없음	남은 인자 전체를 콘솔 명령 보상으로 저장
`-msg 문구…`	문자열, 생략 시 없음	남은 인자 전체를 메시지 보상으로 저장

-cmd 또는 -msg를 만나면 이후 옵션 해석을 끝냅니다. 반드시 마지막에 배치하며 두 옵션을 같은 CLI 생성 명령에 함께 넣지 않습니다. 따옴표를 묶음 인자로 해석하는 별도 파서는 없으므로 -memo에는 공백 없는 값을 사용합니다.

CLI -expire 0은 생성 시점, 음수는 과거 시점으로 저장되므로 만료 없음은 옵션을 생략합니다. 생성 한도 음수는 저장 시 0으로 보정됩니다. 유한한 0 이상의 한도와 금액, 양수 만료 시간을 명시하는 것이 의도 확인에 적합합니다.

명령 보상에는 선행 / 없이 명령을 넣으며 {player}와 {uuid}를 수령자 값으로 치환합니다. 보상 옵션이 없으면 defaults.fallback-message-reward의 메시지 보상이 추가됩니다.

/bbcoupon create EXAMPLE2026 -max 100 -per 1 -expire 168 -memo example_event -msg 예시 이벤트 보상입니다!
/bbcoupon create EXAMPLEITEM -max 10 -per 1 -cmd give {player} minecraft:diamond 1
/bbcoupon reward EXAMPLE2026
/bbcoupon vault EXAMPLE2026 1000
/bbcoupon info EXAMPLE2026
/bbcoupon uses EXAMPLE2026
/bbcoupon disable EXAMPLE2026
/bbcoupon enable EXAMPLE2026

쿠폰 삭제, 사용 기록 초기화, 기존 한도·만료·메모 수정, CLI 난수·배치 생성은 별도 명령어가 없습니다.

확인 범위

2026-10-05 기준 명령 메타데이터, 실행 분기, 옵션 파서, 자동 완성, 서버 요청 권한 검사를 확인했습니다. 게임 내 동작은 미검증입니다.