BuzzBuild-OnAir — 명령어·권한

기본 명령어는 /방송연동, 별칭은 /onair와 /방송입니다. 하위 명령어 판별은 대소문자를 변환하지 않으므로 영문은 아래 소문자를 사용하세요.

명령어

문법	기능	검사 권한	콘솔 실행
/방송연동	자신의 대시보드 열기	buzzbuild.onair.use	불가, 안내만 표시
/방송연동 상태 또는 /방송연동 status	자신의 UUID, 플랫폼 상태 및 연결 채널 수 표시	buzzbuild.onair.use	불가, 안내만 표시
/방송연동 리로드 또는 /방송연동 reload	설정 다시 읽기, 모든 OnAir 연결 해제	buzzbuild.onair.admin	가능, 동일 권한 검사

/방송연동
/onair status
/방송 상태
/onair reload

콘솔에서는 선행 / 없이 onair reload로 입력합니다. 리로드 후 자동 재연결하지 않으므로 플레이어가 화면의 연결 버튼을 다시 눌러야 합니다. 다른 플레이어 지정, 명령어를 통한 채널 등록·연결·해제, 별도 테스트 하위 명령어는 없습니다.

인수 개수가 맞지 않거나 알 수 없는 하위 명령어이면 사용 안내를 표시합니다. 탭 완성은 상태를 제안하며 관리자에게는 리로드도 제안합니다. 영문 하위 명령어는 실행되지만 탭 제안에는 없습니다.

권한

노드	메타데이터 기본 허용	실행 코드에서의 용도
buzzbuild.onair.use	true — 기본적으로 모든 사용자	화면 열기, 상태 조회, 자신의 연결정보 저장·연결·해제, 자동 연결과 수신 표시
buzzbuild.onair.admin	op — 기본적으로 OP	설정 리로드, 화면의 테스트 수신 표시·실행

admin에 use를 상속시키는 권한 자식 선언은 없습니다. 관리자에게 use를 명시적으로 거부하면 리로드 권한이 있어도 화면과 테스트 수신을 사용할 수 없습니다. 일반 사용자도 use가 있으면 자신의 연결정보를 저장할 수 있으며, 저장에 admin은 요구하지 않습니다.

조작 제한

화면 열기와 일반 화면 동작에는 플레이어별 750ms 간격 제한이 있습니다. 너무 빠르게 조작하면 요청이 무시되거나 저장 재시도 안내가 표시됩니다. 화면 세션은 열 때부터 30분이며 열려 있는 세션이 만료되면 화면을 닫고 해당 플레이어의 연결을 해제합니다.

권한이 회수되면 주기적인 서버 처리에서 연결이 해제됩니다. 자세한 종료 동작은 사용법을 확인하세요.

확인 범위

2026-10-05 기준 plugin.yml, 명령어 등록·실행·탭 완성 및 화면 요청 권한 검사를 대조했습니다. 게임 내 동작은 미검증입니다.