Converter XML em YMAP depende do formato; não basta mudar o nome do arquivo. Um posicionamento salvo no Menyoo, um arquivo do Map Editor de Guadmaz e um YMAP XML do CodeWalker podem terminar em .xml, mas descrevem estruturas diferentes. Identifique a ferramenta de origem antes de escolher um importador.
Este guia trata de posicionamentos estáticos de objetos. Não promete preservar scripts, entidades móveis, peds, pickups, objetos anexados nem um interior MLO inteiro. Guarde o original e trabalhe numa cópia. Um posicionamento convertido não fornece modelos, texturas ou colisões personalizados que nunca foram incluídos.
Identifique o XML que você tem
Abra uma cópia num editor de texto simples, sem executar nada. Confira o elemento raiz e o aplicativo que salvou; não deduza o formato só pela extensão.
| Entrada | O que representa | Próximo passo adequado |
|---|---|---|
XML do CodeWalker com elemento raiz CMapData na raiz |
Uma representação textual de dados YMAP | Use o fluxo compatível de importação/compilação XML do CodeWalker |
| XML de posicionamentos Menyoo | Uma cena salva do Object Spooner | Use um importador que aceite explicitamente esse formato Menyoo |
| XML do Map Editor de Guadmaz | O esquema de mapas salvos desse editor | Use um conversor compatível explicitamente com XML do Map Editor |
Nativo .ymap |
Dados compilados do mapa, não XML textual | Abra como arquivo do jogo em vez de renomear para XML |
| Um JSON de projeto Map Studio | O projeto editável de planejamento deste site | Abra no Map Studio, depois exporte as fontes compatíveis |
O importador do navegador aceita XML compatível do CodeWalker CMapData XML, não qualquer XML do Menyoo ou Map Editor. Também rejeita mapas com relações pai em vez de apresentar uma edição parcial como exportação e reimportação completas e seguras. O guia de formatos de arquivos explica a diferença entre formato nativo e fonte.
Prepare um pequeno candidato para conversão
Salve uma cena com apenas três objetos estáticos cujos nomes existam na sua instalação. Registre nome, posição, rotação e escala de cada modelo. Evite dependências de outros mods nesse primeiro teste. Liste separadamente funções excluídas de propósito; perda silenciosa não é conversão bem-sucedida.
Salve a fonte com outro nome. Uma cena com centenas de posicionamentos é ruim para começar: dependência ausente, transformação errada e entidade não aceita podem parecer o mesmo problema. Três posicionamentos conhecidos permitem comparar cada objeto em cada etapa.
Caminhos de conversão do Menyoo e Map Editor
Primeiro, confira as opções de importação na versão específica do CodeWalker instalada. Use um importador específico só quando ele identificar seu formato. Uma ação genérica XML não comprova suporte a todos os esquemas. Registre versão e opção de importação junto da fonte salva.
O original Map Editor & Menyoo to YMap Converter oferece uma alternativa histórica documentada: abrir o XML aceito, exportar seu arquivo openFormats .ymap.xml, depois importar no OpenIV para gerar um arquivo nativo. O autor também documenta entidades excluídas e requisitos antigos de execução. Essas instruções descrevem esse fluxo, não garantem compatibilidade com toda versão moderna do Menyoo.
Use apenas a distribuição do autor e as dependências indicadas pelo editor. Não instale DLLs aleatórias nem desative segurança para forçar uma ferramenta antiga a iniciar. Se rejeitar o formato, guarde o erro e teste um arquivo menor em vez de renomeá-lo repetidamente.
O página mantida pelo autor do Menyoo distingue o comportamento das versões. Uma cena atual pode conter funções ausentes num conversor antigo. Registre esses limites de versão nos testes.
Inspecione e salve o YMAP resultante
Abra o mapa nativo resultante num projeto CodeWalker da mesma edição. Confirme as três referências de arquétipos e compare coordenadas com a fonte. Confira rotação de vários ângulos: uma vista correta de cima pode ocultar posicionamento inclinado ou espelhado.
Recalcule extensões e flags com os assets reais carregados. Salve, feche e reabra o mapa nativo. Reabrir testa o arquivo entregue, não um estado não salvo do editor. A lição do primeiro YMAP apresenta o fluxo de posicionamento.
Para praticar com fontes no navegador, baixe nosso XML e JSON CodeWalker de três objetos. São exemplos da estrutura-fonte de saída, não um caso certificado de conversão Menyoo nem um mapa nativo testado no jogo.
Empacote e teste no FiveM
Use uma pasta nova de recurso e o gerador de fxmanifest. Coloque o mapa compilado em stream/; mantenha o XML de trabalho em outro lugar. Registre YTYPs personalizados apenas quando o mapa depender das definições fornecidas. Siga o guia de streaming antes de adicionar o recurso a um servidor em produção.
Confira quantidade, posição, comportamento à distância e colisão dos objetos numa sessão de desenvolvimento. Repita após reconectar. Registre em qual etapa falha: leitura da fonte, conversão, reabertura no CodeWalker, início do recurso ou jogo.
Problemas de conversão a isolar
Um erro de leitura exige primeiro verificar esquema XML e suporte do conversor. Posições corretas com modelos ausentes exigem checar dependências e edição. Grandes deslocamentos pedem comparar transformações locais/mundiais. Comportamento ausente de peds, veículos ou scripts pede verificar se vinha do ambiente de execução, não dos dados do mapa.
Não valide toda a cena porque um objeto apareceu. Use o diagnóstico de mapas ausentes para um mapa nativo que carrega, mas falha no FiveM, e guarde a fonte original para outro caminho compatível de conversão.