Formatos de arquivo do GTA V e FiveM, em linguagem simples

O que .ydr, .ytd, .yft, .ydd, .ytyp e arquivos comuns de recurso geralmente significam.

Guias 7 min de leitura
Syntax Platform team
Arte de referência de formatos de arquivo RAGE.

GTA V usa o RAGE, Rockstar Advanced Game Engine. FiveM mantém esse sistema de Arquivos e transmite Arquivos e metadados extras para o jogo.

A maioria dos arquivos de servidor está conectada a outro arquivo. Um .ytd fornece texturas para um modelo. Um .ytyp informa ao jogo o que é um prop. Um arquivo .meta informa ao jogo como um veículo, arma, linha de handling ou outro sistema deve se comportar. Quando você conhece essas conexões, fica mais fácil corrigir recursos com problemas.

Mapa rápido de formatos

ExtensãoSignificado comumGeralmente se vincula aFerramentas do Zoovdev
.ydrModelo drawable. Na maioria das vezes, um prop, objeto de mapa, objeto de arma ou outro Arquivo 3D estático.Texturas .ytd, arquétipos .ytyp, posicionamentos .ymap.Modelo para Prop, Imagem para Prop, Otimizar Props
.ytdDicionário de texturas. Contém texturas nomeadas, normalmente comprimidas com mipmaps..ydr, .yft, .ydd, slots de pintura, nomes de textura da UI e nomes de textura de prop.Imagem para YTD, Editor, Otimizar Texturas
.yftModelo de fragmento. No trabalho com FiveM, isso geralmente significa um veículo, mas fragmentos também podem ser usados para objetos quebráveis ou físicos.Texturas .ytd, vehicles.meta, handling.meta, carvariations.meta, carcols.meta.Criador de Pinturas, Otimizar Veículos
.yddDicionário drawable. Usado normalmente para Roupas e drawables de componentes de ped.Texturas .ytd, nomes de componentes de ped, estrutura de recurso de Roupas.Plugin do Photoshop, Otimizar Roupas
.ytypDefinições de tipo de item ou arquétipo. Informa ao jogo sobre props, limites e arquétipos de mapa.Nomes de modelo .ydr, posicionamentos .ymap, entradas fxmanifest.lua data_file.Prop para YTYP
.ybn / .ybdDados de colisão. Usados para limites de modelo e colisão física, para que objetos, veículos e jogadores não atravessem o Arquivo.Props .ydr, veículos .yft, Arquivos de mapa e exportações de colisão do Codewalker.Verifique a colisão quando um objeto está visível, mas não é possível andar, dirigir ou atingi-lo corretamente.
.ycdDicionário de clipes de animação. Contém dados de animação usados por peds, props, Arquivos no estilo de cutscene e cenas com script.Dicionários de animação, referências .meta, scripts e recursos transmitidos que solicitam essas animações.A maior parte do trabalho em servidores usa dicionários de animação existentes, mas recursos personalizados podem transmitir dados de animação quando a configuração exigir.
.ymapArquivo de posicionamento de mapa. Posiciona entidades no mundo.Arquétipos .ytyp, props .ydr, configuração do manifesto de recurso de mapa.Use com YTYP e recursos de modelo transmitidos.
.meta / .ymt / .xmlMetadados. Veículos, handling, variações de carros, armas, peds, lojas e outros dados do jogo usam arquivos de metadados.Entradas fxmanifest.lua data_file, arquivos de veículo, arquivos de handling, .xml exportado do Codewalker.Guias do Zoovdev e fluxos de trabalho do Code Agent.
.rpfArquivo de pacote RAGE. O GTA armazena muitos arquivos originais do jogo em arquivos .rpf.Fluxos de trabalho de extração e importação no OpenIV ou CodeWalker.Geralmente é material de origem, não a pasta final do recurso FiveM.
Estes significados abrangem usos comuns no FiveM e GTA V, não todos os usos possíveis de cada contêiner.

Como os arquivos se conectam

.ydr mais .ytd mais .ytyp

Um prop geralmente começa como um .ydr. O .ydr contém a malha e as referências de materiais. O .ytd contém os nomes das texturas solicitadas por esses materiais. O .ytyp define o prop como um arquétipo, para que os posicionamentos no mapa saibam o que ele é.

Se o modelo aparecer branco, cinzento ou invisível, verifique primeiro o dicionário de texturas. O nome da textura dentro do .ytd deve corresponder ao nome esperado pelo modelo. Se o prop existir, mas não for posicionado corretamente em um mapa, verifique o .ytyp.

.yft mais metadados do veículo

Um .yft geralmente é o modelo do veículo em um recurso FiveM. Muitos veículos também têm uma versão _hi.yft com mais detalhes a curta distância. As texturas ficam em um .ytd, e o comportamento vem dos arquivos de metadados.

  • vehicles.meta conecta o nome do modelo, a classe do veículo, o layout, o áudio e outras definições do veículo.
  • handling.meta controla o comportamento de condução.
  • carvariations.meta associa pinturas, cores, extras e dados de variação.
  • carcols.meta geralmente contém dados extras de cores e kits de modificação.

