Learn · frameworks
Was ist die Fabric API? Modding erklärt
Fabric API ist die gemeinsam genutzte Bibliothek, von der fast jedes Fabric-Modell abhängt. Hier ist, was sie tut, warum sie vom Loader getrennt existiert und ob Sie sie benötigen.
Was ist die Fabric API?
Die Fabric API ist die gemeinsame Werkzeugkiste, auf der das Fabric-Ökosystem aufbaut. Der Loader selbst kennt nur die Möglichkeit, das Spiel zu starten und Patches anzuwenden; er enthält kaum Komfortfunktionen. Die API füllt diese Lücke mit einem stabilen Satz an Ereignissen, Hilfsmitteln und Schnittstellen, sodass einzelne Mods nicht jedes Mal die gleiche Infrastruktur neu erfinden oder sich gegenseitig behindern müssen.
Betrachten Sie sie als die Standardbibliothek, die der Loader weglässt. Wenn ein Mod-Entwickler auf das Beitreten eines Spielers reagieren, ein benutzerdefiniertes Paket senden oder einen neuen Block registrieren möchte, ruft er die API auf, anstatt direkt in die Engine einzugreifen.
Warum ist die Fabric API nicht Teil des Loaders?
Fabric teilt das System absichtlich in zwei Teile auf. Der Loader ist der kleine, langsam sich ändernde Kern, der Minecraft startet und die Patch-Schicht ausführt. Die API ist das größere, schneller voranschreitende Set an gemeinsamen Schnittstellen, das darüber gestapelt ist. Durch die Trennung können beide Komponenten in ihrem eigenen Tempo voranschreiten.
| Teil | Aufgabe | Update-Rhythmus |
|---|---|---|
| Fabric Loader | Startet das Spiel, wendet Mixin-Patches an, löst Mods | Schnell auf eine neue MC-Version portiert |
| Fabric API | Gemeinsame Ereignisse, Netzwerkfunktionen, Registry, Rendering-Hilfsmittel | Entwickelt nach eigenem Zeitplan |
Der Vorteil ist die Geschwindigkeit. Wenn eine neue Minecraft-Version erscheint, kann ein kleiner Loader innerhalb von Stunden kompatibel gemacht werden, während die breite API aufholt, ohne diesen ersten Anschluss zu blockieren. Verbindet man sie miteinander, würde der gesamte Stapel nur so schnell laufen wie sein langsamster Teil.
Was bietet die Fabric API eigentlich?
Die API stellt Mods eine versionsstabile Möglichkeit bereit, Dinge zu tun, die fast jedes Mod benötigt. Anstatt dass jeder Autor zerbrechliche Hooks gegen die rohen Spielinterna schreibt, zielen sie auf eine gemeinsame Oberfläche, die die Community gemeinsam pflegt.
Lebenszyklus und Spielereignisse
Saubere Rückrufe für Ticks, Weltladen, Spielerverbindung und Blockinteraktionen, damit Mods auf das Spiel reagieren können, ohne es manuell patchen zu müssen.
Netzwerkhelfer
Eine vernünftige Möglichkeit, benutzerdefinierte Pakete zwischen Client und Server zu definieren und zu senden, das Rückgrat der meisten Mods, die Mehrspieler unterstützen.
Inhalts- und Registrierhilfen
Gemeinsame Sanitäranlagen für die Registrierung neuer Elemente, Blöcke und Entitäten, sodass zwei Mods Inhalte hinzufügen können, ohne sich gegenseitig zu behindern.
Wiedergabe- und Ressourcenhilfen
Gängige Rendering-Hooks und Ressourcen-Utilities-Mods stützen sich darauf, um HUD-, Modell- und Texturarbeiten zu ermöglichen.
Entfernt man die API, müsste jeder Modifikation eine eigene Kopie dieser Mechanismen mitliefern. Das würde zu Doppelarbeit und Divergenz führen, und sie würden sich gegenseitig zerstören, sobald man sie in einem Ordner kombiniert. Die gemeinsam genutzte Bibliothek sorgt dafür, dass eine Ansammlung von nicht zusammenhängenden Mods harmonisch zusammenarbeiten.
Benötigen Sie die Fabric API?
Fast immer, ja. Der überwiegende Teil der Fabric-Mods deklariert sie als harte Abhängigkeit, was bedeutet, dass sie ohne sie nicht geladen werden. Sie installieren sie einmal als gewöhnliche Mod-JAR-Datei in Ihrem mods-Ordner, und jede Modifikation, die sie benötigt, greift auf dieselbe Kopie zu.
- Verwendest du Fabric mit mehr als einem oder zwei Mods? Installiere die API.
- Steht auf der Seite eines Mods "Fabric API" unter den Anforderungen? Installiere sie.
- Läuft ein einzelnes, kleines, eigenständiges Mod, das explizit besagt, dass es nichts benötigt? Du kannst die API überspringen, obwohl es selten schadet, sie dabei zu behalten.
Die Kurzfassung: Behandle die Fabric API als Basis. Der Aufwand, sie zu haben, wenn du sie nicht unbedingt brauchst, ist eine zusätzliche Jar-Datei. Der Aufwand, sie zu verpassen, ist ein Absturz.
Wo du die Fabric API findest und wie du Versionen anpasst
Lade die API aus den offiziellen Fabric-Kanälen oder von den gängigen Mod-Hosts herunter und wähle die Version aus, die für deine genaue Minecraft-Version gekennzeichnet ist. Das Anpassen der Versionen ist der häufigste Fehler, der zu den lautstärksten und verwirrendsten Abstürzen führt.
Bestätigen Sie Ihre Minecraft-Version
Beachten Sie die exakte Version, mit der Ihr Profil startet, bis hin zur Patch-Nummer.
Laden Sie die passende API-Build herunter
Besorgen Sie die Fabric API-Version, die für dieselbe Version markiert ist, nicht die neueste verfügbare.
Lege es in den Mods-Ordner
Platziere das Jar zusammen mit deinen anderen Mods. Eine Kopie genügt für jeden Mod, der davon abhängt.
Starten Sie das Protokoll und lesen Sie es, falls es fehlschlägt
Wenn etwas abstürzt, nennt das Protokoll meistens die fehlende Klasse oder die erwartete Version. Diese Zeile weist direkt auf die Lösung hin.
Wenn das Jonglieren mit Loader-, API- und Mod-Versionen von Hand mühsam klingt, liegt das daran, dass es das ist. Gemanagte Launcher und Utility-Clients existieren zum Teil, um diese Abhängigkeitskette für Sie zu lösen, sodass das Spiel einfach startet.
FAQ
Nicht jeder einzelne, aber die meisten. Jedes Mod, das es als Abhängigkeit deklariert, lädt ohne es nicht. Ein paar kleine, eigenständige Mods überspringen es, aber die Installation ist der sichere Standard, weil du es wahrscheinlich brauchst, sobald du ein zweites Mod hinzufügst.
Von den offiziellen Fabric-Verteilungsstellen und den bekannten Mod-Hosts. Die einzige Regel, die zählt: Lade die Version herunter, die genau deine Minecraft-Version auflistet. Eine 1.21-Datei wird ein 1.20-Spiel nicht retten.
Absichtlich. Der Loader wird absichtlich klein gehalten, damit er sich schnell auf eine neue Minecraft-Version portieren lässt, während die größere API in ihrem eigenen Tempo weiterläuft. Durch die Trennung wird verhindert, dass der schnelllebige Teil denjenigen ausbremst, der zuerst aktualisiert werden muss.
Man erhält normalerweise beim Start einen Absturz, oft einen fehlenden Klassen- oder Methodenfehler im Log. Die Lösung ist fast immer, die inkompatible Jar-Datei zu löschen und stattdessen die API-Build-Datei einzufügen, die mit deiner Minecraft-Version übereinstimmt.
Loader, API und Mods sind für dich sortiert, ohne Versionsprobleme.