BuzzBuild-Camera — 설치

서버 운영자와 연출을 볼 클라이언트 사용자가 각각 설치해야 합니다. 환경 버전은 개요를 확인하세요.

파일 배치

아래 경로는 각 서버 또는 게임 인스턴스를 기준으로 한 상대 경로입니다. 파일명은 현재 Gradle의 산출물 이름과 버전 설정 기준입니다.

위치	파일 또는 구성 요소
서버 `plugins/`	`BuzzBuild-Camera-Paper-0.1.0.jar`와 Framework Paper 배포 JAR
클라이언트 `mods/`	`BuzzBuild-Camera-Fabric-0.1.0.jar`, Framework Fabric 배포 JAR, 해당 Minecraft 버전의 Fabric API
클라이언트 실행 환경	Minecraft `26.1.2`, Fabric Loader `0.19.3` 빌드 기준, Java `25`

shared 모듈을 별도 플러그인으로 설치하지 않습니다. Camera의 Paper 배포물에는 shared가 포함되고, Fabric 배포물에는 포함 의존성으로 구성됩니다. Framework API JAR는 빌드 참조용이며 Framework 런타임 배포물 대신 사용할 수 없습니다.

최초 실행과 설정

운영자가 정한 유지보수 절차로 서버·클라이언트 배포물을 설치합니다. Framework 서버 플러그인이 Camera보다 먼저 활성화되어야 합니다.
운영자의 정상 기동 후 Camera 활성화 로그와 시퀀스 로드 개수를 확인합니다.
서버에 생성되는 plugins/BuzzBuild-Camera/config.yml과 plugins/BuzzBuild-Camera/sequences/intro.yml을 확인합니다. 기본 리소스는 기존 파일을 덮어쓰지 않습니다.
intro.yml의 좌표는 샘플입니다. 사용할 장면에 맞게 수정하고, world는 대상 플레이어의 현재 차원에 맞추거나 빈 문자열로 둡니다.
클라이언트 최초 실행 시 config/buzzbuild-camera.properties가 생성됩니다. debug=false가 기본값입니다.
필요한 권한을 부여한 뒤 /카메라 목록으로 로드 결과를 확인합니다.

Camera 자체 DB 설정이나 별도 리소스팩 요구는 없습니다. Framework의 자체 설정은 Framework 문서에서 확인하세요.

변경 적용

서버의 config.yml 또는 sequences/*.yml 수정 후 권한 있는 실행자가 다음 명령을 사용합니다.

/카메라 리로드
/카메라 목록

이 명령은 Camera 설정·시퀀스와 청크 패킷 브리지를 다시 읽습니다. 서버 전체 reload 명령이 아닙니다. 진행 중인 클라이언트 연출의 샷을 새 설정으로 교체하지는 않으므로 연출을 중지한 뒤 설정을 적용하고 다시 재생하세요.

클라이언트 debug는 초기화 때만 읽습니다. 변경은 다음 클라이언트 실행부터 적용됩니다. JAR 교체는 설정 리로드로 반영되지 않으므로 운영자의 별도 정상 재기동 절차가 필요합니다.

확인 범위

2026-10-05 소스 정적 확인. 실제 설치·기동·배포는 수행하지 않았으며 게임 내 동작은 미검증입니다.