Como limpar o cache do FiveM: quais pastas deletar (e quais não)

Um veículo mostra a textura errada, um script mudado ainda se comporta como o antigo, ou FiveM faz crash logo após uma atualização. Antes de você reinstalar qualquer coisa, limpe o cache do cliente. Leva um minuto, é seguro, e corrige um número surpreendente de problemas do lado do cliente.

#O que é o cache

Quando você entra em um servidor, FiveM baixa os arquivos transmitidos do servidor (modelos, texturas, mapas) e scripts, e mantém cópias no seu PC para que a próxima entrada seja mais rápida. Às vezes essas cópias ficam obsoletas, são corrompidas por um crash ou uma conexão perdida, ou não correspondem mais ao que o servidor envia. Limpar o cache força um download limpo.

Isto é apenas no cliente. Os jogadores fazem em seu próprio PC. Os proprietários do servidor não podem limpar para eles, mas você pode dizer aos jogadores como.

#Passo a passo

1. Feche FiveM completamente, incluindo o launcher na bandeja. Verifique o Gerenciador de Tarefas para FiveM.exe ou FiveM_GTAProcess.exe se não tiver certeza.
2. Pressione Win + R, cole isto, e pressione Enter:

%localappdata%\FiveM\FiveM.app\data

3. Delete estas pastas se existem:

cache
server-cache
server-cache-priv

4. Inicie FiveM e reconecte. A primeira entrada é mais lenta porque tudo baixa novamente.

Se você quer ser cuidadoso, delete o conteúdo das pastas em vez das pastas, ou as mova para outro lugar primeiro. FiveM as recria de qualquer forma.

Dica: dentro de cache, uma pasta game contém arquivos relacionados ao jogo. Alguns deixam no lugar para evitar baixar aqueles novamente. Arquivos específicos do servidor estão em server-cache e server-cache-priv, que é onde a maioria dos problemas com conteúdo transmitido obsoleto vivem.

#O que cada pasta é

Se você só quer corrigir um problema com um servidor, server-cache e server-cache-priv são as pastas que mais importam. Se nada muda, delete cache também.

#O que não deletar

Deixe estes em paz:

• Sua pasta de instalação do GTA V. O cache não é o jogo.
• FiveM.app\mods e FiveM.app\plugins, se você as usa. São seus próprios arquivos.
• CitizenFX.ini em FiveM.app. Contém configurações do launcher.
• A pasta inteira FiveM. Deletar tudo faz FiveM se reinstalar, que é raramente necessário.

Se você não sabe o que é um arquivo, não o delete. As três pastas de cache resolvem a maioria dos casos.

#Quando limpar o cache ajuda

• Problemas de textura. Texturas borradas, faltando ou esticadas, veículos pretos, ou texturas rosa e de xadrez que outros jogadores não veem. Frequentemente a cópia em cache de um arquivo transmitido está danificada. Para texturas muito grandes, veja oversized assets and texture loss.
• Versões antigas de arquivos transmitidos. O servidor mudou um veículo ou mapa, mas você ainda vê o antigo. O servidor envia os novos arquivos, mas sua cópia em cache é usada. Isto é comum após uma atualização para um recurso transmitido.
• Crashes após uma atualização. Após uma atualização do FiveM ou uma mudança de game build, dados em cache antigos podem fazer o cliente fazer crash na conexão ou no carregamento. Limpar o cache é a primeira coisa a tentar.
• Downloads presos. Um download que nunca termina ou reinicia novamente e novamente. Se a própria tela de carregamento nunca termina, veja players stuck on the loading screen.
• Problemas NUI estranhos. Uma UI mostra gráficos antigos ou mantém dados antigos. Feche FiveM e limpe o cache. Se há uma pasta nui-storage, contém dados do navegador para UIs, e é seguro limpá-la também quando uma UI se comporta mal.

#Quando não ajuda

Limpar o cache não corrige nada no lado do servidor. Se cada jogador obtém o mesmo erro, a causa está no servidor ou no recurso, não no cache de ninguém. Exemplos comuns são script errors, um recurso faltando, ou um manifesto ruim. Teste com um segundo PC ou um amigo: se o problema acontece para eles também, pare de limpar caches e leia o console do servidor.

Também não corrige um GTA V instalado danificado, um driver de gráficos quebrado, ou um conflito de overlay. Para esses, verifique os arquivos do jogo em seu launcher e atualize seu driver de GPU.

#Para proprietários de servidor: ajude seus jogadores

Jogadores perguntam no Discord por que seu jogo parece errado após uma atualização. Adicione uma mensagem curta fixada com o caminho e os três nomes de pasta. Também mantenha seus ativos transmitidos sensatos: arquivos enormes e um grande número deles fazem problemas de cache mais prováveis e a primeira entrada mais lenta.

#Checklist