.ydd mais .ytd

Um .ydd é um dicionário de drawables. Na maioria das conversas entre donos de servidores, isso significa Roupas. A geometria fica no .ydd e as texturas correspondentes ficam no .ytd. Se uma peça de roupa carregar com o tecido errado ou um material em branco, verifique os nomes das texturas e dos componentes antes de recriar todo o recurso.

.xml geralmente é a cópia editável

Ferramentas como o CodeWalker geralmente exportam .ydr, .yft e outros arquivos do jogo como .xml. Esse XML é mais fácil de inspecionar e editar, mas o jogo não transmite o .xml exportado como Arquivo final. Depois de editar, compile ou importe-o de volta para o formato do jogo.

Colisão .ybn / .ybd

A colisão é a parte que se nota quando a arte parece correta, mas o mundo parece errado. Um .ybn ou .ybd pode definir a forma física em volta de um prop, edifício, estrada ou outro Arquivo do mundo. Se jogadores caírem através de um chão, baterem numa parede invisível ou atravessarem com o veículo um objeto visível, verifique a colisão antes de recriar o modelo.

Dicionários de animação .ycd

Os dados de animação geralmente ficam em arquivos .ycd. Muitos scripts FiveM chamam dicionários de animação existentes no jogo, mas Arquivos personalizados podem trazer os próprios clipes de animação. Se uma solicitação de animação não fizer nada, verifique o nome do dicionário, o nome do clipe, o caminho do recurso e se o arquivo está sendo transmitido.

Onde o manifesto se encaixa

Os recursos FiveM usam fxmanifest.lua para descrever scripts, arquivos de dados, páginas de interface, dependências e arquivos que os clientes devem baixar. Para entradas exatas do manifesto, use a documentação oficial de manifestos de recursos.

lua
fx_version 'cerulean'
game 'gta5'

files {
  'stream/props.ytyp',
  'data/vehicles.meta',
  'data/carvariations.meta',
  'data/handling.meta'
}

data_file 'DLC_ITYP_REQUEST' 'stream/props.ytyp'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'HANDLING_FILE' 'data/handling.meta'

O manifesto não corrige nomes incorretos dentro de um modelo. Ele apenas informa ao FiveM quais arquivos de recurso e metadados devem ser carregados. Se o .ydr solicitar uma textura chamada sign_1 e o .ytd contiver apenas sign1, o manifesto pode estar perfeito e a textura ainda falhará.

Arquivos de origem vs. arquivos do jogo

Os criadores também trabalham com arquivos que não são Arquivos finais transmitidos. Um .png, .jpg, .psd, .glb, .fbx ou .obj pode ser a origem usada para criar o recurso, mas o GTA V geralmente precisa que o resultado seja empacotado nos formatos acima.

Arquivo de origemPara que geralmente serveResultado final
.png / .jpgOrigem de textura, ícone, decalque, logótipo ou imagem de referência..ytd, .dds ou fluxo de trabalho de prop baseado em imagem.
.psdTrabalho de textura em camadas no Photoshop ou Photopea.Entrada de textura .ytd pelo plugin ou editor.
.glb / .fbx / .objOrigem de modelo 3D do Blender, Sketchfab ou outra ferramenta de modelagem.Prop .ydr, depois geralmente .ytd e .ytyp.
.ddsFormato de textura comprimida usado em muitos fluxos de trabalho de jogos.Entrada do dicionário de texturas .ytd.

Associe a ferramenta ao arquivo

TarefaComece comUse
Criar um prop de FiveM a partir de um modelo.glb, .fbx, .objModel to Prop
Criar um prop a partir de uma imagem plana.png, .jpgImage to Prop
Criar um dicionário de texturas.png, .jpg, .ddsImage to YTD
Mapear um veículo para pinturas.yft.xml exportado do CodeWalkerLivery Creator
Editar ou visualizar texturas.ytd, modelo de veículo, modelo de roupas, PSDDesign Editor ou Photoshop Plugin
Reduzir o tamanho do arquivo antes do lançamento.ydr, .ytd, .yft, .yddFerramentas de otimização para texturas, props, veículos e roupas.
Tornar um prop utilizável em posicionamentos no mapa.ydrProp to YTYP

Lista rápida de verificação para depuração

  • O modelo está invisível: verifique o nome do arquivo, a pasta stream, o nome do modelo e se está faltando um arquivo .ytyp ou de metadados.
  • O modelo está branco ou cinza: verifique o .ytd e os nomes das texturas que o modelo espera.
  • O veículo aparece, mas não tem pinturas: verifique carvariations.meta e os nomes das texturas de pintura dentro do .ytd.
  • As roupas aparecem com a textura errada: verifique a nomenclatura dos componentes e se o dicionário de texturas .ytd correspondente está presente.
  • O prop do mapa existe, mas não é posicionado corretamente: verifique o arquétipo .ytyp e as referências .ymap.
  • O arquivo funciona no OpenIV ou CodeWalker, mas não no servidor: verifique as entradas fxmanifest.lua data_file e a estrutura da pasta do recurso.

Guias relacionados

file-formatsfivemgta-vydrytdyftyddresources
641 leituras