BuzzBuild-OnAir — 설치

서버 관리자와 대시보드를 사용하는 플레이어가 각각 설치해야 합니다. 지원 환경의 선언 버전을 먼저 확인하세요.

파일 배치

대상	설치 위치	필요한 파일
Paper 서버	서버 루트의 `plugins/`	`BuzzBuild-OnAir-Paper-0.1.0.jar`, Framework Paper 배포 JAR
Fabric 클라이언트	게임 인스턴스의 `mods/`	`BuzzBuild-OnAir-Fabric-0.1.0.jar`, Framework Fabric 모드, Fabric API, MCEF Modern
서버 설정	`plugins/BuzzBuild-OnAir/config.yml`	최초 활성화 시 기본 리소스로 생성

JAR 이름은 현재 Gradle 산출물 명명 규칙 기준입니다. shared·core·platforms 라이브러리나 소스 JAR를 개별 플러그인으로 설치하지 않습니다. MCEF와 Framework는 OnAir에 포함되어 설치되는 의존성이 아닙니다.

관리자가 정한 서버 점검 절차에서 서버 JAR와 Framework를 배치하고, 사용자가 클라이언트 필수 모드를 설치합니다.
관리자가 서버를 정상 기동한 뒤 OnAir 활성화와 config.yml 생성을 확인합니다. Framework 메시징 서비스가 없으면 OnAir가 비활성화됩니다.
플레이어가 접속해 /방송연동을 실행합니다. 최초 웹 화면 준비에는 MCEF 브라우저 구성 요소 준비 시간이 필요할 수 있습니다.
플랫폼을 선택하고 연결정보 설정에서 자신의 채널을 등록합니다. 저장 또는 저장 후 연결을 선택합니다.
/방송연동 상태로 UUID와 플랫폼 상태를 확인합니다. 수동 파일 설정을 원하면 이 UUID를 사용합니다.

기본 설정은 players: {}와 max-connections: 32뿐이므로 처음부터 등록된 채널은 없습니다. 화면 저장은 현재 플레이어의 해당 플랫폼에 input과 enabled: true를 저장하고 즉시 메모리 설정에 반영합니다.

화면에서 저장: 해당 플랫폼의 연결을 먼저 해제합니다. 저장 성공 응답 후 연결을 누르거나 저장 후 연결을 사용합니다. 별도 리로드는 필요 없습니다.
파일 직접 편집: 설정을 백업하고 설정 문서에 맞게 편집한 뒤, 관리자가 /방송연동 리로드를 실행합니다. 모든 플레이어의 OnAir 연결이 해제되므로 이후 각 플레이어가 다시 연결해야 합니다.
JAR 교체: 설정 리로드로 새 코드를 적용할 수 없습니다. 관리자가 별도 점검 시간에 정상 서버 재기동 절차를 진행해야 합니다.

파일 편집 후 리로드 전에 화면 저장을 하면 메모리의 기존 설정을 바탕으로 파일이 다시 작성되어 편집 내용이 사라질 수 있습니다. 수동 편집과 화면 저장을 동시에 진행하지 마세요. 서버 전체 /reload는 이 절차에 포함하지 않습니다.

2026-10-05 기준 산출물 이름·의존성 선언·초기화·저장 코드를 확인했습니다. 설치·서버 기동·JAR 교체를 실행하지 않았으며 게임 내 동작은 미검증입니다.