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.
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ão | Significado comum | Geralmente se vincula a | Ferramentas do Zoovdev |
|---|---|---|---|
.ydr | Modelo 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 |
.ytd | Dicioná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 |
.yft | Modelo 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 |
.ydd | Dicioná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 |
.ytyp | Definiçõ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 / .ybd | Dados 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. |
.ycd | Dicioná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. |
.ymap | Arquivo 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 / .xml | Metadados. 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. |
.rpf | Arquivo 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. |
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.metaconecta o nome do modelo, a classe do veículo, o layout, o áudio e outras definições do veículo.handling.metacontrola o comportamento de condução.carvariations.metaassocia pinturas, cores, extras e dados de variação.carcols.metageralmente 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.
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 origem | Para que geralmente serve | Resultado final |
|---|---|---|
.png / .jpg | Origem de textura, ícone, decalque, logótipo ou imagem de referência. | .ytd, .dds ou fluxo de trabalho de prop baseado em imagem. |
.psd | Trabalho de textura em camadas no Photoshop ou Photopea. | Entrada de textura .ytd pelo plugin ou editor. |
.glb / .fbx / .obj | Origem de modelo 3D do Blender, Sketchfab ou outra ferramenta de modelagem. | Prop .ydr, depois geralmente .ytd e .ytyp. |
.dds | Formato de textura comprimida usado em muitos fluxos de trabalho de jogos. | Entrada do dicionário de texturas .ytd. |
Associe a ferramenta ao arquivo
| Tarefa | Comece com | Use |
|---|---|---|
| Criar um prop de FiveM a partir de um modelo | .glb, .fbx, .obj | Model to Prop |
| Criar um prop a partir de uma imagem plana | .png, .jpg | Image to Prop |
| Criar um dicionário de texturas | .png, .jpg, .dds | Image to YTD |
| Mapear um veículo para pinturas | .yft.xml exportado do CodeWalker | Livery Creator |
| Editar ou visualizar texturas | .ytd, modelo de veículo, modelo de roupas, PSD | Design Editor ou Photoshop Plugin |
| Reduzir o tamanho do arquivo antes do lançamento | .ydr, .ytd, .yft, .ydd | Ferramentas de otimização para texturas, props, veículos e roupas. |
| Tornar um prop utilizável em posicionamentos no mapa | .ydr | Prop 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.ytypou de metadados. - O modelo está branco ou cinza: verifique o
.ytde os nomes das texturas que o modelo espera. - O veículo aparece, mas não tem pinturas: verifique
carvariations.metae 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
.ytdcorrespondente está presente. - O prop do mapa existe, mas não é posicionado corretamente: verifique o arquétipo
.ytype as referências.ymap. - O arquivo funciona no OpenIV ou CodeWalker, mas não no servidor: verifique as entradas
fxmanifest.luadata_filee a estrutura da pasta do recurso.