Iris/Oculus & GeckoLib Compat — Minecraft에서 셰이더로 인한 애니메이션 문제를 고치는 모드

Iris/Oculus & GeckoLib Compat — Minecraft에서 셰이더로 인한 애니메이션 문제를 고치는 모드

Iris/Oculus & GeckoLib Compat(GeckoAnimFix라고도 함)는 한 가지 특정 버그를 고치는 작은 클라이언트 측 Minecraft 모드입니다. 셰이더팩에서 엔티티 그림자를 켜면 GeckoLib 라이브러리를 기반으로 만들어진 몹과 기타 엔티티의 애니메이션이 더 이상 재생되지 않습니다. 커스텀 생물이 하나의 자세로 굳어버려 세계 한가운데 서 있는 조각상처럼 보입니다.

버그가 발생하는 원인

GeckoLib 라이브러리는 더 복잡한 3D 모델과 몹의 스켈레탈 애니메이션을 위한 널리 쓰이는 도구입니다. 자체 생물을 가진 수십 개의 모드가 걷기 순환, 호흡, 무기 휘두르기, 공격 자세 등을 위해 이 라이브러리를 사용합니다. Minecraft에서 엔티티 렌더링은 사실상 한 프레임 동안 여러 번 수행됩니다. 즉, 기본 화면용으로 한 번, 그림자 맵 구성용으로 따로 한 번 수행됩니다. 애니메이션은 이 패스 중 단 하나에서만 갱신되어야 합니다.

셰이더팩이 엔티티 그림자(Entity Shadows 옵션)를 추가하면 몹의 모델이 셰이더 패스를 위해 다시 그려집니다. 구버전 GeckoLib에서는 이 추가 패스에서 모델의 애니메이션 상태가 깨져 프레임이 멈춰버립니다. 셰이더가 없거나 엔티티 그림자가 꺼져 있으면 이 버그가 나타나지 않습니다.

이 모드가 정확히 하는 일

GeckoAnimFix는 GeckoLib의 동작에 작은 수정을 추가하여, 셰이더 그림자로 인해 활성화되는 추가 렌더링 패스에서 몹의 애니메이션 순환이 초기화되지 않도록 합니다. 엔티티는 Iris나 Oculus에서 어떤 셰이더가 켜져 있든 관계없이 평소대로 애니메이션을 계속 재생합니다.

이 모드는 자동으로 작동합니다. .jar 파일이 mods/ 폴더에 들어가면 추가 설정이 필요하지 않습니다. 어떤 명령어나 새 블록, 게임 내 메뉴도 나타나지 않습니다. 플레이어는 이전에 깨졌던 몹이 다시 정상적으로 움직인다는 것만 알아차립니다.

설치 방법

설치 절차는 해당 로더에 표준적인 방식입니다. .jar 파일을 GeckoLib 라이브러리와 셰이더 모드(Iris 또는 Oculus)와 함께 mods/ 폴더에 넣습니다. 이 모드는 게임 내에 별도의 서비스 파일을 생성하지 않습니다.

주의해야 할 한 가지 점은, 모드 버전이 Minecraft 버전 및 로더와 정확히 일치해야 한다는 것입니다. Forge용 빌드는 게임 버전 번호가 같더라도 Fabric에서 실행되지 않으며 그 반대도 마찬가지입니다. Modrinth 페이지의 파일 목록에는 각 게임 버전별로 어떤 .jar가 어떤 로더를 지원하는지 따로 표시되어 있습니다.

결론

Iris/Oculus & GeckoLib Compat는 하나의 좁은 과제를 해결합니다. 사용자가 셰이더팩의 그림자를 포기하고 싶지 않을 때 Minecraft에서 커스텀 몹의 애니메이션에 다시 생기를 불어넣습니다. 가장 큰 의미가 있는 경우는 GeckoLib가 아직 자체 수정을 포함하지 않았던 구형 모드팩 1.18.2–1.19.4와 초기 1.20에서 플레이할 때입니다. 한계는 명확합니다. 최신 버전의 GeckoLib에서는 이 모드가 이미 불필요하며 복잡한 애니메이션을 가진 모드에 방해가 될 수도 있습니다. 대안은 GeckoLib 라이브러리 자체를 4.x 이상으로 단순히 업데이트하는 것입니다. 이렇게 하면 별도의 수정이 필요 없어지지만 빌드 내 나머지 모드의 호환 버전이 필요합니다.