AzureLib: Minecraft 애니메이션과 3D 모델을 지원하는 기술 모드 라이브러리
AzureLib는 모드에서 Bedrock 방식 애니메이션을 구현하는 Minecraft 라이브러리로, 자체적으로 아이템이나 몹을 추가하지 않는다.
AzureLib는 모드에서 Bedrock 방식 애니메이션을 구현하는 Minecraft 라이브러리로, 자체적으로 아이템이나 몹을 추가하지 않는다.
AzureLib: Minecraft 애니메이션과 3D 모델을 지원하는 기술 모드 라이브러리
이 글을 테스트하고 작성한 Minecraft 버전: 1.21.1
지원 버전 범위: 1.15.2 – 1.21.1
의존성: Fabric API (Fabric 빌드용)
AzureLib는 Minecraft 유틸리티 라이브러리로, 복잡한 모델 애니메이션을 사용하는 수많은 모드가 이것 없이는 실행되지 않는다. 라이브러리 자체는 게임에 아이템이나 몹, 구조물을 추가하지 않으며, 그 역할은 바닐라 엔진이 처리할 수 없는 Bedrock 형식 모델 애니메이션의 렌더링과 재생을 담당하는 것이다.
어떤 모드의 설명에 Requires AzureLib라는 항목이 있다면, 제작자가 직접 애니메이션 시스템을 작성하는 대신 이 라이브러리의 시스템을 기반으로 만들었다는 뜻이다. 라이브러리가 없으면 그 모드는 로딩 중 충돌하거나 모델을 제대로 렌더링하지 못한다.
라이브러리가 제공하는 것
핵심은 3D 모델을 위한 키프레임 시스템이다. 애니메이션은 JSON 파일을 통해 정의되며, 특정 시점에서 모델 부위의 위치를 기술한다. 그 시점들 사이의 움직임은 자동으로 보간되어, 중간 프레임을 일일이 손으로 그릴 필요가 없다.
애니메이션 기능
이 라이브러리가 지원하는 기능:
하나의 모델에서 여러 애니메이션을 동시에 실행 — 각 애니메이션이 자체 컨트롤러에서 실행되므로, 몹이 걸으면서 동시에 고개를 돌리고 꼬리를 흔들 수 있다;
키프레임 간 전환을 위한 30여 개의 이징 함수 — 모델의 한 자세가 다음 자세로 어떻게 전환되는지, 즉 급격하게, 부드럽게, 가속하며, 또는 튕기듯이 전환되는지를 결정한다;
사운드 키프레임 — 애니메이션의 지정된 지점에서 선택한 소리가 재생된다;
파티클 키프레임 — 효과의 발생이 모델의 특정 프레임에 연결된다;
이벤트 키프레임 — 애니메이션의 지정된 순간에 모드 코드가 호출되어, 모델이 타격 동작을 하는 바로 그 프레임에 피해가 적용되고 공격 중 임의의 순간에 적용되지 않는다.
적용되는 오브젝트
이 라이브러리는 게임 내 네 가지 유형의 오브젝트에서 작동한다:
엔티티 — 몹, NPC, 길들인 생물로, 대기·이동·공격 상태에 대한 완전한 스켈레톤 애니메이션을 가진다;
아이템 — 캐릭터의 손과 인벤토리에서 애니메이션되는 모델을 가진 무기와 도구;
방어구 — 플레이어나 몹의 스켈레톤 위에 방어구 모델을 렌더링;
블록 — 열리거나 회전하는 메커니즘 같은 기능성 블록.
성능
라이브러리 자체는 메모리 부담이 크지 않아 디스크 공간 약 1MB와 미미한 시작 오버헤드만 차지한다. 실제 부하는 이를 사용하는 모드에 따라 달라지는데, 뼈대가 많고 동시에 여러 애니메이션이 실행되는 복잡한 몹 모델은 단순한 정적 모델보다 더 많은 CPU를 소모한다. 모드팩에 이런 몹이 수십 마리 있고 몰려 있는 곳에서 FPS가 떨어진다면, 이는 해당 모드들의 애니메이션 디테일에 대한 대가이지 라이브러리 자체의 문제가 아니다.
결론
AzureLib는 한 가지 좁은 문제를 해결한다 — 모드 제작자에게 완성된 Bedrock 애니메이션 엔진을 제공하는 것이며, 그래서 모드팩에서 필수 의존성으로 자주 등장한다. 정교하게 애니메이션된 몹, 방어구, 기능성 블록이 포함된 모드팩을 만들거나 설치하는 사람에게 적합하다.
설치
일반적인 설치는 약 5 분 정도 걸려요. 과정은 동일하고, Loader 와 그에 맞는 빌드만 달라요.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











