FiveM-Artifacts und Fake-Spieler: Kompatibilitätshandbuch

FiveM-Artifacts sind versionierte Server-Builds, die die Game-Server-Runtime, den Ressourcen-Loader und den Verbindungshandling-Code enthalten. Jedes Mal, wenn Rockstar ein GTA-Update veröffentlicht oder das FiveM-Team Plattformänderungen ausliefert, wird die Artifact-Build-Nummer erhöht. Die Fake-Spieler-Kompatibilität ist an das Artifact gebunden, weil sich das Verbindungshandshake-Verhalten, das Ihr Server erwartet, mit jeder Build-Generation ändert. Ihren Build in einem getesteten Bereich zu halten, ist das, was unserem FiveM-Fake-Spieler-Dienst — den Bot-Spielern, die Ihre Server-Population auffüllen — eine zuverlässige Verbindung ermöglicht.

Dieser Beitrag erklärt, was Artifacts sind, welche Build-Bereiche für Fake-Spieler-Verbindungen stabil sind, wie Sie Ihren aktuellen Build prüfen, wie Sie Ihren Server an eine getestete Version pinnen und was zu tun ist, wenn ein Spiel-Update den Handshake ändert. Für den größeren Zusammenhang erklärt der vollständige FiveM-Fake-Spieler-Leitfaden, wie das gesamte System zusammenpasst.

Was FiveM-Artifacts sind und warum sie wichtig sind

Wenn Sie einen FiveM-Server installieren, laden Sie ein Server-Artifact herunter: eine kompilierte Binärdatei, die den FiveM-Server-Ausführer (FXServer), die Lua-Runtime, das Ressourcensystem und die Netzwerkschicht enthält, die Client-Verbindungen verwaltet. Die Artifact-Versionsnummer identifiziert, welchen Build all dieses Codes Sie ausführen.

Artifact-Builds werden fortlaufend veröffentlicht. Das FiveM-Team pflegt drei Release-Kanäle: recommended, optional und latest. Recommended-Builds sind die stabilsten. Optional-Builds enthalten neuere Funktionen, die interne Tests aber nicht vollständige Betreibertests bestanden haben. Latest-Builds sind die neuesten und enthalten Änderungen, die möglicherweise nicht stabil sind.

Der Grund, warum Artifacts für die Fake-Spieler-Kompatibilität wichtig sind, ist, dass der Verbindungshandshake im Artifact implementiert ist. Wenn das Artifact ändert, wie es eingehende Verbindungen validiert, muss unsere Fake-Spieler-Verbindungsschicht aktualisiert werden, um zu entsprechen. Wenn Sie Ihr Artifact aktualisieren, bevor wir unsere Verbindungsschicht aktualisieren, scheitern Fake-Spieler-Handshakes.

So prüfen Sie Ihren aktuellen Artifact-Build

Es gibt drei Möglichkeiten, Ihre aktuelle Artifact-Build-Nummer zu finden.

1. txAdmin-Dashboard: Die Build-Nummer erscheint unten links auf der txAdmin-Übersichtsseite unter Serverinformationen.
2. Server-Konsole: Führen Sie den Befehl convar_print sv_fxdk_build in der Server-Konsole aus. Die Ausgabe enthält die Artifact-Build-Nummer.
3. FXServer-Ausführer: Unter Linux führen Sie ./FXServer --version aus Ihrem Server-Verzeichnis aus. Die Ausgabe enthält die Build-Nummer.

Sobald Sie Ihre Build-Nummer aus dem txAdmin-Dashboard oder der Server-Konsole haben, prüfen Sie diese gegen die Kompatibilitätstabelle in Ihrem FiveFake-Dashboard. Die Tabelle zeigt die minimalen und maximalen Build-Nummern in jedem getesteten Bereich, den Status (vollständig kompatibel, eingeschränkte Kompatibilität oder inkompatibel) und das Datum, an dem jeder Bereich zuletzt getestet wurde.

Stabile Build-Bereiche für Fake-Spieler-Verbindungen

Wir pflegen eine Live-Kompatibilitätstabelle im Dashboard, da sich Build-Bereiche ändern, wenn neue Artifacts veröffentlicht und getestet werden. Das allgemeine Muster über Build-Generationen hinweg ist:

• Builds innerhalb des aktuellen recommended Kanals: vollständig getestet, Verbindungsschicht ist für diesen Bereich kalibriert.
• Builds 100 bis 200 Versionen hinter dem aktuellen recommended: typischerweise kompatibel, da sich Handshake-Parameter innerhalb einer Hauptspielversion selten ändern.
• Builds mehr als 300 Versionen hinter dem aktuellen recommended: können Kompatibilitätslücken haben, je nachdem, was sich in den Zwischenbuilds geändert hat.
• Builds auf dem latest-Kanal mehr als 50 Builds vor recommended: ungetestet, Verbindungsverhalten kann sich geändert haben, bevor wir Zeit hatten zu aktualisieren.

