BuzzBuild-Camera — 문제 해결
아래 원인과 처리 경로는 소스 정적 확인에 근거합니다. 게임 내 동작은 미검증이며, 실제 재현을 완료했다는 뜻은 아닙니다.
증상별 확인
섹션 제목: “증상별 확인”| 문제 | 확인 방법 | 해결·대응 |
|---|---|---|
| Camera가 활성화되지 않음 | Framework 누락 또는 Framework 서비스 없음 로그 확인 | Framework Paper 런타임 설치와 선행 활성화, Minecraft·Java 버전을 확인 |
| 명령 권한 거부 | 명령 진입 use와 하위 명령 other·reload 검사 확인 | 권한 표대로 필요한 노드 부여. 범위 명령은 admin 필요 |
| 자신을 대상으로 했는데 추가 권한 요구 | 자신의 닉을 명시했는지 확인 | 자신에게 실행할 때 닉을 생략하거나 other 권한 확인 |
| Camera 클라이언트 모드 필요 메시지 | 서버가 대상의 buzz:payload 채널을 확인하는지, 양쪽 Framework 활성화 확인 | Camera·Framework Fabric·Fabric API 및 버전을 확인하고 정상 클라이언트로 접속 |
| 전송 성공 메시지만 나오고 연출이 없음 | Framework만 설치했는지, 클라이언트 Camera 핸들러 초기화 로그와 차원 키 확인 | Camera 클라이언트도 설치. world를 현재 차원에 맞추거나 빈 문자열로 설정. 서버 성공 메시지는 렌더 완료 응답이 아님 |
| 목록에 시퀀스가 없음 | sequences/ 바로 아래 .yml, 유효 샷과 로그의 시퀀스 샷 없음·시퀀스 로드 실패 확인 | 숫자 형식과 필수 x/y/z 수정 후 Camera 리로드. .yaml·하위 폴더 미지원 |
| 시퀀스가 예상과 다름 | 중복 ID와 명시된 시퀀스 기본값 확인 | ID를 유일하게 지정. 전역값을 바꿨다면 파일 자체의 default-*도 확인 |
| 콘솔에서 시점 실행 실패 | /카메라 시점에 좌표·닉이 있는지, /시점변경에 월드 이름이 있는지 확인 | 콘솔 문법으로 실행 |
| 범위 시작이 0명 | 카메라 중심과 대상의 3차원 거리, 같은 월드 여부, 채널 검사 확인 | 높이를 포함해 범위를 확인. 실행 후 범위에 들어온 플레이어는 자동 추가되지 않음 |
| 유지 중 예정보다 빨리 복귀 | 범위 이탈, 사망, 월드 변경, 텔레포트 이벤트 확인 | 관련 이벤트와 session 설정 확인. 취소된 텔레포트 이벤트도 중지시킬 수 있음 |
| 샷이 계속 유지되고 다음으로 안 감 | 해당 샷의 hold-ticks가 음수인지 확인 | 유한 양수로 바꾸고 리로드 후 재생. 현재 연출은 /카메라 중지로 복귀 |
| 멀리 있는 장면의 지형이 비어 보임 | 청크 패킷 브리지를 만들지 못했습니다 또는 청크 패킷 전송 실패 로그 확인 | 대상 Paper 빌드를 확인하고 티켓·송신 거리·스트리밍 설정 점검. Camera 리로드는 브리지를 다시 초기화하지만 비호환 원인 자체를 고치지는 않음 |
| 스트리밍을 껐더니 원거리 지형이 부족함 | chunks.stream.enabled, 플레이어와 카메라 거리 확인 | 티켓만으로 클라이언트 표시가 보장되지 않음. 정상 브리지·스트리밍이 필요할 수 있음 |
| 연출 중 부하가 증가함 | 동시 대상 수, 샷 수, 반경, 레이 샘플과 청크 전송량 확인 | 작은 범위·샷 수로 분리 점검. 처리량 설정을 단계적으로 조정. 검증된 성능 기준값은 아직 없음 |
| 설정 변경이 현재 연출에 안 보임 | 리로드 전에 이미 시작한 연출인지 확인 | 중지하고 복귀가 끝난 뒤 리로드·재생. 이미 보낸 샷 목록은 자동 교체하지 않음 |
| 연출 뒤 3인칭으로 돌아오지 않음 | 연출 전 카메라 모드 확인 | 구현이 1인칭을 강제하고 원래 카메라 모드는 저장하지 않음. 필요하면 사용자가 다시 변경 |
| 진단 액션바가 안 나옴 | 클라이언트 config/buzzbuild-camera.properties의 debug 확인 | debug=true는 다음 클라이언트 실행 시 적용. 서버 메시지 설정과 별개 |
원거리 청크의 제한
섹션 제목: “원거리 청크의 제한”서버 송신 거리 설정은 2~32, 청크 티켓 반경은 최대 16, 클라이언트 창 반경은 최대 64로 각각 제한됩니다. 스트리밍은 여러 샷 주변과 샷 사이를 후보로 만들지만, 이를 무제한 거리의 월드 렌더링 보장으로 해석하면 안 됩니다.
청크 브리지는 Paper 내부 클래스에 리플렉션으로 접근하므로 다른 서버 빌드와의 호환성을 별도 확인해야 합니다. scene-distance-blocks와 FOV 설정은 후보 계산 값이며 실제 표시 거리·화면 FOV 보장이 아닙니다. 브리지의 미로드 청크 읽기는 loadChunk(..., false)를 사용합니다. 미생성 지역의 원거리 표시 역시 실측 확인이 필요합니다.
미지원 또는 구현에서 확인되지 않은 기능
섹션 제목: “미지원 또는 구현에서 확인되지 않은 기능”- 바닐라 클라이언트만으로 시네마틱 렌더링.
- 다른 차원으로 카메라만 이동하거나 플레이어를 자동 텔레포트.
- 사진·영상 저장, 시퀀스 편집 GUI, 일시정지·다음 샷 재개 명령.
- 플레이어별 연출 진행 상태의 재시작 후 복원.
- 별도 Camera 클라이언트 명령어. 실행 요청은 서버 명령 또는 API 경로입니다.
- Folia·Spigot·Forge·NeoForge 및 다른 Minecraft 버전의 지원 보장.
추가 확인이 필요한 동작
섹션 제목: “추가 확인이 필요한 동작”- 실제 대상 서버와 클라이언트에서 이동·복귀 시간, 입력 제어, 손 숨김, 먼 지형과 조명 표시.
- 비관리자 권한 조합, 콘솔·명령 블록 실행, 사망·월드 이동·취소된 텔레포트.
- 중지 직후 새 연출 시작 및 연출 중 리로드 시 청크 티켓과 원래 송신 거리 복구.
- 범위 연출 뒤 같은 대상에게 일반 시퀀스를 보낼 때 남아 있는 범위 추적의 영향.
- 대량 샷·동시 대상·먼 좌표의 메모리, 틱 처리량과 프레임 성능.
청크 정리 및 범위 추적의 잠재 문제는 비공개 인계 기록에도 남겼습니다. 운영 검증 시 우선 연출을 중지하고 복귀가 완료된 다음 새 연출·설정 변경을 진행하세요.
확인 범위
섹션 제목: “확인 범위”2026-10-05 소스 확인 기준입니다. 서버 시작·중지·재시작·전체 reload, 배포 및 게임 내 시험은 수행하지 않았습니다.