CodeWalker é uma ferramenta para Windows que permite visualizar arquivos do GTA V e trabalhar com dados de mapas. Baixe-o somente do repositório oficial do CodeWalker ou da distribuição do autor no GTA5-Mods. Não use espelhos de download nem executáveis reempacotados.
Confirme a edição de GTA de destino antes de instalar ou exportar assets. Pacotes Legacy não estão automaticamente prontos para o Enhanced; siga a orientação oficial de conversão de assets para o Enhanced quando esse for o seu objetivo.
O que o CodeWalker faz e o que ele não faz
O CodeWalker permite explorar arquivos RPF do GTA V, renderizar o mundo, inspecionar entidades, criar projetos e editar arquivos de mapa como YMAP. Sua Project Window também aceita outros formatos de dados do jogo descritos pelo autor. Ele não substitui um software de modelagem 3D, controle de versão, backups ou um servidor de teste FiveM dentro do jogo.
Requisitos e fontes seguras de download
O repositório lista um PC Windows de 64 bits, uma cópia de GTA V para PC, uma placa gráfica compatível com DirectX 11 e o ambiente de execução .NET necessário. Confira a documentação atual do autor antes de instalar, pois as versões de desenvolvimento e os requisitos podem mudar.
- Repositório oficial de dexyfex no GitHub para código-fonte e documentação do projeto.
- Página do autor no GTA5-Mods para a distribuição publicada.
Configure o caminho do GTA V
- Extraia o arquivo fornecido pelo autor em uma pasta dedicada a ferramentas.
- Inicie o CodeWalker nessa pasta.
- Na primeira execução, selecione a raiz da instalação de GTA V se o CodeWalker não a detectar automaticamente.
- Aguarde o carregamento inicial dos dados do mundo antes de presumir que o aplicativo travou.
Use o World View e a Project Window
World View é a interface de navegação visual. Os controles do autor usam WASD para movimento, arrastar com o botão esquerdo para girar a 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 projeto .cwproj antes de editar. A janela Project mantém juntos os arquivos e as entidades da tarefa atual; editar uma entidade enquanto essa janela está aberta pode adicionar ao projeto o YMAP ao qual ela pertence.
Trabalhe com projetos YMAP e YTYP
Um YMAP normalmente controla os posicionamentos no mundo. Um YTYP descreve arquétipos e pode conter informações usadas no trabalho com interiores. Mantenha os arquivos-fonte, os arquivos exportados e o recurso FiveM final em pastas separadas para que uma exportação não sobrescreva a única cópia editável.
- Crie ou abra um projeto e adicione apenas os arquivos necessários para esse mapa.
- Selecione entidades no World View e mova, gire ou redimensione-as de forma deliberada.
- Salve os arquivos YMAP editados pela Project Window e confira o caminho de saída.
- Para trabalhos com MLO, valide as alterações de YTYP, cômodos, portais e arquétipos como parte do fluxo completo do interior.
Exporte, faça backup e teste
Antes de cada sessão de edição, copie a pasta inteira do projeto para um backup datado. Exporte para uma pasta separada de compilação, compare a lista de arquivos com o projeto e guarde a última versão comprovadamente funcional. O autor do CodeWalker descreve a ferramenta como um trabalho em andamento, então travamentos ou renderização incompleta são possíveis; salvar com frequência e fazer alterações reversíveis é importante.
Empacote o resultado como um recurso FiveM
Uma estrutura comum de recurso de mapa mantém o manifest na raiz do recurso e os assets de mapa exportados em um diretório stream. Não publique o projeto bruto do CodeWalker como recurso do servidor. Use o guia de criação de MLO para FiveM para seguir o processo completo de modelagem, exportação, manifest e validação dentro do jogo.
my-map/
├── fxmanifest.lua
└── stream/
├── map.ymap
└── archetypes.ytypProblemas comuns do CodeWalker
- O mundo está vazio ou ainda carregando: verifique a raiz do GTA V e aguarde a conclusão do primeiro carregamento.
- Uma alteração não aparece no projeto: confirme que a Project Window estava aberta e que o YMAP correto faz parte do projeto salvo.
- O servidor mostra o mapa antigo: compare os arquivos exportados com a pasta
streamdo recurso e reinicie apenas o recurso de teste pretendido. - O CodeWalker trava: reabra o último projeto comprovadamente funcional e reduza a alteração à menor edição reproduzível antes de relatar o problema ao projeto original.