Was ist kq_link? Die Bridge hinter den KuzQuality Scripts

Wenn du schon ein KuzQuality-Script installiert hast, ist dir vielleicht aufgefallen, dass kq_link als erforderliche Abhängigkeit aufgeführt ist. Dieser Beitrag erklärt, was kq_link ist, warum es existiert und warum das Prinzip dahinter in der FiveM-Scripting-Community weit verbreitet ist.

Das Problem: FiveM-Server sind nicht standardisiert

FiveM-Server laufen auf unterschiedlichen Frameworks. Manche nutzen ESX, manche QBCore, andere QBox, vRP, TMC oder etwas komplett Eigenes. Dazu kommt, dass jeder Server andere Inventarsysteme, Targeting-Systeme und Benachrichtigungssysteme verwenden kann.

Ein Script, das direkt mit ESX kommuniziert, läuft ohne Codeänderungen nicht auf QBCore. Ein Script, das ox_target aufruft, funktioniert auf einem Server mit qb-target nicht mehr. Und ein Script, das ein bestimmtes Benachrichtigungssystem nutzt, sieht auf einem Server mit einem anderen System falsch aus.

Das ist ein Problem für jeden Script-Entwickler, der möchte, dass seine Arbeit auf mehr als einem Server-Setup läuft. Die naive Lösung: für jedes Framework eine eigene Version schreiben. Das kostet viel Zeit und ist schwer zu pflegen. Die bessere Lösung ist eine Bridge.

Was ist eine Script-Bridge?

Eine Bridge (Brücke) ist eine Ressource, die zwischen einem Script und den Abhängigkeiten des Servers sitzt. Statt ESX oder QBCore direkt aufzurufen, ruft das Script die Bridge auf. Die Bridge erkennt, welches Framework und welche Abhängigkeiten laufen, und übersetzt den Aufruf entsprechend.

Das ist kein Konzept, das es nur bei KuzQuality gibt. Die meisten ernsthaften FiveM-Script-Entwickler nutzen irgendeine Form von Bridge. Vielleicht hast du ähnliche Ressourcen wie ox_lib, jim_bridge, pp-bridge oder tw_bridge schon als Abhängigkeiten anderer Scripts gesehen. Das Prinzip ist bei allen gleich: Das Script wird einmal geschrieben, und die Bridge kümmert sich um die Unterschiede zwischen den Frameworks.

Was ist kq_link?

kq_link ist die Open-Source-Bridge von KuzQuality. Sie verbindet KuzQuality-Scripts mit dem Framework, Inventarsystem, Targeting-System und Benachrichtigungssystem, das auf dem Server läuft.

Konkret übernimmt sie Folgendes:

• Framework-Erkennung: erkennt automatisch, ob der Server ESX, QBCore, QBox, vRP, TMC oder gar kein Framework nutzt
• Inventar-Anbindung: leitet Item-Abfragen sowie das Hinzufügen und Entfernen von Items an das richtige Inventarsystem weiter
• Benachrichtigungen: sendet Benachrichtigungen über die Ressource, die der Server dafür nutzt
• Targeting-System: funktioniert mit ox_target, qb-target oder einem eingebauten 3D-Text als Fallback
• Hilfsfunktionen: gemeinsame Utilities, auf die KuzQuality-Scripts angewiesen sind, damit diese nicht in jeder Ressource neu implementiert werden müssen

Weil kq_link all das übernimmt, muss kein KuzQuality-Script wissen, welches Framework auf dem Server läuft. Das Script ruft einfach kq_link auf, und kq_link erledigt den Rest.

Warum ist kq_link eine eigene Ressource?

kq_link wird einmal installiert und von allen KuzQuality-Scripts gemeinsam genutzt. Jedes Script auf dem Server, das kq_link verwendet, profitiert von derselben Bridge, statt eine eigene Kopie desselben Codes mitzubringen.

Außerdem müssen Anpassungen an der Framework-Kompatibilität nur an einer Stelle passieren. Ändert eine neue Framework-Version etwas, wird kq_link aktualisiert, und alle KuzQuality-Scripts profitieren automatisch davon.

kq_link installieren

kq_link ist kostenlos und Open Source. Du findest es auf GitHub unter github.com/Kuzkay/kq_link.

Die Installation ist unkompliziert:

1. Lade kq_link herunter oder klone es in den Ordner resources/ deines Servers. Der Ordner muss exakt kq_link heißen. Benennst du ihn um, funktionieren alle KuzQuality-Scripts, die davon abhängen, nicht mehr.
2. Öffne server.cfg und füge ensure kq_link nach dem Framework und allen Abhängigkeiten wie Targeting- oder Benachrichtigungssystemen ein
3. Öffne kq_link/config.lua und stelle dort Framework und Abhängigkeiten ein

kq_link erkennt das Framework automatisch. Trotzdem empfehlen wir, das Framework manuell in der Config festzulegen, um Unklarheiten zu vermeiden.

Alle Details zur Installation findest du unter docs.kuzquality.com.

Zusammenfassung

Script-Bridges sind ein Standardmuster in der FiveM-Entwicklung. Sie lösen das Problem der zersplitterten Framework-Landschaft, indem sie als Übersetzungsschicht zwischen einem Script und den Abhängigkeiten des Servers dienen.

kq_link ist die KuzQuality-Version davon. Es ist kostenlos, Open Source und für alle KuzQuality-Scripts erforderlich. Einmal installieren, für das Setup des Servers konfigurieren, und jedes KuzQuality-Script funktioniert, egal welches Framework läuft.