Seu primeiro objetivo é simples: abrir o mundo do GTA V, selecionar um objeto e salvar um projeto CodeWalker. Deixe a edição de arquivos do jogo para depois. Você não precisa instalar o CodeWalker dentro de um recurso FiveM nem substituir nada na pasta do GTA V.
Escolha o download com cuidado
Use a página de dexyfex no GTA5-Mods ou os canais de lançamento vinculados pelo autor. Este site oferece o arquivo específico ZIP v30_dev46 fornecido nessa página; isso não afirma que dev46 seja a versão de desenvolvimento mais recente. O arquivo está listado com a data de 29 de janeiro de 2024. Consulte as instruções atuais do autor antes de escolher uma versão para um novo projeto.
O no GitHub contém o código-fonte. Baixar o repositório como ZIP não é o mesmo que baixar uma versão Windows pronta para executar.
Extraia todo o arquivo do aplicativo para uma pasta dedicada. Não execute o programa de dentro do ZIP compactado. Mantenha juntos os arquivos que o acompanham e não substitua arquivos individuais por outros de uma versão diferente.
Entenda os requisitos publicados
O README lista uma instalação de GTA V para PC, processador x64, 4 GB de RAM com 8 GB ou mais recomendados e gráficos compatíveis com DirectX 11 / Shader Model 4.0. O requisito histórico de Windows é Windows 7 ou superior. Essa é a informação de compatibilidade publicada pelo autor, não uma recomendação para usar um sistema operacional sem suporte.
Há uma pequena diferença entre as fontes fornecidas: o README diz .NET Framework 4.5 ou superior, enquanto a descrição no GTA5-Mods especifica 4.5.2. Siga os requisitos da versão que você realmente instalar. Não trate uma especificação mínima antiga como garantia para assets atuais do jogo ou para toda versão de desenvolvimento.
Indique a instalação do GTA V ao CodeWalker
Na primeira execução, selecione a pasta da sua instalação do GTA V quando solicitado. O README descreve a descoberta automática de um caminho padrão histórico do Steam. Sua instalação pode estar em outro lugar; escolha o local real em vez de recriar o caminho do exemplo.
A visualização do mundo carrega por padrão e pode levar algum tempo para ficar completa. Antes de concluir que algo está faltando, confira a pasta do jogo escolhida e o estado de carregamento do aplicativo. Mantenha o teste inicial simples: sem assets personalizados e sem um grande projeto de mod existente.
Escolha agora a edição de destino. Legacy e Enhanced são destinos de assets separados. Um link de arquivo antigo não comprova compatibilidade com Enhanced. Leia a nota sobre planejamento de edições antes de exportar trabalhos para um servidor Enhanced.
Use a primeira sessão como um teste de navegação
Use WASD para se mover, mantenha Shift pressionado para acelerar e arraste com o botão esquerdo do mouse para girar a câmera. A roda altera o zoom e a velocidade básica de movimento. Pressione T para mostrar a barra principal. Ative a seleção de entidades, clique com o botão direito em um objeto e inspecione os detalhes.
Ainda não mova esse objeto. Abra a janela Project Window, crie um projeto e salve-o no seu diretório de trabalho. Um arquivo .cwproj é seu projeto do editor; não é um recurso de mapa FiveM.
Um espaço de trabalho útil separa entradas e saídas:
cw-workshop/
source/ # Blender files and editable project files
exports/ # Interchange files and exported game assets
resource/ # Only the files intended for FiveM
notes/ # Tool versions, game build and test observations
Os nomes das pastas são uma sugestão de organização, não um requisito do CodeWalker.
Quando o aplicativo não inicia
Registre o erro exato, a versão do aplicativo e a edição do jogo selecionada. Confira os requisitos da versão e a integridade da extração. Um mundo vazio e um aplicativo que falha antes de abrir são problemas diferentes; descreva qual deles ocorre ao pedir ajuda.
Não tente corrigir um erro de inicialização desativando programas de segurança, baixando um executável reempacotado ou substituindo arquivos do jogo sem relação com o problema. O autor descreve explicitamente o CodeWalker como um trabalho em andamento; travamentos podem ser erros do aplicativo, não uma prova de instalação incorreta.
Continue com os controles de navegação e edição, depois crie um primeiro YMAP pequeno.