이 글은 블록 벤치 자체에 대한 내용은 다루지 않습니다.
이 글은 마인크래프트 기초 지식을 다루지 않습니다.
개요
Locator는 별도의 큐브, 디스플레이 없이 해당 위치에서 명령어를 실행시킬 수 있는 객체입니다.
애니메이션의 특정 프레임에 명령어를 실행시키는 기능을 가지고 있습니다.
Camera는 큐브처럼 애니메이션 조작이 가능한 객체로 기본으로 있는 Locator와 달리 별도의 카메라 플러그인을 설치해주어야 합니다.

카메라는 별도의 시점이 존재하며 마인크래프트 내에서 카메라에 플레이어를 관전시켜 컷신같은 카메라 무빙을 만들어낼 수 있습니다.
생성하기


로케이터의 경우 생성 버튼 중 닻 모양 버튼을 누르면 생성할 수 있고 카메라의 경우 외곽선(Outliner)에 우클릭 후 Add Camera 버튼을 클릭합니다.
Locator Config
생성된 로케이터를 우클릭해보면 Locator Config를 열 수 있습니다.

- Use Entity
- 체크 시 로케이터 역할을 하는 엔티티를 소환해서 움직입니다.

- Entity Type
- Locator 역할을 할 엔티티입니다. 디스플레이나 marker를 추천합니다.
- Sync Passenger
- 상위 그룹 엔티티의 회전과 자동으로 일치시킬지 여부입니다.
- On-Summon Commands
- 해당 엔티티를 소환할 때 해당 엔티티 기준으로 실행될 명령어입니다.
- mcfunction의 구문과 동일하며 MC-Build 문법을 지원합니다.
- Ticking Commands
- 틱마다 로케이터의 위치에서 실행할 명령어입니다.
- mcfunction의 구문과 동일하며 MC-Build 문법을 지원합니다.
배치하기

로케이터는 애니메이션 창에서 커맨드만 가능하므로 머리에 붙여서 머리를 따라 움직이도록 해주었습니다.
카메라는 적당히 뒷통수를 바라보도록 해주었습니다.

또한 로케이터는 Ticking Commands로 파티클을 계속 보여주도록 해주었습니다.
애니메이션 창

로케이터는 특정 프레임에 명령어를 실행시킬 수 있고 카메라는 큐브처럼 위치와 회전을 조작할 수 있습니다.
Fov의 경우 카메라 플러그인이 외부 플러그인이라 있는거고 AJ에서는 반영되지 않습니다.
마찬가지로 회전도 Z축은 제대로 반영되지 않습니다.
일단 카메라는 기존의 애니메이션과 동일하므로 적당히 조절해보겠습니다.
로케이터 키프레임

로케이터의 키프레임입니다. 해당 프레임에 도달했을 때 조건에 맞으면 명령어를 실행합니다.
- Commands
- 실행할 명령어입니다. 위와 마찬가지로 mcfunction의 구문, MC-Build의 구문을 사용할 수 있습니다.
- Repeat?
- 해당 프레임에 도달한 뒤 계속해서 반복할 지 여부입니다.
- Repeat Frequency
- 반복이 시작되면 몇 틱마다 반복할 지 여부입니다. (1: 매 틱마다, 2: 2틱마다)
- Execute Condition
- 해당 명령어를 실행할 조건입니다. /execute 명령어의 하위 구문을 사용합니다.
해당 틱에 도달하면 say 명령어를 실행하도록 해주었습니다.
마인크래프트에서 사용하기

내보내기 후 소환을 시켜보면 로케이터의 위치에서 파티클 명령어가 계속해서 작동하는 모습을 볼 수 있습니다.

Idle 애니메이션을 재생해보니 애니메이션에서 설정한대로 say test 명령어가 주기적으로 작동하는 모습을 볼 수 있습니다.

카메라의 경우 Axiom 모드의 엔티티 표시 기능을 통해 뒤에 존재하는 걸 확인할 수 있습니다.
카메라로써 역할을 할 수 있도록 관전 명령어를 사용해보겠습니다.
카메라 엔티티의 전용 태그는 다음과 같습니다.
aj.<네임스페이스>.camera.<카메라 이름>
이 프로젝트에서 카메라 이름이 mycamera이므로 관전 명령어는 다음과 같이 치면 됩니다.


사진으로는 확인이 잘 안되지만 제대로 관전에 들어간 모습입니다.

idle 애니메이션에서 카메라 회전을 넣어주었더니 아주 격렬하게 움직이는 모습입니다.
as_locator, as_camera, at_locator 함수

as ~ 함수는 해당 로케이터 / 카메라를 as한 상태에서 명령어를 실행해주는 함수입니다. (at~ 은 at만)
단, as~ 함수는 로케이터가 use entity를 체크한 상태여야 하며 at_camera 함수는 생성되지 않습니다.
사용하는 방법은 root 를 as로 설정한 상태로 함수를 인수와 함께 주면 됩니다.
인수는 다음과 같습니다.
| name | 명령어를 실행할 locator / 카메라의 이름입니다. |
| command | 실행할 명령어입니다. |


다만 as_camera의 경우 생성된 함수가 제대로 매크로 처리가 안되어있는 등 버그가 있어서 제대로 작동하지 않습니다.

만약 고쳐졌다면 위 명령어를 통해서도 관전을 시킬 수 있습니다.
마찬가지로 all_locator 함수들도 인수를 command만 받는데 제대로 작동하지 않았습니다.
이점 참고해주시기 바랍니다.
'마인크래프트 강좌 > 블록벤치 강좌' 카테고리의 다른 글
| [BlockBench Plugin][Animated Java] -2- variants (0) | 2025.07.30 |
|---|---|
| [BlockBench Plugin][Animated Java] -1- 기초 (4) | 2025.07.24 |