Iris/Oculus & GeckoLib Compat — eine Mod zur Behebung von Animationen mit Shadern in Minecraft

Iris/Oculus & GeckoLib Compat — eine Mod zur Behebung von Animationen mit Shadern in Minecraft

Iris/Oculus & GeckoLib Compat (auch bekannt als GeckoAnimFix) ist eine kleine clientseitige Mod für Minecraft, die einen ganz bestimmten Fehler behebt: Wenn in einem Shaderpack die Entity-Schatten aktiviert sind, werden die Animationen von Mobs und anderen auf der Bibliothek GeckoLib aufgebauten Entitäten nicht mehr abgespielt. Benutzerdefinierte Kreaturen erstarren in einer einzigen Pose — und sehen aus wie Statuen mitten in der Welt.

Woher der Fehler kommt

Die Bibliothek GeckoLib ist ein weit verbreitetes Werkzeug für komplexere 3D-Modelle und die Skelettanimation von Mobs. Dutzende Mods mit eigenen Kreaturen verwenden sie: für Gehzyklen, Atmen, Waffenschwünge, aggressive Posen und so weiter. Das Rendern einer Entität in Minecraft wird tatsächlich mehrmals pro Frame ausgeführt — separat für das Hauptbild und separat zum Erstellen der Schattenkarte. Die Animation sollte nur in einem dieser Durchläufe aktualisiert werden.

Wenn ein Shaderpack Entity-Schatten hinzufügt (die Option Entity Shadows), wird das Mob-Modell erneut gezeichnet, diesmal für den Shader-Durchlauf. In älteren Versionen von GeckoLib bricht der Animationszustand des Modells in diesem zusätzlichen Durchlauf zusammen — der Frame bleibt hängen. Ohne Shader oder bei deaktivierten Entity-Schatten tritt der Fehler nicht auf.

Was die Mod genau tut

GeckoAnimFix fügt dem Verhalten von GeckoLib eine kleine Anpassung hinzu — eine, die verhindert, dass der Animationszyklus eines Mobs in dem zusätzlichen, durch Shader-Schatten ausgelösten Render-Durchlauf zurückgesetzt wird. Entitäten spielen ihre Animationen weiterhin normal ab, unabhängig davon, welcher Shader genau in Iris oder Oculus aktiviert ist.

Die Mod funktioniert automatisch — sobald die .jar-Datei im Ordner mods/ liegt, benötigt sie keine zusätzliche Konfiguration. Es erscheinen keine Befehle, neuen Blöcke oder Ingame-Menüs: Der Spieler bemerkt nur, dass sich zuvor kaputte Mobs wieder normal bewegen.

Wie man sie einrichtet

Der Installationsvorgang ist für den jeweiligen Loader Standard — die .jar-Datei wird zusammen mit der Bibliothek GeckoLib und der Shader-Mod (Iris oder Oculus) in den Ordner mods/ gelegt. Die Mod erstellt keine separaten Dienstdateien im Spiel.

Ein Detail, auf das man achten sollte: Die Mod-Version muss genau mit der Minecraft-Version und dem Loader übereinstimmen. Eine Build für Forge läuft nicht auf Fabric und umgekehrt, selbst wenn die Versionsnummer des Spiels dieselbe ist. Auf der Modrinth-Seite ist in der Dateiliste für jede Spielversion separat gekennzeichnet, welchen Loader eine bestimmte .jar unterstützt.

Fazit

Iris/Oculus & GeckoLib Compat löst eine eng umrissene Aufgabe: Sie erweckt die Animationen benutzerdefinierter Mobs in Minecraft wieder zum Leben, wenn der Nutzer nicht auf die Schatten in seinem Shaderpack verzichten möchte. Am meisten Sinn ergibt das beim Spielen mit alten Modpacks 1.18.2–1.19.4 und frühem 1.20, wo GeckoLib noch keine eigene Korrektur enthielt. Die Einschränkung ist klar: Für frische Versionen von GeckoLib ist die Mod bereits überflüssig und kann sogar Mods mit komplexen Animationen stören. Die Alternative ist ein einfaches Update der Bibliothek GeckoLib selbst auf 4.x oder neuer; das macht einen separaten Fix überflüssig, erfordert aber kompatible Versionen der übrigen Mods im Build.