- Mixin ist eine Java-Bibliothek, die die kompilierten Klassen von Minecraft während des Ladens verändert.
- Mods beschreiben, wo Code injiziert werden soll, nicht wie die Datei aussieht, sodass Patches Spielupdates überleben.
- Fabric basiert auf Mixin und wendet die Mixins jedes Mods während des Klassenladens an.
- Mixin installiert man nie selbst; der Loader bündelt es.
Mixin ist eine Java-Bibliothek, die einem Mod ermöglicht, die kompilierten Klassen von Minecraft zu patchen, während das Spiel geladen wird, ohne den ursprünglichen Quellcode zu bearbeiten. Mods schreiben kleine Klassen, die angeben: "Füge diesen Code an diesem Punkt in dieser Spielmethode hinzu", und Mixin verwebt sie zur Laufzeit in den Bytecode. Fabric verwendet sie als zentralen Mechanismus für Modding.
Wo Opal passt
Opal ist ein Fabric-Mod, der unter der Haube auf Mixin aufbaut. Mixin wird nicht separat installiert; der Einrichtungsleitfaden behandelt, wie Opal und Fabric zum Laufen gebracht werden.
Wie Mixin funktioniert
Mixin bearbeitet Klassen, nachdem sie kompiliert wurden, aber bevor die JVM sie ausführt. Ein Mod liefert eine Mixin-Klasse, die eine echte Spielklasse anvisiert. Annotationen auf dieser Klasse kennzeichnen, wo der injizierte Code eingefügt werden soll: den Beginn einer Methode, das Ende, einen bestimmten Methodenaufruf oder einen Rückgabewert. Wenn Minecraft die Zielklasse lädt, überschreibt Mixin ihren Bytecode, um den Code des Mods einzufügen.
Das ist wichtig, weil Minecraft nicht für Erweiterungen konzipiert ist. Das Spiel hat keine offiziellen Plugin-Punkte für die meisten Verhaltensweisen. Mixin gibt Mods einen Weg hinein, indem es das kompilierte Spiel selbst als Erweiterungsfläche behandelt.
Warum Mods es anstelle der Bearbeitung des Spiels verwenden
Zwei Gründe: Kompatibilität und Updates.
Die direkte Bearbeitung des Quellcodes des Spiels bedeutet, eine komplett modifizierte Kopie zu versenden, auf der niemand aufbauen kann und die beim nächsten Spiel-Update kaputt geht. Mixin-Patches sind klein und präzise, sodass viele Mods dasselbe Spiel patchen können, ohne jeweils eine vollständige Abzweigung versenden zu müssen.
Die Patches beschreiben auch, wo Code injiziert werden soll, anstatt wie die Datei aussieht, sodass ein Mixin, das gegen eine bestimmte Version geschrieben wurde, oft noch anwendbar ist, nachdem ein Spiel-Update erfolgt ist, solange die Zielmethode noch existiert.
Wie es mit Fabric zusammenpasst
Fabric basiert auf Mixin. Der Loader liest die Mixin-Konfiguration jedes Mods und übergibt dann die aufgelisteten Mixin-Klassen an Mixin, damit diese während des Klassenladens angewendet werden. Ein typischer Fabric-Mod besteht hauptsächlich aus den eigenen Klassen des Mods plus einer Handvoll Mixins, die die wenigen Spielmethoden ändern, die er benötigt.
Häufige Injektionspunkte
| Annotation | Was sie tut |
|---|---|
@Inject | Führt deinen Code an einem gewählten Punkt innerhalb einer Zielmethode aus |
@Redirect | Ersetzt einen bestimmten Methodenaufruf innerhalb der Zielmethode |
@ModifyArg | Ändert ein Argument, das an einen Aufruf innerhalb der Zielmethode übergeben wird |
@ModifyVariable | Überschreibt eine lokale Variable während der Ausführung der Methode |
@Overwrite | Ersetzt eine ganze Methode (letzte Möglichkeit; bricht leicht) |
@Inject ist das Standardwerkzeug, da es am wenigsten invasiv ist und am wahrscheinlichsten ein Spielupdate übersteht. @Overwrite wird vermieden, da es mit anderen Mods in Konflikt gerät, die dieselbe Methode ändern.
FAQ
Nein. Mixin ist eine Bibliothek, mit der Mods erstellt werden. Es wird nicht eigenständig installiert; ein Loader wie Fabric bündelt es und wendet die Mixins an, die deine Mods bereitstellen.
Nein. Die Patches finden im Speicher statt, während Klassen geladen werden. Die Dateien auf der Festplatte bleiben unberührt, weshalb das Entfernen eines Mods seine Änderungen sauber beseitigt.
Wenn beide die gleiche Methode auf inkompatible Weise patchen, insbesondere mit @Overwrite, kann der eine den anderen aufheben oder unterbrechen. Gut geschriebene Mixins verwenden präzise Injektionspunkte, um sich gegenseitig nicht in die Quere zu kommen.
Nein. Mixin ist ein allgemeines Java-Bytecode-Framework, aber im Bereich der Minecraft-Modifizierung wird es am häufigsten eingesetzt. Die Übernahme durch Fabric hat es dort zum Standard gemacht.