So pinnen Sie Ihre Artifact-Version

Das Pinnen Ihres Artifacts an eine bestimmte Build-Nummer verhindert versehentliche Upgrades, die die Fake-Spieler-Kompatibilität brechen. Der Ansatz unterscheidet sich je nach Hosting Ihres Servers.

Pinnen über txAdmin

txAdmin hat eine eingebaute Artifact-Verwaltungsfunktion. Im Server-Einstellungsbereich können Sie die Artifact-Version auf eine bestimmte Build-Nummer setzen. txAdmin wird das Artifact nicht automatisch über diesen Build hinaus aktualisieren. Wenn Sie aktualisieren möchten, ändern Sie die gepinnte Version manuell und wenden die Änderung an.

Pinnen über direkte Dateiverwaltung

Wenn Sie Ihren Server ohne txAdmin oder mit einer benutzerdefinierten Einrichtung verwalten, erfolgt das Pinnen durch direktes Herunterladen des spezifischen Artifact-Builds von der FiveM-Artifacts-Seite und Platzieren in Ihrem Server-Verzeichnis. Führen Sie keine automatischen Update-Skripte aus, die beim Start das neueste Artifact abrufen.

Die FiveM-Artifacts-Downloadseite unter runtime.fivem.net/artifacts/fivem/ listet alle verfügbaren Builds für Windows und Linux auf. Sie können jeden historischen Build nach seiner Build-Nummer herunterladen. Speichern Sie die Build-Nummer Ihrer aktuellen stabilen Konfiguration, damit Sie bei Problemen durch ein Update darauf zurückkehren können.

Was passiert, wenn ein Spiel-Update die Kompatibilität bricht

Wenn ein großes GTA-Update erscheint, ändert es typischerweise die clientseitige Spielversion, die FiveM-Clients übereinstimmen müssen, um sich mit Servern zu verbinden. Dies propagiert sich als neuer Build zum Server-Artifact, der aktualisierte Verbindungsvalidierung für die neue Spielversion enthält. Wenn unsere Verbindungsschicht für die neue Spielversion nicht aktualisiert wurde, schlagen Fake-Spieler-Handshakes fehl, weil die Client-Version, die unsere Verbindungen melden, nicht mehr akzeptiert wird.

Unser Update-Prozess nach einer Spielversionsänderung:

1. Wir erkennen die neue Spielversion aus öffentlichen FiveM-Release-Kanälen innerhalb von Stunden nach dem Erscheinen des Updates.
2. Unser Team validiert, welche Artifact-Builds betroffen sind und wie die Handshake-Parameter-Änderungen aussehen.
3. Wir aktualisieren unsere Verbindungsschicht, um die neuen Versionsparameter zu verarbeiten.
4. Wir testen gegen Server, die den neuen recommended Artifact-Build ausführen.
5. Wir deployen die aktualisierte Verbindungsschicht auf unsere Produktions-Knoten.
6. Wir kündigen das Update im Discord und auf der Dashboard-Statusseite an.

Dieser Prozess dauert typischerweise 24 bis 48 Stunden vom Erscheinen des Spiel-Updates bis zur Live-Schaltung unseres Verbindungsschicht-Updates. Während dieses Fensters können Fake-Spieler-Verbindungen auf Servern, die ihr Artifact zur Anpassung an die neue Spielversion aktualisiert haben, fehlschlagen oder reduzierte Zuverlässigkeit aufweisen.

Artifact-Updates durchführen ohne Ihre Fake-Spieler zu stören

Der sicherste Ansatz für Artifact-Updates beim Betrieb von Fake-Spielern ist ein dreistufiger Prozess:

1. Warten Sie, bis das FiveM-Team nach einem Spiel-Update einen Build als recommended bezeichnet.
2. Prüfen Sie die FiveFake-Dashboard-Kompatibilitätstabelle, um zu bestätigen, dass der recommended Build in unserem getesteten Bereich liegt.
3. Erst dann aktualisieren Sie Ihr Artifact und konfigurieren ggf. Ihre Fake-Spieler neu.

Wenn Sie Ihr Artifact aus anderen Gründen sofort aktualisieren müssen (ein kritischer Server-Bug, ein Ressourcen-Kompatibilitätsproblem), pausieren Sie Ihre Fake-Spieler-Planung vor dem Update. Überprüfen Sie nach dem Update, ob Ihre Fake-Spieler sich neu verbinden, bevor Sie die Planung fortsetzen.

