Artifacts aktualisieren

Artifacts aktualisieren

Artifacts sind der Kern deines FiveM-Servers: die FXServer-Dateien (die „Engine"), die alles zum Laufen bringen. Regelmäßiges Aktualisieren ist wichtig für Stabilität, Performance und Sicherheit. In diesem Artikel erklären wir, was Artifacts genau sind, warum du sie aktualisieren solltest und wie du das machst.

Was sind Artifacts?

Wenn dein FiveM-Server ein Auto ist, dann sind die Artifacts der Motor. Es sind die offiziell von Cfx.re (dem Team hinter FiveM) veröffentlichten Binaries von FXServer. Sie enthalten:

• Die Server-Engine, die alles antreibt
• Netzwerkcode für die Verbindung zwischen Spielern
• OneSync-Funktionalität
• Bugfixes und Sicherheitsupdates
• Neue Features und Verbesserungen

Artifacts werden mit einer Build-Nummer bezeichnet, z. B. 7290 oder 8350. Je höher die Nummer, desto neuer die Version.

Warum Aktualisieren wichtig ist

Es gibt mehrere Gründe, deine Artifacts aktuell zu halten:

• Sicherheitsupdates – Ältere Versionen können Schwachstellen enthalten, die von Angreifern ausgenutzt werden können. Updates schließen diese Lücken.
• Bugfixes – Abstürze, Speicherlecks und andere Probleme werden in neuen Versionen regelmäßig behoben.
• Kompatibilität – Neue Resources und Scripts erfordern manchmal eine minimale Artifact-Version. Wenn du zu weit zurückbleibst, funktionieren bestimmte Resources nicht mehr.
• Performance – Neuere Artifacts enthalten oft Optimierungen, die deinen Server flüssiger laufen lassen.
• Neue Features – Cfx.re fügt regelmäßig neue Möglichkeiten hinzu, wie verbessertes OneSync, neue Native-Funktionen und mehr.

Faustregel: Überprüfe mindestens einmal im Monat, ob eine neue empfohlene Version verfügbar ist, und aktualisiere, wenn dies der Fall ist.

Build-Typen

Auf der Artifact-Download-Seite von Cfx.re findest du verschiedene Build-Typen. Es ist wichtig, den Unterschied zu kennen:

• Recommended (empfohlen) – Dies ist die stabilste Version, die von Cfx.re getestet und freigegeben wurde. Verwende diese für Produktionsserver. Dies ist immer die sicherste Wahl.
• Latest (neueste) – Der aktuellste Build mit den neuesten Features und Fixes. Kann manchmal noch kleine, unentdeckte Bugs enthalten. Geeignet, wenn du die neuesten Funktionen testen möchtest, aber mit einem kleinen Risiko für Instabilität.
• Critical (kritisch) – Ein spezieller Build, der veröffentlicht wird, wenn ein schwerwiegender Sicherheits- oder Stabilitätsbug entdeckt wurde. Wenn ein Critical Build verfügbar ist, aktualisiere so schnell wie möglich.
• Optional – Zwischenbuilds mit spezifischen Fixes. Nur aktualisieren, wenn du unter dem Problem leidest, das darin behoben wurde.

Bild: hier muss ein Screenshot der Cfx.re-Artifacts-Download-Seite mit den verschiedenen Build-Typen eingefügt werden

Aktualisieren über das Panel (Startup-Tab)

Der einfachste Weg, deine Artifacts zu aktualisieren, ist über das HytaleNode-Panel. So geht es:

1. Gehe zu mijn.hytalenode.nl und öffne deinen FiveM-Server.
2. Klicke auf den Tab Startup im linken Menü.
3. Suche das Feld FIVEM_VERSION oder Artifact Version.
4. Trage hier die Build-Nummer der gewünschten Version ein (z. B. 7290). Die neueste empfohlene Build-Nummer findest du auf der Cfx.re-Website unter Artifacts.
5. Klicke auf Speichern oder bestätige die Änderung.
6. Installiere den Server neu, falls erforderlich (einige Setups erfordern eine Neuinstallation, um die neuen Artifacts herunterzuladen). Dies tust du über den Tab Settings mit der Schaltfläche Reinstall Server.
7. Starte den Server neu.

Bild: hier muss ein Screenshot des Startup-Tabs mit dem FIVEM_VERSION-Feld im Panel eingefügt werden

Achtung: Bei der Neuinstallation werden nur die Serverdateien (Artifacts) erneut heruntergeladen. Deine Resources, server.cfg und andere Dateien bleiben erhalten. Erstelle zur Sicherheit trotzdem immer ein Backup, bevor du große Updates durchführst.

Aktualisieren über den Build-Picker (empfohlen)

Für FiveM-Server gibt es eine eigene Seite mit visuellem Build-Picker (Route /server/:id/fivem-version):

1. Öffne deinen FiveM-Server im Panel
2. Klicke im Menü auf Build
3. Wähle eine Build:
   • Empfohlen (automatisch) - stabile Produktions-Build
   • Neueste (automatisch) - aktuellste Build
   • Spezifische Build - exakte Buildnummer aus der Liste
4. Klicke auf Speichern und bestätige die Warnung
5. Der Server wird neu installiert - server.cfg und Resources bleiben erhalten

Wichtig: beim Build-Wechsel wird der Server neu installiert. Nur FXServer-Dateien werden ersetzt. Erstelle vorher ein Backup.

Der Build-Picker ist die empfohlene Methode. Alternativ kannst du auch manuell über den Tab Startup (FIVEM_VERSION) aktualisieren.

Manuelles Aktualisieren über Dateien

Wenn du mehr Kontrolle möchtest, kannst du Artifacts auch manuell aktualisieren:

1. Gehe zur offiziellen Cfx.re-Artifacts-Seite und lade den gewünschten Linux-Build herunter (dein Server läuft auf Linux).
2. Öffne den Tab Dateien im Panel.
3. Navigiere zum Ordner, in dem die aktuellen Artifacts liegen (meist das Hauptverzeichnis oder ein alpine-Unterordner).
4. Lade die neuen Artifact-Dateien hoch und überschreibe die alten Dateien.
5. Starte den Server neu.

Wichtig: Lade immer die Linux-Version der Artifacts herunter, nicht die Windows-Version. Dein FiveM-Server bei HytaleNode läuft in einer Linux-Umgebung.

Tipps beim Aktualisieren

• Erstelle immer ein Backup – Bevor du Artifacts aktualisierst, erstelle ein Backup deiner aktuellen Serverdateien. Falls etwas schiefgeht, kannst du immer zurück.
• Lies das Changelog – Cfx.re veröffentlicht bei jedem Build, was geändert wurde. Lies es durch, damit du weißt, was dich erwartet.
• Teste nach dem Update – Starte deinen Server nach dem Update und überprüfe, ob alles funktioniert. Schaue, ob Fehler in der Konsole erscheinen, und teste, ob du eine Verbindung herstellen kannst.
• Warte kurz mit der neuesten Version – Wenn gerade ein neuer Build veröffentlicht wurde, warte ein paar Tage, es sei denn, es ist ein Critical Build. So werden eventuelle Probleme zuerst von anderen entdeckt.