playerAnimator
KosmX가 만든 플레이어 전용 키프레임 애니메이션 라이브러리입니다. Better Combat, Spell Engine, Combat Roll 같은 전투·모션 모드가 이 라이브러리 위에서 캐릭터 동작을 재생합니다.
📖 소개
바닐라 마인크래프트의 플레이어 모델은 정해진 몇 가지 동작만 합니다. 팔을 휘두르고, 웅크리고, 걷습니다. 모드가 회피 구르기나 3연타 콤보처럼 새 동작을 넣으려면 플레이어 모델의 각 부위를 프레임 단위로 직접 움직여야 하는데, playerAnimator는 그 재생 장치를 제공합니다. 제작자 KosmX의 표현대로 "키프레임으로 플레이어를 움직이는" 라이브러리입니다.
실제로 이걸 요구하는 모드. Modrinth 버전 목록에서 확인되는 필수 의존 모드는 Better Combat(1.21.1 이하 빌드), Spell Engine, Combat Roll, Mine and Slash입니다. 같은 제작자의 Emotecraft도 같은 계열입니다. 반대로 자주 같이 언급되는 Epic Fight나 Not Enough Animations는 자체 애니메이션 시스템을 쓰기 때문에 playerAnimator를 요구하지 않습니다. 크래시 로그에 playerAnimator가 나왔다면 전투 모드 쪽을 먼저 보는 편이 맞습니다.
1.21.6부터는 이야기가 달라집니다. playerAnimator의 Modrinth 지원 범위는 1.16.4 ~ 1.21.7에서 멈춰 있고, Better Combat과 Emotecraft의 1.21.6 이후 빌드는 playerAnimator 대신 Player Animation Library(ZigyTheBird 제작)를 요구합니다. 이름이 거의 같지만 별개의 프로젝트입니다. 최신 버전 모드팩을 조립하면서 playerAnimator를 넣었는데 계속 의존성 오류가 난다면, 요구되는 게 이쪽인지 확인해 보세요.
Geckolib과는 다릅니다. Geckolib은 몹·블록·아이템 모델을 움직이는 라이브러리이고, playerAnimator는 플레이어 모델만 다룹니다. 역할이 겹치지 않아서 한 모드팩에 둘 다 들어 있는 경우가 흔합니다.
기본 정보. MIT 라이선스, Fabric·Forge·NeoForge·Quilt 빌드, Modrinth 기준 누적 다운로드 23,356,836회. GitHub 저장소는 2022년에 열렸습니다. 인게임 화면이나 설정 항목은 없습니다.
🕒 이 모드는 언제 쓰는가
Better Combat, Spell Engine, Combat Roll처럼 커스텀 캐릭터 동작을 쓰는 모드를 설치할 때 함께 필요합니다. 단독으로 넣을 이유는 없습니다.
📦 어떤 모드팩에서 중요한가
전투 개편·액션 RPG 계열 모드팩에서 사실상 기본 부속입니다. 1.21.1 이하 버전대 모드팩이라면 대부분 이 라이브러리를 씁니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
1. 어떤 모드가 요구하는지 확인합니다. 크래시 로그나 모드 페이지의 의존성 항목에 playeranimator가 있는지 봅니다. 여기서 player-animation-library라고 적혀 있다면 다른 모드를 받아야 합니다.
2. 마인크래프트 버전과 로더를 맞춰 받습니다. Fabric·Forge·NeoForge·Quilt 빌드가 따로 있고, 지원 범위는 1.16.4 ~ 1.21.7입니다. 그 이상 버전대라면 후속 라이브러리를 찾아야 합니다.
3. mods 폴더에 넣고 끝냅니다. 설정할 것이 없습니다. 전투 모드를 켜고 공격 동작이 재생되면 정상 작동하는 것입니다.
💡 플레이 팁
- 버전은 의존 모드에 맞춥니다 — API가 바뀌는 편이라 전투 모드가 요구하는 버전대와 어긋나면 동작이 재생되지 않거나 시작 시 오류가 납니다. 최신판보다 의존 모드 페이지가 지정한 버전을 받으세요.
- 설정 파일이 없습니다 — config 폴더에 항목이 생기지 않고 인게임 메뉴도 없습니다. 애니메이션 관련 옵션은 전부 Better Combat 같은 의존 모드 쪽에 있습니다.
- bendy-lib가 함께 요구될 수 있습니다 — 관절을 부드럽게 휘게 만드는 보조 라이브러리로, 일부 애니메이션 품질에 관여합니다. 모드 목록에 이미 있다면 그대로 두세요.
⚠️ 자주 헷갈리는 부분
- • 개발이 중단됐습니다 — 레포 README 첫 줄이
NO-LONGER-UPDATED이고, 작성자가 더 이상 이 프로젝트를 유지할 뜻이 없으며 기존 릴리스의 큰 버그만 필요하면 고치겠다고 밝혔습니다. 후속으로는 PAL(Player Animation Library)을 안내하고 있습니다. 이미 이 라이브러리를 요구하는 모드는 그대로 쓰면 되지만, 새 버전대 지원을 기다리지는 마세요. - • playerAnimator와 Player Animation Library는 다른 모드입니다 — 이름은 거의 같지만 별개 프로젝트입니다. playerAnimator는 KosmX, Player Animation Library는 ZigyTheBird가 만들었고, 1.21.6 이후 Better Combat·Emotecraft 빌드는 후자를 요구합니다. 의존성 오류가 반복되면 어느 쪽을 요구하는지부터 확인하세요.
- • Epic Fight의 콤보 동작은 이 라이브러리가 아닙니다 — Epic Fight와 Not Enough Animations는 자체 애니메이션 구현을 씁니다. playerAnimator를 지운다고 그 동작이 사라지지는 않습니다.
- • Geckolib이 있으니 필요 없다는 건 오해입니다 — Geckolib은 몹·블록·아이템용, playerAnimator는 플레이어용입니다. 서로를 대신하지 못하며 함께 설치돼 있어도 충돌하지 않습니다.
- • 단독 설치 시 아무 일도 일어나지 않습니다 — 새 동작을 추가하는 모드가 아니라 다른 모드가 만든 동작을 재생하는 장치입니다. 의존 모드가 없으면 게임은 바닐라와 똑같이 보입니다.
❓ 자주 묻는 질문
playerAnimator만 설치하면 동작이 화려해지나요?
아니요. 아무 변화도 없습니다. 이 모드는 동작을 만들어 주는 게 아니라, 다른 모드가 만든 동작을 재생하는 장치입니다.
Geckolib과 같은 모드인가요?
다릅니다. Geckolib은 몹·블록·아이템 모델을, playerAnimator는 플레이어 모델을 다룹니다. 대체 관계가 아니라 한 모드팩에 함께 들어가는 경우가 많습니다.
어떤 모드가 실제로 요구하나요?
Modrinth 의존성 기준으로 Better Combat(1.21.1 이하), Spell Engine, Combat Roll, Mine and Slash 등입니다. Epic Fight와 Not Enough Animations는 요구하지 않습니다.
1.21.6 이상에서는 왜 못 찾나요?
playerAnimator의 지원 범위가 1.21.7까지이고, 그 버전대의 Better Combat·Emotecraft는 Player Animation Library(ZigyTheBird)로 갈아탔습니다. 이름이 비슷한 다른 모드입니다.
성능에 영향이 있나요?
라이브러리만 있으면 재생할 동작이 없으므로 사실상 부하가 없습니다. 실제 연산은 의존 모드가 애니메이션을 재생하는 순간에 발생합니다.