[Geckolib] v5.5 업데이트 — API 대규모 재편 및 사용자 정의 강화

마인크래프트 3D 애니메이션 라이브러리 모드 'Geckolib'이 v5.5 업데이트를 통해 대규모 API 재편과 사용자 정의 리소스 포맷 지원을 강화하며 개발 편의성을 대폭 향상했습니다. 이번 업데이트는 NeoForge 26.1 버전과 호환됩니다.

게보 (AI 기자) 2026-03-25 1 분 읽기

🤖
이 기사는 AI 에디터가 작성하고, 편집팀이 검수했습니다.

📑목차4개 섹션▼

Geckolib v5.5 업데이트 — 마인크래프트 3D 애니메이션 개발의 새 지평을 열다

총 4,300만 회 이상의 다운로드를 기록하며 마인크래프트 3D 애니메이션 분야의 핵심 라이브러리로 자리매김한 ‘Geckolib’ 모드가 v5.5 버전을 정식 출시했습니다. 이번 업데이트는 단순히 기능 추가를 넘어, API의 대규모 재편과 사용자 정의 옵션 확장을 통해 모드 개발자들에게 더욱 강력하고 유연한 환경을 제공하는 데 중점을 두었습니다.

2026년 3월 24일 출시된 Geckolib v5.5는 NeoForge 26.1 버전과의 호환성을 확보하며, 핵심 패키지 구조 변경, 새로운 로케이터 시스템 도입, 리소스 로딩 방식의 혁신 등 광범위한 개선 사항을 포함하고 있습니다.

주요 변경사항 상세

API 구조 대규모 재편 및 확장성 강화

Geckolib의 핵심 API 구조가 com.geckolib으로 재편되어 확장성과 유지보수성이 강화되었습니다. 렌더링 위치 감지용 GeoLocator가 추가되었고, BakedGeoModel, Animation 등 주요 클래스가 확장 가능하게 전환되어 서드파티 어댑터 개발이 용이해졌습니다. 레거시 로딩 객체 제거로 코드베이스도 간결해졌습니다.

— 광고 —
완전한 사용자 정의 리소스 포맷 지원

리소스 로딩 방식이 전면 개편되어 개발자들이 원하는 형식으로 리소스 파일을 읽을 수 있습니다. GeckoLibLoader는 등록 가능한 인터페이스로, Resource 인스턴스에 대한 루트 레벨 접근이 가능해져 커스텀 리소스 포맷 활용 및 모드 개발 유연성이 극대화되었습니다.
성능 개선 및 안정성 강화

리소스 로딩 성능이 향상되고 MathParser 최적화로 메모리 소비가 줄었습니다. RenderUtil#transformToBone 역순 실행, 중첩 본 렌더링 오류, mirror/inflate 값 미적용 등 다수의 버그가 수정되었으며, 모델을 찾지 못해도 크래시 대신 누락된 텍스처 큐브를 렌더링하여 안정성이 크게 강화되었습니다.
Minecraft 표준과의 호환성 및 개발 편의 증진

Minecraft 표준에 맞춰 렌더링 관련 BlockState, ItemStack 참조가 ItemStackRenderState, BlockModelRenderState로 전환되어 통합 기반을 마련했습니다. DataTickets 헬퍼 메서드 추가 및 재배치 등 개발 편의성도 증진되었습니다.