Iris/Oculus & GeckoLib Compat — una mod per correggere le animazioni con gli shader in Minecraft

Iris/Oculus & GeckoLib Compat — una mod per correggere le animazioni con gli shader in Minecraft

Iris/Oculus & GeckoLib Compat (noto anche come GeckoAnimFix) è una piccola mod lato client per Minecraft che corregge un bug ben preciso: quando in uno shader pack sono attivate le ombre delle entità, le animazioni dei mob e delle altre entità basate sulla libreria GeckoLib smettono di essere riprodotte. Le creature personalizzate si bloccano in un'unica posa — e sembrano statue in mezzo al mondo.

Da dove nasce il bug

La libreria GeckoLib è uno strumento molto diffuso per modelli 3D più complessi e l'animazione scheletrica dei mob. Decine di mod con le proprie creature la utilizzano: per i cicli di camminata, la respirazione, i colpi d'arma, le pose aggressive e così via. Il rendering di un'entità in Minecraft viene in realtà eseguito più volte per fotogramma — separatamente per l'immagine principale e separatamente per costruire la mappa delle ombre. L'animazione dovrebbe aggiornarsi solo in uno di questi passaggi.

Quando uno shader pack aggiunge le ombre delle entità (l'opzione Entity Shadows), il modello del mob viene disegnato di nuovo, questa volta per il passaggio dello shader. Nelle vecchie versioni di GeckoLib, lo stato di animazione del modello si rompe in questo passaggio aggiuntivo — il fotogramma rimane bloccato. Senza shader, o con le ombre delle entità disattivate, il bug non si manifesta.

Cosa fa esattamente la mod

GeckoAnimFix aggiunge una piccola modifica al comportamento di GeckoLib — una modifica che impedisce che il ciclo di animazione di un mob venga reimpostato nel passaggio di rendering aggiuntivo attivato dalle ombre degli shader. Le entità continuano a riprodurre le loro animazioni normalmente, indipendentemente da quale shader specifico sia attivato in Iris o Oculus.

La mod funziona automaticamente — una volta che il file .jar si trova nella cartella mods/, non richiede alcuna configurazione aggiuntiva. Non compaiono comandi, nuovi blocchi o menu di gioco: il giocatore nota soltanto che i mob prima rotti tornano a muoversi normalmente.

Come installarla

La procedura di installazione è quella standard per il loader corrispondente — il file .jar viene messo nella cartella mods/ insieme alla libreria GeckoLib e alla mod degli shader (Iris o Oculus). La mod non crea file di servizio separati nel gioco.

Un dettaglio a cui prestare attenzione: la versione della mod deve corrispondere esattamente alla versione di Minecraft e a quella del loader. Una build per Forge non si avvierà su Fabric e viceversa, anche se il numero di versione del gioco è lo stesso. Sulla pagina di Modrinth, l'elenco dei file indica separatamente, per ogni versione del gioco, quale loader supporta un determinato .jar.

Conclusione

Iris/Oculus & GeckoLib Compat risolve un compito molto circoscritto: riporta in vita le animazioni dei mob personalizzati in Minecraft quando l'utente non vuole rinunciare alle ombre del proprio shader pack. Ha più senso quando si gioca con vecchi modpack 1.18.2–1.19.4 e con la prima 1.20, dove GeckoLib non includeva ancora una propria correzione. Il limite è chiaro: per le versioni recenti di GeckoLib la mod è ormai superflua e può persino interferire con mod dalle animazioni complesse. L'alternativa è un semplice aggiornamento della libreria GeckoLib stessa alla 4.x o più recente; questo rende inutile una correzione separata, ma richiede versioni compatibili del resto delle mod nell'assemblaggio.