FiveM Artifacts uitgelegd

1. Wat een FiveM artifact is

Cfx.re publiceert meerdere keren per week nieuwe FXServer-builds op runtime.fivem.net, oplopend genummerd. Elke build is een compleet serverpakket: de FXServer-binaries, de Citizen-runtime en de meegeleverde txAdmin. Je resources, server.cfg en database horen er niet bij; die blijven staan als je van build wisselt.

Het buildnummer is wat de serverlijst en de gameclient controleren. Brengt Cfx.re een clientupdate uit die een nieuwere server vereist, dan accepteren servers op oudere builds geen nieuwe spelers meer tot ze updaten. Daarom is een artifact-update de meest voorkomende onderhoudsklus op een FiveM-server.

2. Recommended, latest of een specifieke build?

Cfx.re markeert één build als Recommended: de build die lang genoeg uit is om op te vertrouwen. De Latest build is de nieuwste die is gepubliceerd, soms maar een paar uur oud. Voor een publieke roleplayserver is Recommended de veilige keuze; neem Latest alleen als een clientupdate het vereist of als een changelogregel een probleem oplost dat jij hebt.

Oudere builds blijven online, dus je kunt ook een specifiek nummer vastzetten, bijvoorbeeld als een resource waar je van afhankelijk bent kapotgaat op een nieuwere build. De changelog op changelogs.fivem.net laat zien wat er tussen builds veranderde en markeert de builds die als critical zijn aangemerkt.

3. Controleer welke build je server draait

Open de txAdmin-loginpagina van je server: de voettekst toont twee versies, zoals tx: v8.1.1 | fx: b gevolgd door een nummer. Dat fx-nummer is je artifact, en je hoeft niet eens in te loggen om het te lezen. De serverconsole print hetzelfde nummer direct na het starten.

4. Updaten op een VibeGAMES-server (één klik)

Open in het gamepanel je server en klik op Artifacts Updater onder Game Server. De lijst toont de builds van runtime.fivem.net, met een Recommended-label op de build die Cfx.re aanraadt en een Optional-label op de nieuwste build; met het zoekvak vind je een specifiek nummer.

Kies een build en druk op Install. Het panel stopt de server, downloadt de build rechtstreeks van Cfx.re en start de server opnieuw; op de Console-pagina zie je wanneer hij terug is. Je resources, server.cfg, txAdmin-gegevens en database blijven onaangeroerd. Spring je veel builds tegelijk, maak dan eerst een back-up.

Servers die zijn omgezet naar FiveM for GTAV Enhanced draaien automatisch altijd de nieuwste build, dus daar is de updater alleen-lezen; schakel terug op de pagina GTAV Enhanced als je een build wilt vastzetten.

5. Handmatig updaten op een VPS of dedicated server

Stop de server. Download de gewenste build van runtime.fivem.net (fx.tar.xz voor Linux, server.7z voor Windows), pak hem uit in een nieuwe map naast de oude en laat je startcommando of run.sh naar de nieuwe map wijzen. Je server-data-map met de resources, server.cfg en cache blijft waar hij is.

Start de server en let in de console op het buildnummer en op de regel die zegt dat de licentiesleutel is geaccepteerd. Bewaar de oude map tot je zeker weet dat alles draait; terugdraaien is dan een kwestie van het startcommando terugzetten.

6. Als een update iets kapotmaakt

Een server die na een update niet meer start, is meestal een resource die een API gebruikt die de nieuwe build heeft verwijderd, of een txAdmin-profiel dat een reset nodig heeft. Zoek in de console de eerste rode regel, schakel de resource uit die daar staat en probeer het opnieuw. Helpt dat niet, installeer dan opnieuw de Recommended build; downgraden is net zo veilig als upgraden.

Makers van resources publiceren compatibiliteitsnotities op het Cfx.re-forum en op hun releasepagina's, dus na een grote sprong loont het om je grootste resources (framework, inventory, anti-cheat) in dezelfde sessie bij te werken.

7. Hoe vaak moet je updaten?

Eens per paar weken is genoeg voor de meeste servers, plus telkens wanneer een clientupdate spelers buiten de deur houdt. Houd de changelog in de gaten voor builds die als critical zijn gemarkeerd: die dichten beveiligings- of stabiliteitsproblemen en zijn het waard om direct te installeren. Op VibeGAMES is een update één klik en ongeveer een minuut downtime, dus er is geen reden om een jaar achter te lopen.