BuzzBuild-OnAir — 문제 해결
아래는 구현에 근거한 점검 순서입니다. 게임 내 동작은 미검증이며 문제를 실제 재현했다는 의미는 아닙니다.
문제별 점검
섹션 제목: “문제별 점검”| 문제 | 확인 방법 | 해결·다음 조치 |
|---|---|---|
| 플러그인이 활성화되지 않음 | Framework 활성화 및 BuzzBuild-Framework messaging service is required 메시지 확인 | Framework Paper 배포본과 메시징 서비스, Minecraft·Java 버전 확인 |
| 명령어 실행 후 화면이 없음 | buzzbuild.onair.use, OnAir·Framework Fabric·Fabric API·MCEF Modern 설치 확인 | 양쪽 버전을 맞추고 다시 열기. 콘솔에서는 화면 열기 불가 |
| 모드 설치 확인 안내가 나옴 | 화면 열기 후 약 200틱 내 클라이언트 준비 응답 여부 확인 | 첫 MCEF 준비가 늦을 수 있으므로 준비 화면·로그 확인. 안내만으로 실패를 단정하지 않음 |
| 웹 화면 초기화 실패 또는 준비 중 정체 | 클라이언트 MCEF 로그와 구성 요소 다운로드 상태 확인 | 의존성·다운로드 환경 점검. 브라우저 객체 생성 전 180초 경과 시 실패 처리 코드가 있음 |
채널 미등록 | UUID, 플랫폼 소문자 키, enabled, 입력 형식 확인 | 화면 저장 또는 유효한 원시 ID로 파일 수정 후 OnAir 전용 리로드 |
| 저장 형식 오류 | 플랫폼별 입력 규칙 확인 | 허용된 채널 주소·ID 사용. 투네이션은 일반 후원 페이지 대신 알림창 정보 사용 |
| 연결정보 변경이 비활성화됨 | 연결됨·연결 중·응답 대기·해제 중인지 확인 | 먼저 연결 해제 후 완료를 기다리고 저장 |
| 저장하지 못했다는 메시지 | 설정 폴더 쓰기·임시 파일 생성·파일 교체 권한 확인 | 서버 운영 계정의 접근 권한과 저장 공간 점검 |
| 저장 응답 없음 또는 연속 클릭 무시 | 750ms 제한, 10초 저장 응답 대기, 세션 상태 확인 | 잠시 뒤 재시도. 지속되면 화면을 다시 열고 양쪽 배포본·메시징 확인 |
| 연결 요청 거부 | 이미 연결 중인지, max-connections가 찼는지 확인 | 사용하지 않는 연결 해제. 한도는 서버 전체 채널 슬롯 기준 |
WAITING 또는 ERROR | 방송 상태·채널 값·서버 외부 통신 확인 | 원인 수정 후 재연결. 미연결 슬롯은 시작 후 60초 초과 시 오류 정리 대상 |
| 리로드 후 모두 끊김 | OnAir 전용 리로드 실행 여부 확인 | 정상 구현 동작. 자동 연결 옵션과 관계없이 화면에서 재연결 |
| 화면을 닫아도 수신 계속 | 플랫폼 상태 확인 | 화면 닫기는 연결 종료가 아님. 해당 플랫폼의 연결 해제 사용 |
| 내역이 적거나 누락 표시 | 최근 20개 제한과 서버 수신 버퍼 초과 표시 확인 | 영구 기록으로 사용하지 않음. 채팅·후원 큐는 각각 2048개이며 초과 수는 서버 전체 누적값 |
| 투네이션 일반 채팅 없음 | 플랫폼이 투네이션인지 확인 | 일반 채팅 미지원. 후원 알림·메시지만 대상 |
| 테스트 후원이 Insight에 없음 | 테스트 표시 여부 확인 | 샘플은 이벤트를 발행하지 않음. 실제 성공·양수 후원의 연동을 별도로 검증 |
설정 변경과 재연결 순서는 설치, 권한과 별칭은 명령어·권한에서 확인하세요. 로그나 설정을 공유할 때 연결정보·알림창 키·개인 데이터를 제거하세요.
미지원 사항
섹션 제목: “미지원 사항”- 외부 채팅 보내기, 후원 보상 지급·명령어 실행, 영구 내역 저장·내보내기.
- YouTube를 OnAir 플랫폼으로 등록하는 기능.
- 방송 연결 자동 재접속.
auto-connect는 접속 시 연결 옵션이며 실패 후 재시도 옵션이 아닙니다. - GUI에서 추가 채널·자동 연결 옵션 편집, 다른 플레이어 연결 관리 명령어.
- 설정 화면에서 기존 저장 입력값 조회 또는 빈 값 저장으로 등록 해제. 연결 해제는 등록 삭제가 아닙니다.
- 독립적인 외부 웹 대시보드 배포 옵션. 화면은 클라이언트 내부 브라우저와 로컬 브리지를 사용합니다.
확인이 필요한 항목
섹션 제목: “확인이 필요한 항목”플랫폼별 실제 채팅·후원 수신, 브라우저 초기 다운로드와 한국어 입력·화면 표시, 서버·클라이언트 메시징 호환성, 복수 채널 상태, 접속·종료·권한 회수·세션 만료 처리, Insight 후원 통계를 실행 환경에서 확인해야 합니다. Folia 및 선언 버전 외 환경은 지원 검증을 하지 않았습니다.
확인 범위
섹션 제목: “확인 범위”2026-10-05 기준 오류 분기, 시간 제한, 연결 상태, 버퍼·이력 제한과 안내 코드를 확인했습니다. 서버 시작·중지·재시작·전체 리로드, 외부 플랫폼 접속 시험을 수행하지 않았습니다.