Iris/Oculus & GeckoLib Compat — mod para corrigir animações com shaders no Minecraft

Iris/Oculus & GeckoLib Compat — mod para corrigir animações com shaders no Minecraft

Iris/Oculus & GeckoLib Compat (também conhecido como GeckoAnimFix) é um pequeno mod do lado do cliente para Minecraft que conserta um bug específico: quando as sombras de entidades estão ativadas no pacote de shaders, as animações de mobs e outras entidades construídas sobre a biblioteca GeckoLib param de ser reproduzidas. As criaturas personalizadas congelam em uma única pose — e parecem estátuas no meio do mundo.

De onde vem o bug

A biblioteca GeckoLib é uma ferramenta comum para modelos 3D mais complexos e animação esquelética de mobs. Dezenas de mods com criaturas próprias a utilizam: para ciclos de caminhada, respiração, golpes de arma, poses agressivas etc. A renderização de uma entidade no Minecraft é, na prática, executada várias vezes por quadro — separadamente para a imagem principal e separadamente para a construção do mapa de sombras. A animação deve ser atualizada apenas em uma dessas passagens.

Quando o pacote de shaders adiciona sombras de entidades (opção Entity Shadows), o modelo do mob é desenhado novamente, agora para a passagem do shader. Nas versões antigas do GeckoLib, nessa passagem adicional o estado de animação do modelo quebra — o quadro fica preso. Sem shader ou com as sombras de entidades desativadas, o bug não aparece.

O que exatamente o mod faz

O GeckoAnimFix adiciona um pequeno ajuste ao comportamento do GeckoLib — de modo que o ciclo de animação do mob não seja reiniciado na passagem de renderização adicional ativada pelas sombras do shader. As entidades continuam a reproduzir suas animações normalmente, independentemente de qual shader esteja ativado no Iris ou no Oculus.

O mod funciona automaticamente — depois que o arquivo .jar é colocado na pasta mods/, ele não requer configurações adicionais. Nenhum comando, bloco novo ou menu dentro do jogo aparece: o jogador percebe apenas que os mobs antes quebrados voltam a se mover normalmente.

Como instalar

O procedimento de instalação é o padrão para o respectivo carregador — o arquivo .jar é colocado na pasta mods/ junto com a biblioteca GeckoLib e o mod de shaders (Iris ou Oculus). O mod não cria arquivos de serviço separados no jogo.

Um detalhe que vale a pena observar: a versão do mod deve coincidir exatamente com a versão do Minecraft e do carregador. A compilação para Forge não roda no Fabric e vice-versa, mesmo que o número da versão do jogo seja o mesmo. Na página do Modrinth, na lista de arquivos, está indicado separadamente para cada versão do jogo qual carregador o .jar específico suporta.

Conclusão

Iris/Oculus & GeckoLib Compat resolve uma tarefa bem específica: devolve a vida às animações de mobs personalizados no Minecraft quando o usuário não quer abrir mão das sombras do seu pacote de shaders. Faz mais sentido jogando em modpacks antigos 1.18.2–1.19.4 e no início do 1.20, onde o GeckoLib ainda não continha sua própria correção. A limitação é transparente: para versões recentes do GeckoLib o mod já é supérfluo e pode até atrapalhar mods com animação complexa. A alternativa é simplesmente atualizar a própria biblioteca GeckoLib para a 4.x ou mais nova; isso torna a correção separada desnecessária, mas requer versões compatíveis dos demais mods da coleção.