Artefatos de servidor FiveM desatualizados: como atualizar FXServer com segurança

txAdmin mostra um aviso de que seus artefatos de servidor estão desatualizados, ou um recurso pede um build mais novo do que o que você executa. A correção é substituir o programa FXServer por um build atual. Leva cinco minutos se você manter seus dados separados, e é assim que se faz.

#O que são artefatos

Os "artefatos" são os binários FXServer: o programa que executa seu servidor. Não são seus recursos e não são sua configuração. Um layout típico fica assim:

FXServer/
  server/          <- artifacts (FXServer.exe or run.sh and its files)
  server-data/     <- your server.cfg and resources
  txData/          <- txAdmin data and profiles

Atualizar significa substituir o que está na pasta de artefatos. Você não toca nas outras duas. Se suas pastas estão misturadas, descubra o que é o quê antes de substituir qualquer coisa: a pasta de artefatos é a que contém FXServer.exe no Windows ou run.sh no Linux.

#Recomendado ou mais recente

As páginas de download marcam dois builds perto do topo:

• Recomendado: o build que o Cfx.re considera estável. Escolha isso para um servidor ao vivo.
• Mais recente: o build mais novo. Tem as correções e recursos mais novos, e uma chance maior de novos bugs.

Se txAdmin disser que um número de build específico é necessário e o recomendado é mais antigo que esse, pegue um build mais novo da lista. Não pule para o mais novo apenas porque é o mais novo.

#Onde baixar

Os builds são hospedados pelo Cfx.re em runtime.fivem.net:

• Windows: https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux: https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Baixe apenas dessas páginas. Não pegue builds de servidor de uma postagem no fórum, um arquivo do Discord ou um site de terceiros.

No Windows você obtém um arquivo server.7z, que você abre com 7-Zip. No Linux você obtém um arquivo fx.tar.xz.

#Faça backup primeiro

Antes de substituir qualquer coisa, copie:

1. A pasta de artefatos atual (a pasta server inteira).
2. Sua pasta server-data, ou pelo menos server.cfg e resources.
3. A pasta txData.
4. Um dump do seu banco de dados, se tiver um. Use sua ferramenta habitual, ou mysqldump na máquina.

Se o novo build se comportar mal, você pode colocar a pasta antiga de volta e estar executando novamente em um minuto.

Atenção: pare o servidor e txAdmin completamente antes de substituir arquivos. Sobrescrever FXServer enquanto está em execução falha no Windows, e no Linux deixa uma mistura quebrada de arquivos antigos e novos.

#Atualizar no Windows

1. Pare o servidor e feche txAdmin.
2. Baixe o server.7z do build que deseja.
3. Renomeie a pasta de artefatos antiga, por exemplo para server_old.
4. Crie uma nova pasta server e extraia o arquivo nela.
5. Inicie FXServer.exe da forma que fez antes, do mesmo local e com o mesmo atalho ou argumentos.

txAdmin encontra seu txData pelo caminho que você forneceu, e você não mudou isso, então seu perfil, configurações e admins ainda estão lá.

#Atualizar no Linux

sudo systemctl stop fivem        # or stop the screen session

cd ~/fivem
mv server server_old
mkdir server && cd server

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/<build>/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Substitua <build> pelo nome da pasta que você copia da página de download. Inicie o servidor novamente com seu comando ou serviço habitual. Se você ainda não configurou isso, veja executando um servidor FiveM no Linux.

#Verifique se funcionou

Na inicialização, o console imprime a versão do FXServer. Compare com o número de build na página de download. txAdmin também mostra a versão em seu painel, e o aviso desatualizado deve ter desaparecido.

Se algo quebrar após a atualização:

• Recursos falham ao iniciar: leia o primeiro erro no console. Um recurso que dependia de um comportamento antigo pode precisar de uma atualização. Veja não foi possível iniciar o recurso.
• O servidor não iniciará em tudo: coloque a pasta server_old antiga de volta, inicie-a e relate o número de build que falhou.
• Um novo aviso sobre o build do jogo: essa é uma configuração diferente, veja sv_enforceGameBuild e DLC.

#Com que frequência atualizar

Você não precisa perseguir cada build. Uma regra razoável: atualize quando txAdmin avisa, quando um recurso precisa de um build mais novo, ou quando você atinge um bug que um build posterior corrige. Sempre teste uma atualização em uma cópia do servidor primeiro se você executar servidores pagos ou ocupados, e faça-o quando poucas pessoas estão online.

#Lista de verificação