Os artifacts do FiveM explicados

1. O que é um artifact do FiveM

A Cfx.re publica novas builds do FXServer várias vezes por semana em runtime.fivem.net, numeradas em ordem crescente. Cada build é um pacote de servidor completo: os binários do FXServer, o runtime Citizen e o txAdmin incluído. Seus resources, seu server.cfg e seu banco de dados não fazem parte dele; eles ficam onde estão quando você troca de build.

O número da build é o que a lista de servidores e o cliente do jogo verificam. Quando a Cfx.re lança uma atualização do cliente que exige um servidor mais novo, os servidores em builds antigas param de aceitar novos jogadores até atualizarem, e é por isso que atualizar artifacts é a tarefa de manutenção mais comum em um servidor de FiveM.

2. Recommended, latest ou uma build específica?

A Cfx.re marca uma build como Recommended: aquela que está disponível há tempo suficiente para ser confiável. A build Latest é a mais nova publicada, às vezes com poucas horas de vida. Para um servidor de roleplay público, Recommended é a escolha segura; use Latest apenas quando uma atualização do cliente exigir ou quando uma entrada do changelog corrigir um problema que você tem.

As builds antigas continuam online, então você também pode fixar um número específico, por exemplo quando um resource do qual você depende quebra em uma build mais nova. O changelog em changelogs.fivem.net mostra o que mudou entre as builds e sinaliza as marcadas como critical.

3. Verifique qual build o seu servidor roda

Abra a página de login do txAdmin do seu servidor: o rodapé mostra duas versões, como tx: v8.1.1 | fx: b seguido de um número. Esse número fx é o seu artifact, e você nem precisa fazer login para lê-lo. O console do servidor imprime o mesmo número logo após iniciar.

4. Atualizar em um servidor VibeGAMES (um clique)

No painel de jogo, abra o seu servidor e clique em Artifacts Updater, em Game Server. A lista mostra as builds de runtime.fivem.net, com a etiqueta Recommended na que a Cfx.re sugere e a etiqueta Optional na mais recente; uma caixa de busca encontra um número específico.

Escolha uma build e pressione Install. O painel para o servidor, baixa a build diretamente da Cfx.re e inicia o servidor de novo; a página Console mostra quando ele voltou. Seus resources, server.cfg, dados do txAdmin e banco de dados ficam intactos. Se for pular muitas builds de uma vez, faça um backup antes.

Servidores migrados para FiveM for GTAV Enhanced rodam sempre a build mais recente automaticamente, então ali o atualizador é somente leitura; volte na página GTAV Enhanced se precisar fixar uma build.

5. Atualizar manualmente em um VPS ou servidor dedicado

Pare o servidor. Baixe a build desejada de runtime.fivem.net (fx.tar.xz para Linux, server.7z para Windows), extraia em uma pasta nova ao lado da antiga e aponte o seu comando de início ou run.sh para a nova pasta. Sua pasta server-data com os resources, server.cfg e cache fica onde está.

Inicie o servidor e observe no console o número da build e a linha que diz que a autenticação da chave de licença foi concluída. Mantenha a pasta antiga até ter certeza de que tudo roda; voltar atrás é então só apontar o comando de início de volta.

6. Quando uma atualização quebra algo

Um servidor que não inicia mais após uma atualização costuma ser um resource que usa uma API removida na nova build, ou um perfil do txAdmin que precisa de um reset. Procure no console a primeira linha vermelha, desative o resource que ela nomeia e tente de novo. Se não ajudar, instale novamente a build Recommended; fazer downgrade é tão seguro quanto atualizar.

Autores de resources publicam notas de compatibilidade no fórum da Cfx.re e nas páginas de lançamento, então após um salto grande vale a pena atualizar seus maiores resources (framework, inventário, anti-cheat) na mesma sessão.

7. Com que frequência atualizar?

Uma vez a cada poucas semanas basta para a maioria dos servidores, mais sempre que uma atualização do cliente impedir os jogadores de conectar. Fique de olho no changelog nas builds marcadas como critical: elas fecham problemas de segurança ou estabilidade e valem a instalação imediata. Na VibeGAMES uma atualização é um clique e cerca de um minuto fora do ar, então não há motivo para ficar um ano atrasado.