BuzzBuild-Coupon — 문제 해결
먼저 지원 환경과 설정을 확인합니다. 실제 연결 정보나 플레이어 사용 기록을 공개 문서·채팅에 그대로 공유하지 않습니다.
초기화와 화면
섹션 제목: “초기화와 화면”| 문제 | 확인 방법 | 해결·다음 조치 |
|---|---|---|
| Coupon 비활성화 | Framework 서비스 누락 또는 MariaDB 준비 실패 로그 확인 | Framework 선행 로딩과 database.enabled, 연결·테이블 생성 권한을 점검. Coupon 전용 DB 키를 추가하지 않음 |
/쿠폰으로 화면이 안 열림 | Coupon/Framework Fabric, Fabric API, 서버 Framework 메시징과 버전 확인 | 필요한 모드를 같은 프로필에 설치. 직접 /쿠폰 EXAMPLE2026으로 기능을 구분해 점검 |
| 화면이 처리 중에서 멈춤 | 클라이언트 채널 누락 경고와 서버 예외 로그 확인 | 응답 타임아웃 복구 코드는 없음. 화면을 닫고 원인 해결 후 다시 열기 |
/bbcoupon create가 Fabric 생성 화면을 안 엶 | 명령 문법 확인 | 정상 구현은 CLI 생성 후 Paper 보상 상자 열기. Fabric 생성 화면 진입점은 확인 필요 |
| Esc 메뉴 쿠폰 버튼이 동작하지 않음 | 메뉴가 쿠폰입력을 호출하는지 확인 | Coupon 등록 명령은 쿠폰. 메뉴 연동은 해당 플러그인 담당자에게 수정 요청 |
| 권한 없음 | buzzbuild.coupon.use 또는 buzzbuild.coupon.admin 확인 | 사용·관리 역할에 맞게 설정. 콘솔에서 /쿠폰, reward는 실행 불가 |
| Nexo 장식이 일반 유리판으로 보임 | Nexo 활성 여부, nexo.blank-item-id 확인 | 아이템 조회 실패 시 대체 Material을 사용하는 정상 대체 동작 |
| 글리프 태그가 기대와 다름 | gui.yml 제목과 Nexo 리소스 확인 | Coupon의 텍스트 파서에는 Nexo 전용 글리프 resolver가 없음. 태그 렌더링은 별도 검증 필요 |
| GUI 슬롯·버튼이 겹침 | 행 수와 내용/버튼 슬롯 범위 확인 | 기본 레이아웃으로 복구하고 다시 열기. 보상 내용 영역은 0~26 고정 |
| 다음 페이지가 비어 있음 | 이전 페이지로 이동 | 마지막 페이지 제한 없이 다음으로 이동하는 구현 |
코드와 보상
섹션 제목: “코드와 보상”| 문제 | 확인 방법 | 해결·다음 조치 |
|---|---|---|
| 존재하지 않는 쿠폰 | info <코드>와 정규화 설정 확인 | 오타·공백·정규화 변경 이력을 확인. 기존 DB 코드가 자동 변환되지는 않음 |
| 생성 실패·중복 | 같은 정규화 코드가 있는지 확인 | 다른 코드 사용. 기본 설정에서 공백·대소문자 차이만 있는 코드는 같은 값 |
| 만료됨 | info의 만료 시각과 서버 시각 확인 | CLI -expire 0은 무기한이 아님. 무기한은 생성 옵션 생략. 기존 만료 수정 명령 없음 |
| 비활성화됨 | info의 활성 상태 확인 | 관리자가 적절한 코드에 enable 실행 |
| 전체·개인 한도 초과 | info, uses 조회 | 해당 한도 소진 여부 확인. 한도 수정·사용 기록 초기화 명령 없음 |
| 너무 빠른 시도 | redeem.cooldown-seconds 확인 | 설정된 시간 후 재시도. 기본 3초 |
| 사용됐으나 보상 일부 실패 | 사용 기록과 vault 보상 스킵, 입금 실패, 아이템 역직렬화 로그 확인 | 실패 원인 해결 후 운영자가 보상 내역 대조·보정 결정. 자동 롤백·재지급 없음 |
| Vault 설치 후에도 보상 미연동 | Economy 제공 여부와 시작 로그 확인 | reload는 Vault 재탐지 안 함. 의존성 적용은 운영자 점검 절차로 진행 |
| 인벤토리에 보상이 없음 | 인벤토리 여유와 플레이어 주변 드롭 확인 | 공간 확보. 넘친 아이템을 바닥에 드롭하며 우편 보관하지 않음 |
| 명령 보상 실패인데 성공 표시 | 저장된 명령과 해당 명령의 실행 로그 확인 | 콘솔 문법과 {player}/{uuid} 확인. dispatchCommand 반환값을 검사하지 않아 모든 실패를 감지하지 못함 |
| 생성 옵션 일부가 보상 문구가 됨 | -cmd/-msg 뒤의 문자열 확인 | 나머지 전체가 보상으로 저장되므로 두 옵션 중 하나를 마지막에 배치 |
| 설정 변경이 기존 쿠폰에 반영되지 않음 | 설정 기본값과 DB 저장값 구분 | defaults.*는 신규 CLI 생성 기본값. 기존 쿠폰 데이터 자동 갱신 없음 |
| 빈 메시지 설정에도 오류 문구가 나옴 | 실패 종류 확인 | 일부 조회 실패는 빈 설정이면 저장소 기본 오류 문구로 돌아감. 모든 메시지 숨김은 보장 안 됨 |
미지원 및 확인 필요
섹션 제목: “미지원 및 확인 필요”- 삭제·기록 초기화·기존 한도/만료/메모 편집·명령/메시지 보상 전용 수정 명령은 없습니다.
- 파일 DB 대체, 오프라인 대상 쿠폰 사용 명령, 우편 지급, 실패 보상 자동 복구는 구현되어 있지 않습니다.
- ItemsAdder 전용 연동과 Folia 지원 선언은 없습니다. Paper 외 서버·다른 게임 버전은 미검증입니다.
set.content-slots.start/end는 기본 리소스에 있지만 보상 GUI 구현이 읽지 않습니다.limits.max-item-rewards를 27보다 늘려도 상자 편집 영역은 늘지 않습니다.- 정규화를 끄면 코드에서 대소문자 변환은 중단되지만, DB 문자열 비교의 실제 대소문자 구분은 DB collation에 따라 달라질 수 있습니다. 테이블 생성문에 collation을 고정하지 않습니다.
- 명령 권한은 메타데이터로 검사하지만, Fabric 사용 요청의 서버 처리에는 사용 권한 재검사가 없습니다. 관리자 GUI가 열린 뒤 권한을 회수한 상황도 재검증이 필요합니다.
- DB 작업은 명령·메시징 처리와 GUI 이벤트에서 동기 호출됩니다. 대량 데이터·DB 지연에 따른 서버 영향과 동시 편집은 부하 시험이 필요합니다.
확인 범위
섹션 제목: “확인 범위”2026-10-05 기준 오류 분기와 기본 메시지를 정적으로 확인했습니다. 서버·DB·Vault·Nexo 실환경 및 게임 내 동작은 미검증입니다. 전체 reload, 시작·중지·재시작은 이 작업에서 실행하지 않았습니다.