BuzzBuild-OnAir — 개요

BuzzBuild-OnAir는 플레이어별 방송 연결을 서버에서 관리하고, Fabric 클라이언트의 웹 화면으로 채팅과 후원을 보여주는 수신 전용 플러그인·모드입니다.

핵심 기능

기능	구현 범위
플랫폼 연결	치지직, SOOP, 씨미, 투네이션 연결·해제 및 상태 표시
연결정보 등록	자신의 정보를 화면에서 저장하거나 서버 YAML로 등록
수신 내역	채팅·후원 각각 최근 20개, 종류 필터와 이름·메시지 검색
복수 채널	`additional-inputs`로 같은 플랫폼의 추가 채널 연결
자동 연결	`auto-connect`를 켠 플랫폼을 접속 시 연결
관리자 테스트	실제 연결 없이 샘플 채팅·후원 표시
후원 이벤트	실제 수신 후원에 `OnAirDonationEvent` 발행; 테스트 표시는 제외

플랫폼 식별자	화면 이름	일반 채팅	후원
`CHZZK`	치지직	수신 경로 있음	수신 경로 있음
`SOOP`	SOOP	수신 경로 있음	수신 경로 있음
`CIME`	씨미	수신 경로 있음	수신 경로 있음
`TOONATION`	투네이션	미지원	알림·메시지 수신 경로 있음

채팅 전송, 후원 보상 지급·명령어 실행, 영구 후원 장부 기능은 없습니다. 내부 라이브러리에 YouTube 코드가 있지만 현재 OnAir의 선택·설정 대상으로 노출되지 않습니다. 실제 수신은 방송 상태와 외부 서비스에 따라 별도 확인해야 합니다.

실제 Gradle 및 메타데이터의 선언값이며 실행 호환성 시험 결과는 아닙니다.

항목	확인값
OnAir 버전	`0.1.0`
Minecraft	`26.1.2`
서버	Paper, 컴파일 API `26.1.2.build.69-stable`, `api-version: '26.1.2'`
Java	빌드 도구 체인 25, 클라이언트 선언 `>=25`
클라이언트	Fabric 전용, `environment: client`
Fabric Loader	빌드 `0.19.3`, 메타데이터 `>=0.19.3`
Fabric API	빌드 `0.155.2+26.1.2`, 메타데이터 필수
MCEF Modern	메타데이터 `>=0.3.2`; 컴파일 참조 JAR `0.3.2+mc26.1.jcef143.0.14`

Spigot·Folia·Forge·NeoForge 및 다른 Minecraft 버전의 호환성은 확인하지 않았습니다.

서버에는 BuzzBuild-Framework가 필수입니다. PaperMessagingBus 서비스가 없으면 OnAir가 비활성화됩니다.
클라이언트에는 OnAir Fabric 모드, Framework Fabric 모드, Fabric API, MCEF Modern이 필요합니다. MCEF는 선택 의존성이 아닙니다.
BuzzBuild-Insight는 선택적 연동 대상입니다. Insight에서 후원 이벤트 중 SUCCESS이면서 금액이 양수인 이벤트를 통계에 반영하는 코드가 있습니다. OnAir 사용 자체에는 필요하지 않습니다.
OnAir 자체의 DB 접속 설정이나 별도 DB 의존성은 없습니다.

설치 → 명령어·권한 → 설정 → 사용법. 문제가 생기면 문제 해결을 확인하세요.

2026-10-05 기준 빌드 선언, 메타데이터, 서버·클라이언트 코드, 웹 리소스와 Framework·Insight 연동 코드를 확인했습니다. 게임 내 동작은 미검증이며 외부 방송 서비스 접속도 시험하지 않았습니다.