Anti-Detection und Artifact-Versionsinteraktion

Die Artifact-Versionskompatibilität ist direkt mit der Anti-Detection-Wirksamkeit verbunden. Die Verbindungsparameter, die unsere Fake-Spieler für Anticheat-Systeme legitim erscheinen lassen, sind für bestimmte Artifact-Builds kalibriert. Das Ausführen unserer Verbindungsschicht gegen eine Artifact-Version außerhalb unseres getesteten Bereichs birgt nicht nur das Risiko von Verbindungsfehlern. Es birgt auch das Risiko von Verbindungen, die sich korrekt genug verhalten, um zu verbinden, aber falsch genug, um bei der Anticheat-Validierung markiert zu werden.

Dies ist das stärkste Argument dafür, in unserem dokumentierten kompatiblen Artifact-Bereich zu bleiben: Es geht nicht nur darum, ob Ihre Spieler verbinden, sondern ob sie auf eine Weise verbinden, die die Prüfungen besteht, die Ihr Anticheat-System durchführt.

Windows- versus Linux-Artifact-Überlegungen

FiveM-Artifacts sind für Windows und Linux verfügbar. Die meisten Hosting-Anbieter, die FiveM-Server-Pläne anbieten, verwenden Linux. Die Artifact-Build-Nummern sind auf beiden Plattformen gleich, aber es gibt gelegentlich plattformspezifische Bugs, bei denen sich ein Build auf Windows anders verhält als auf Linux. Unsere Kompatibilitätstests umfassen beide Plattformen, und die Dashboard-Kompatibilitätstabelle vermerkt plattformspezifische Probleme, wenn sie existieren.

FiveFake-Fake-Spieler-Verbindungen sind auf unserer Seite plattformunabhängig, da es sich um Netzwerkverbindungen zu Ihrem Server-Endpoint handelt, nicht um Integrationen mit dem Betriebssystem Ihres Servers. Was zählt, ist die Artifact-Build-Nummer und das Handshake-Verhalten, nicht ob Ihr Host Windows oder Linux verwendet.

So melden Sie ein Kompatibilitätsproblem

Wenn Sie eine Artifact-Version betreiben, die unser Dashboard als kompatibel anzeigt, aber Ihre Fake-Spieler sich nicht verbinden, sind die nützlichsten Informationen, die Sie beim Öffnen eines Support-Tickets bereitstellen können:

1. Ihre Artifact-Build-Nummer (prüfen Sie die txAdmin-Übersicht oder die Server-Konsole).
2. Die Fehlermeldung oder den Kick-Grund, der in Ihrer txAdmin-Konsole für die fehlgeschlagenen Verbindungen angezeigt wird.
3. Ob das Problem nach einem bestimmten Artifact-Update begann oder seit Ihrer ersten Aktivierung vorhanden war.
4. Welche Anticheat-Systeme auf Ihrem Server laufen und deren Versionsnummern, falls verfügbar.
5. Ob das Problem alle Fake-Spieler oder nur einige betrifft (partielle Verbindungsfehler deuten auf Slot-Limits hin, vollständige Fehler deuten auf Handshake-Probleme hin).

Kompatibilitätsprobleme, die mit diesen Informationen gemeldet werden, werden typischerweise innerhalb von 24 Stunden behoben, da die diagnostischen Informationen es uns ermöglichen, das Problem sofort auf unserer Testinfrastruktur zu reproduzieren. Wenn sich das Problem als langsame Aktivierung statt als Kompatibilitätsfehler herausstellt, beschreibt der Aktivierungsgeschwindigkeits-Leitfaden die häufigen Ursachen.

Nächste Schritte

Wenn Sie einen neuen Server einrichten und sicherstellen möchten, dass Ihre txAdmin-Konfiguration korrekt ist, bevor Sie Fake-Spieler aktivieren, deckt die

den vollständigen Verbindungseinrichtungsprozess einschließlich Artifact-Auswahl und txAdmin-Panel-Konfiguration ab.

Sobald Sie wissen, welche Artifact-Version Ihr Server verwendet und die Kompatibilität bestätigt haben, befinden sich die benötigten FiveFake-Dateien auf der Seite Ihres Servers im FiveFake Dashboard. Jede Server-Seite hat einen Download-Button. Klicken Sie darauf, wählen Sie die Artifact-Version, die zu Ihrem FiveM-Server-Build passt, und legen Sie die resultierenden Dateien in Ihren Ressourcen-Ordner.