Artifacts updaten

Artifacts updaten

Artifacts zijn de kern van je FiveM-server: het zijn de FXServer-bestanden (de "engine") die alles laten draaien. Regelmatig updaten is belangrijk voor stabiliteit, prestaties en beveiliging. In dit artikel leggen we uit wat artifacts precies zijn, waarom je ze moet updaten, en hoe je dat doet.

Wat zijn artifacts?

Als je FiveM-server een auto is, dan zijn de artifacts de motor. Het zijn de officieel door Cfx.re (het team achter FiveM) uitgebrachte binaries van FXServer. Ze bevatten:

• De server-engine die alles aandrijft
• Netwerkcode voor de verbinding tussen spelers
• OneSync-functionaliteit
• Bugfixes en beveiligingsupdates
• Nieuwe features en verbeteringen

Artifacts worden aangeduid met een buildnummer, bijvoorbeeld 7290 of 8350. Hoe hoger het nummer, hoe nieuwer de versie.

Waarom updaten belangrijk is

Er zijn meerdere redenen om je artifacts up-to-date te houden:

• Beveiligingsupdates – Oudere versies kunnen kwetsbaarheden bevatten die misbruikt kunnen worden door kwaadwillenden. Updates dichten deze gaten.
• Bugfixes – Crashes, geheugenlekkages en andere problemen worden regelmatig opgelost in nieuwe versies.
• Compatibiliteit – Nieuwe resources en scripts vereisen soms een minimale artifact-versie. Als je te ver achterblijft, werken bepaalde resources niet meer.
• Prestaties – Nieuwere artifacts bevatten vaak optimalisaties die je server soepeler laten draaien.
• Nieuwe features – Cfx.re voegt regelmatig nieuwe mogelijkheden toe, zoals verbeterde OneSync, nieuwe native functies en meer.

Vuistregel: controleer minstens eens per maand of er een nieuwe aanbevolen versie beschikbaar is en update wanneer dat het geval is.

Soorten builds

Op de artifact-downloadpagina van Cfx.re vind je verschillende soorten builds. Het is belangrijk om het verschil te kennen:

• Recommended (aanbevolen) – Dit is de stabielste versie die door Cfx.re is getest en goedgekeurd. Gebruik deze voor productieservers. Dit is altijd de veiligste keuze.
• Latest (nieuwste) – De meest recente build met de nieuwste features en fixes. Kan soms nog kleine bugs bevatten die nog niet ontdekt zijn. Geschikt als je de nieuwste functies wilt testen, maar er is een klein risico op instabiliteit.
• Critical (kritiek) – Een speciale build die wordt uitgebracht als er een ernstige beveiligings- of stabiliteitsbug is ontdekt. Als er een critical build beschikbaar is, update dan zo snel mogelijk.
• Optional – Tussentijdse builds met specifieke fixes. Alleen updaten als je last hebt van het probleem dat hierin is opgelost.

Afbeelding: hier moet afbeelding komen met screenshot van de Cfx.re artifacts downloadpagina met de verschillende buildtypes

Updaten via het paneel (Startup tab)

De makkelijkste manier om je artifacts te updaten is via het HytaleNode-paneel. Zo doe je dat:

1. Ga naar mijn.hytalenode.nl en open je FiveM-server.
2. Klik op de Startup tab in het linker menu.
3. Zoek het veld FIVEM_VERSION of Artifact Version.
4. Vul hier het buildnummer in van de gewenste versie (bijvoorbeeld 7290). Je kunt het nieuwste aanbevolen buildnummer vinden op de Cfx.re website onder artifacts.
5. Klik op Opslaan of bevestig de wijziging.
6. Herinstalleer de server als dat nodig is (sommige setups vereisen een herinstallatie om de nieuwe artifacts te downloaden). Dit doe je via de Settings tab met de Reinstall Server knop.
7. Start de server opnieuw op.

Afbeelding: hier moet afbeelding komen met screenshot van de Startup tab met het FIVEM_VERSION veld in het paneel

Let op: bij het herinstalleren worden alleen de serverbestanden (artifacts) opnieuw gedownload. Je resources, server.cfg en andere bestanden blijven behouden. Maak voor de zekerheid toch altijd een backup voordat je grote updates uitvoert.

Updaten via de Build-picker (aanbevolen)

Voor FiveM-servers is er een aparte pagina met een visuele build-picker. Dit is de makkelijkste manier om artifacts te updaten:

1. Ga naar je FiveM-server in het panel
2. Klik in het linkermenu op Build (route /server/:id/fivem-version)
3. Kies een build in het dropdownmenu:
   • Aanbevolen (automatisch) - stabiele productie-build, aanbevolen door Cfx.re
   • Nieuwste (automatisch) - meest recente build met de laatste wijzigingen
   • Specifieke build - kies een exact buildnummer uit de lijst (met labels zoals aanbevolen, nieuwste of verouderd)
4. Klik op Opslaan en bevestig de waarschuwing
5. De server wordt opnieuw geïnstalleerd met de gekozen build - je server.cfg en resources blijven behouden

Belangrijk: bij het wijzigen van de build wordt je server opnieuw geïnstalleerd. Alleen de FXServer-bestanden (artifacts) worden vervangen. Maak vooraf een backup als je voorzichtig wilt zijn.

De Build-picker is de aanbevolen methode. Als alternatief kun je ook handmatig een buildnummer invullen via de Startup tab (veld FIVEM_VERSION) - zie de sectie hierboven.

Handmatig updaten via bestanden

Als je meer controle wilt, kun je artifacts ook handmatig updaten:

1. Ga naar de officiele Cfx.re artifacts-pagina en download de gewenste Linux-build (je server draait op Linux).
2. Open de Bestanden tab in het paneel.
3. Navigeer naar de map waar de huidige artifacts staan (meestal de hoofdmap of een alpine-submap).
4. Upload de nieuwe artifact-bestanden en overschrijf de oude bestanden.
5. Herstart de server.

Belangrijk: download altijd de Linux-versie van de artifacts, niet de Windows-versie. Je FiveM-server bij HytaleNode draait op een Linux-omgeving.

Tips bij het updaten

• Maak altijd een backup – Voordat je artifacts update, maak een backup van je huidige serverbestanden. Mocht er iets misgaan, dan kun je altijd terug.
• Lees de changelog – Cfx.re publiceert bij elke build wat er is gewijzigd. Lees dit door zodat je weet wat je kunt verwachten.
• Test na de update – Start je server op na de update en controleer of alles werkt. Kijk of er fouten in de console verschijnen en test of je kunt verbinden.
• Wacht even met de allernieuwste versie – Als er net een nieuwe build is uitgebracht, wacht dan een paar dagen tenzij het een critical build is. Zo worden eventuele problemen eerst door anderen ontdekt.