CodeWalker é uma ferramenta Windows para visualizar arquivos GTA V e trabalhar com dados de mapa. Baixe-o apenas de repositório oficial do CodeWalker ou do autor Distribuição GTA5-Mods. Não use espelhos ou executáveis reempacotados.
O que o CodeWalker faz — e o que ele não faz
O CodeWalker pode navegar por arquivos GTA V RPF, renderizar o mundo, inspecionar entidades, criar projetos e editar arquivos de mapa como YMAP. Sua Janela de Projeto também suporta outros formatos de dados do jogo descritos pelo autor. Ele não é um substituto para uma suíte de modelagem 3D, controle de versão, backups ou um servidor de teste FiveM no jogo.
Requisitos e fontes de download seguras
O repositório lista um PC Windows de 64 bits, uma cópia para PC de GTA V, gráficos compatíveis com DirectX 11 e o runtime .NET necessário. Verifique a documentação atual do autor antes de instalar, pois as compilações de desenvolvimento e os requisitos podem mudar.
- Repositório oficial GitHub por dexyfex para documentação de origem e projeto.
- Página GTA5-Mods do autor para a distribuição publicada.
Configure o caminho do GTA V
- Extraia o arquivo fornecido pelo autor em uma pasta de ferramentas dedicada.
- Inicie o CodeWalker a partir dessa pasta.
- Na primeira inicialização, selecione a raiz da sua instalação GTA V se o CodeWalker não a detectar automaticamente.
- Aguarde o carregamento dos dados iniciais do mundo antes de assumir que o aplicativo travou.
Use a Visualização do Mundo e a Janela do Projeto
A World View é a superfície de navegação visual. Os controles do autor usam WASD para movimento, arrastar com o botão esquerdo para rotação da câmera e a roda do mouse para zoom e velocidade de movimento. Abra a Toolbox para inspecionar seleções e a barra de ferramentas principal para alternar os modos de seleção e transformação.
Crie e salve um .cwproj projeto antes da edição. A Janela do Projeto mantém os arquivos e entidades para a tarefa atual juntos; editar uma entidade enquanto ela está aberta pode adicionar a YMAP proprietária ao projeto.
Trabalhe com projetos YMAP e YTYP
Um YMAP normalmente possui posicionamentos no mundo. Um YTYP descreve arquétipos e pode carregar informações usadas por fluxos de trabalho internos. Mantenha os arquivos de origem, os arquivos exportados e o recurso FiveM final em pastas separadas para que uma exportação não possa sobrescrever a única cópia editável.
- Crie ou abra um projeto e adicione apenas os arquivos necessários para esse mapa.
- Selecione entidades na Visualização do Mundo, em seguida, mova, gire ou escale-as deliberadamente.
- Salve os arquivos YMAP editados da Janela do Projeto e revise o caminho de saída.
- Para trabalho em MLO, valide as alterações de YTYP, sala, portal e arquétipo como parte do fluxo de trabalho completo do interior.
Exporte, faça backup e teste
Antes de cada sessão de edição, copie toda a pasta do projeto para um backup com data. Exporte para uma pasta de build separada, compare a lista de arquivos com o projeto e mantenha o último build conhecido como bom. O autor do CodeWalker descreve a ferramenta como um trabalho em andamento, portanto, travamentos ou renderização incompleta são possíveis; salvamentos frequentes e alterações reversíveis são importantes.
Empacote o resultado como um recurso FiveM
Um layout comum de recurso de mapa mantém o manifesto do recurso na raiz do recurso e os ativos de mapa exportados em um stream diretório. Não publique o projeto CodeWalker bruto como recurso do servidor. Use a FiveM Guia de Criação de MLO para o fluxo de trabalho completo de modelagem, exportação, manifesto e validação no jogo.
my-map/
├── fxmanifest.lua
└── stream/
├── map.ymap
└── archetypes.ytypProblemas comuns do CodeWalker
- O mundo está em branco ou ainda carregando: verifique a raiz GTA V e dê tempo para a primeira carga terminar.
- Uma edição está faltando no projeto: confirme se a Janela do Projeto estava aberta e se o YMAP correto faz parte do projeto salvo.
- O servidor mostra o mapa antigo: compare os arquivos exportados com os do recurso.
streampasta e reinicie apenas o recurso de teste pretendido. - Falhas do CodeWalker: reabra o último projeto funcional e reduza a alteração à menor edição reproduzível antes de reportá-la ao upstream.
Continue o fluxo de trabalho do MLO
Compare o papel de posicionamentos e interiores em MLO vs YMAP, navegue FiveM MLOs, ou inspecione FiveM MLOs grátis antes de construir seu próprio projeto de teste.
Fontes revisadas em 20 de agosto de 2026: o repositório CodeWalker da dexyfex e a distribuição GTA5-Mods do autor.