BuzzBuild-Camera — 사용법

먼저 설치와 권한을 확인하세요. 아래는 소스에서 확인한 실행 절차이며, 명령 예시는 실제 실행 기록이 아닙니다.

자신의 한 점 시점 확인

1. Camera와 Framework 모드를 설치한 클라이언트로 접속합니다.
2. /카메라 시점으로 현재 눈 위치·각도를 요청합니다. 눈 위치와 목표가 같으므로 큰 이동은 보이지 않을 수 있습니다.
3. 다른 점을 보려면 실제 장면에 맞춘 좌표로 실행합니다.

/카메라 시점 10 80 20 180 25

기본값으로 목표까지 40틱 이동하고, 40틱 유지한 뒤 24틱에 걸쳐 플레이어 시점으로 복귀합니다. 즉시 복귀를 요청하려면 /카메라 중지를 사용합니다. 중지도 기본 복귀 시간을 사용하므로 순간 종료가 아닙니다.

YAML 시퀀스 재생

1. 서버 plugins/BuzzBuild-Camera/sequences/example.yml을 작성합니다. 아래 좌표는 가상 장면 예시입니다.
2. 대상이 있는 차원에서 사용할 좌표를 선택합니다. world: ""이면 대상의 현재 차원 키를 사용합니다.
3. 설정을 적용하고 목록에서 ID를 확인합니다.
4. 자신 또는 온라인 대상에게 재생합니다.

id: example
world: ""
return-ticks: 24
default-transition-ticks: 40
default-hold-ticks: 40
default-chunk-view-radius: 12
shots:
  - id: overview
    x: 10.0
    y: 90.0
    z: 20.0
    yaw: 180.0
    pitch: 35.0
  - id: close
    x: 14.0
    y: 80.0
    z: 24.0
    yaw: 180.0
    pitch: 15.0
    hold-ticks: 60

/카메라 리로드
/카메라 목록
/카메라 재생 example
/카메라 재생 example ExamplePlayer

클라이언트에 시퀀스 파일을 배포할 필요는 없습니다. 서버가 샷 목록을 보냅니다. ExamplePlayer는 가상 닉이며, 다른 대상 실행에는 추가 권한이 필요합니다.

음수 hold-ticks가 있는 샷은 그 위치에서 멈추어 뒤의 샷으로 자동 진행하지 않습니다. /카메라 중지는 플레이어에게 복귀시키며 다음 샷 재개 기능은 없습니다.

범위 안의 플레이어에게 5초 연출

1. 실제 장면의 카메라 위치와 방향을 정합니다.
2. 그 좌표로부터 3차원 거리 32블록 안에 대상들이 있는지 확인합니다. 카메라의 높이도 거리 계산에 포함됩니다.
3. 관리자 권한으로 실행합니다.

/시점변경 32 초 5 10,80,20,180,25
/시점변경 상태

명령 시점에 조건에 맞고 송신 검사를 통과한 플레이어만 집계합니다. 5초는 목표에 도착한 뒤 유지 시간이며 이동·복귀 시간은 별도입니다. 범위 밖으로 나가면 일찍 중지됩니다. 상태는 범위 시점 추적 항목 수입니다.

명령으로 끝낼 때까지 유지

/시점변경 32 명령어 10,80,20,180,25

특정 플레이어만 끝내려면 다음 명령을 사용합니다.

/카메라 중지 ExamplePlayer

모든 온라인 대상의 Camera 연출을 끝내려면 다음 명령을 사용합니다. 일반 /카메라 재생 세션도 종료됩니다.

/시점변경 종료 전체

한 카메라 지점 근처에 등록된 범위 시점만 끝내는 방법은 명령어 문서를 참고하세요.

연출 중의 조작과 해제

플레이어 이동 입력을 유지하며 카메라만 별도 위치로 옮깁니다. 클라이언트는 플레이어 pitch를 0으로 맞추고 yaw는 유지합니다. 1인칭을 강제하고 손 아이템을 숨기지만 플레이어를 무적·관전 모드로 바꾸는 기능은 없습니다.

기본 설정에서는 사망·텔레포트·월드 변경으로 중지합니다. 퇴장 시 서버 세션과 클라이언트 상태를 정리합니다. 복귀는 종료 시점 플레이어 눈 위치를 향합니다. 이전 3인칭 설정은 자동 복원하지 않습니다.

확인 범위

2026-10-05 명령 실행·샷 진행·이벤트·입력 Mixin 기준으로 작성했습니다. 게임 내 동작은 미검증입니다.