BuzzBuild-OnAir — 설정

운영 설정은 서버의 plugins/BuzzBuild-OnAir/config.yml입니다. 별도 OnAir 클라이언트 설정 파일이나 DB 설정은 없습니다. 투네이션 연결정보가 들어간 파일은 비공개로 보관하세요. 저장값은 암호화되지 않은 YAML이며 클라이언트 상태 응답에는 기존 입력값을 보내지 않습니다.

기본 리소스

players: {}
max-connections: 32

설정 키

아래 <uuid>는 플레이어 UUID, <platform>은 소문자 chzzk, soop, cime, toonation 중 하나입니다.

키	타입	기본값	설명
`players`	매핑	`{}`	플레이어별 플랫폼 설정
`players.<uuid>.<platform>.enabled`	불리언	`false`	해당 플랫폼의 입력 목록 사용 여부
`players.<uuid>.<platform>.input`	문자열	`""`	기본 채널 식별자 또는 알림창 키
`players.<uuid>.<platform>.additional-inputs`	문자열 목록	`[]`	추가 채널 식별자. 기본 입력과 중복 제거 후 연결
`players.<uuid>.<platform>.auto-connect`	불리언	`false`	플레이어 접속 시 및 플러그인 활성화 시 이미 접속한 플레이어의 연결 시작
`max-connections`	정수	`32`	서버 전체 연결 슬롯 한도. 읽을 때 1~256으로 제한

additional-inputs와 auto-connect는 기본 리소스에 없지만 실행 코드에서 읽는 키입니다. 플레이어별 키도 설정이 없을 때 위 기본값을 사용합니다. max-connections는 플레이어 수가 아니라 플레이어·플랫폼·채널 조합 수이며 연결 중·해제 처리 중 슬롯도 포함합니다.

enabled: false면 추가 입력까지 모두 무시합니다. 유효하지 않은 입력은 연결 목록에서 제외됩니다. 화면 저장은 기본 input과 enabled만 바꾸며 기존 additional-inputs·auto-connect를 유지합니다. 화면에는 추가 채널·자동 연결 설정 편집 기능이 없습니다.

파일 입력과 화면 입력의 차이

파일에는 전체 URL 대신 정규화된 ID·핸들·키를 적습니다. 파일 로딩 검사는 치지직 32자리 16진수, 나머지는 문자·숫자·밑줄·하이픈 1~512자를 허용합니다. 다만 아래 화면 저장 규칙에 맞춘 값을 사용하는 편이 일관됩니다.

플랫폼	화면에서 저장 가능한 식별자	허용 URL 형태의 경로
`chzzk`	32자리 16진수, 저장 시 소문자화	`chzzk.naver.com` 또는 `m.chzzk.naver.com`의 `/<id>`, `/live/<id>`
`soop`	영문·숫자·`_`·`-`, 1~100자	`play.sooplive.com`, `play.sooplive.co.kr`, `ch.sooplive.com`, `ch.sooplive.co.kr`의 `/<id>` 또는 `/<id>/<숫자>`; `sooplive.com`, `sooplive.co.kr` 및 각각 `www.` 호스트의 `/station/<id>`
`cime`	문자·숫자·`_`·`-`, 1~100자; 앞의 `@` 제거	`ci.me` 또는 `www.ci.me`의 `/<핸들>`
`toonation`	영문·숫자·`_`·`-`, 1~512자	`toon.at`의 `/widget/alertbox/<키>`

위 호스트·경로는 입력 파서의 허용 규칙이며 현재 외부 서비스의 접속 검증 결과가 아닙니다. 화면 입력은 최대 1024자이며 HTTP/HTTPS URL 또는 프로토콜을 생략한 허용 주소를 해석합니다. URL의 사용자 인증정보·명시적 포트, 입력 내부 공백·제어문자는 거부합니다. 투네이션 일반 후원 페이지 주소는 사용할 수 없습니다.

최소 설정 예시

아래 UUID와 채널 ID는 실제 계정과 무관한 가상값입니다. /방송연동 상태에서 확인한 자신의 UUID와 채널 ID로 바꾸세요.

players:
  '00000000-0000-0000-0000-000000000000':
    chzzk:
      enabled: true
      input: '0123456789abcdef0123456789abcdef'
max-connections: 32

선택 설정을 포함한 가상 예시입니다. input과 추가 입력이 같으면 한 번만 연결합니다.

players:
  '00000000-0000-0000-0000-000000000000':
    chzzk:
      enabled: true
      input: '0123456789abcdef0123456789abcdef'
      additional-inputs:
        - 'fedcba9876543210fedcba9876543210'
      auto-connect: true
max-connections: 32

파일 수정 후 관리자가 /방송연동 리로드를 실행하면 모든 방송 연결이 해제됩니다. auto-connect: true도 이 리로드 직후에는 실행되지 않으므로 연결 버튼으로 재연결하세요. 적용 절차는 설치에 있습니다.

확인 범위

2026-10-05 기준 기본 YAML, 설정 읽기·정규화·저장·연결 제한 코드를 확인했습니다. 게임 내 동작은 미검증입니다.