BuzzBuild-Camera — 명령어·권한

<값>은 필수, [값]은 선택 인자입니다. 예시의 ExamplePlayer와 좌표는 가상값입니다. 콘솔에서는 맨 앞 /를 생략합니다.

/카메라

명령 별칭은 /camera, /bbcamera입니다. 진입 권한은 buzzbuild.camera.use입니다.

문법	하위 명령 별칭	기능	콘솔
/카메라 [도움말]	help, ?	도움말	가능
/카메라 목록	list	로드된 시퀀스 ID	가능
/카메라 재생 <id> [닉]	play	시퀀스 재생	닉 필수
/카메라 시점	view, 여기	자신의 현재 눈 위치와 방향	불가
/카메라 시점 <x> <y> <z> [yaw] [pitch] [닉]	view, 여기	지정 좌표의 한 점 시점	좌표와 닉 필수
/카메라 중지 [닉]	stop, 종료	복귀 연출을 요청하고 세션 종료	닉 필수
/카메라 리로드	reload	설정·시퀀스·청크 브리지 재로드	가능

좌표는 공백으로 구분한 절대 숫자입니다. ~·^ 상대 좌표와 선택자 @a 등은 지원하지 않습니다. 닉은 getPlayerExact로 온라인 대상을 찾습니다. 닉을 생략하면 플레이어 실행자 자신이 대상입니다.

yaw만 지정할 수 있으며, pitch를 지정하려면 먼저 yaw를 넣습니다. 생략한 각도는 플레이어 실행자의 현재 방향, 콘솔이면 대상의 현재 방향입니다. 좌표가 있는 시점 요청도 월드는 대상의 현재 월드를 사용합니다. 숫자로만 된 닉은 각도 인자와 혼동될 수 있으므로 두 각도를 명시하세요.

/카메라 목록
/camera play intro
/카메라 시점 10 90 20 180 25
/카메라 재생 intro ExamplePlayer
/카메라 중지 ExamplePlayer

/시점변경

명령 별칭은 /raoncamera, /rcam입니다. 모든 분기에 buzzbuild.camera.admin이 필요합니다.

문법	별칭	기능·콘솔 조건
/시점변경	없음	도움말, 콘솔 가능
/시점변경 <범위> 초 <초> <[월드,]x,y,z,yaw,pitch>	seconds, sec	시간제 유지. 콘솔은 월드 필수
/시점변경 <범위> 명령어 <[월드,]x,y,z,yaw,pitch>	command, cmd	중지까지 유지. 콘솔은 월드 필수
/시점변경 종료 전체	end, all	모든 온라인 플레이어의 활성 Camera 세션 종료. 콘솔 가능
/시점변경 종료 <[월드,]x,y,z,yaw,pitch> [범위]	end	지정 지점 근처에 등록된 범위 시점 종료. 콘솔은 월드 필수
/시점변경 상태	status	범위 시점 추적 항목 수. 콘솔 가능
/시점변경 리로드	reload	Camera 설정 리로드. 콘솔 가능

• 쉼표 좌표 전체를 공백 없이 한 인자로 입력합니다. 월드는 Bukkit 월드 이름입니다. 시퀀스의 차원 키와 구분하세요.
• 범위는 블록 단위의 3차원 거리이며 카메라 좌표가 중심입니다. 실행자 중심이 아닙니다. 시작 순간 범위 안에 있는 사람만 대상으로 삼고, 나중에 들어오는 사람을 자동 추가하지 않습니다.
• 범위와 시간은 양의 유한 숫자입니다. 범위 상한은 512, 시간 상한은 600초입니다. 시간은 round(초 × 20)틱, 최소 1틱이며 서버 유지 시간 상한도 적용됩니다.
• 범위를 벗어나거나 월드가 달라지면 시간제·무기한 모드 모두 중지합니다.
• 좌표형 종료는 플레이어의 현재 위치가 아니라 저장된 카메라 중심 위치와 비교합니다. 종료 범위 기본값·상한은 512입니다.
• 종료 전체는 /카메라로 시작한 일반 시퀀스도 중지합니다. 상태는 전체 Camera 세션 수가 아닙니다.
• x/z는 ±30,000,000 이내, y는 월드 최소 높이−64부터 최대 높이+512까지 검사합니다. yaw는 360 나머지, pitch는 −90~90으로 제한합니다.
• 월드를 생략하면 플레이어의 월드 또는 명령 블록의 월드를 사용합니다. 일반 콘솔에는 생략할 수 없습니다.

/시점변경 32 초 5 10,80,20,180,25
/시점변경 32 명령어 10,80,20,180,25
/시점변경 종료 전체

콘솔 예시: world는 예시 월드 이름이므로 실제 로드된 월드 이름으로 바꾸세요.

rcam 32 seconds 5 world,10,80,20,180,25
camera view 10 80 20 180 25 ExamplePlayer

권한

노드	기본 허용	용도
buzzbuild.camera.use	op	/카메라 진입, 자기 대상 실행·목록·도움말
buzzbuild.camera.other	op	닉을 명시한 대상 실행
buzzbuild.camera.reload	op	/카메라 리로드
buzzbuild.camera.admin	op	/시점변경 전체 및 Camera 관리. 위 세 노드를 children으로 포함

닉을 명시하면 자신의 닉이어도 other 또는 admin 검사를 통과해야 합니다. /카메라의 메타데이터 진입 권한도 적용되므로 other·reload만 따로 부여한 경우 use도 필요합니다. 콘솔 허용 표는 실행 경로를 뜻하며 권한 검사를 생략한다는 뜻은 아닙니다.

확인 범위

2026-10-05 plugin.yml과 두 명령 실행기·등록 코드를 대조했습니다. 게임 내 동작은 미검증입니다.