Adereços não exibidos — o que causa isso?

LODs incorretos, colisões ausentes ou nomes ou caminhos de modelos incorretos. Verifique os erros do console.

Como transmitir roupas/adereços adicionais (modelos FiveM)

Adicionar roupas e adereços personalizados como complementos para modelos MP Freemode no FiveM permite que você ofereça conteúdo mais personalizado e exclusivo aos jogadores do seu servidor. Este guia mostrará passo a passo como transmitir roupas e adereços usando YMTEditor e OpenIV, ajudando você a integrar modelos personalizados perfeitamente ao jogo.

Aviso importante: você precisará adicionar uma chave do Patreon ao seu server.cfg. Veja como isso funciona:
Como adicionar uma chave Patreon ao seu Servidor FiveM

Índice

Termos importantes

Para seguir este tutorial com sucesso, é importante entender alguns conceitos básicos usados no modding do FiveM:

Componente: Refere-se a diferentes partes do corpo do personagem ou espaços de roupa, como cabeça, torso, ou pernas. Existem 12 componentes diferentes, cada um com um slot específico para personalizações (por exemplo, superior para tronco, inferior para pernas).
Suporte: Acessórios que podem ser usados pelo personagem, como chapéus ou óculos. Existem 13 slots de adereços, mas apenas 5 são usados para modelos MP (p_cabeça, p_olhos, p_orelhas, p_lpulso, p_rpulso).
Desenhável: Um .jardas arquivo representando um modelo. Cada componente ou prop pode ter vários drawables (por exemplo, jbib_000_u e jbib_001_u para duas variantes diferentes de torso).
Textura: Um .YTD arquivo aplicado a um modelo desenhável. As texturas devem ser nomeadas corretamente para serem reconhecidas pelo jogo, como xxxx_diff_###_a_uni.
Arquivo YMT: Define quantos componentes, drawables e texturas o jogo usa para personalização de personagens.

Pré-requisitos

Antes de começar, certifique-se de ter as seguintes ferramentas e recursos:

Editor YMT: Usado para edição .ymt arquivos. Baixar YMTEditor.
Aberto IV: Essencial para trabalhar com .jardas e .YTD arquivos. Baixar OpenIV.
Modelos de roupas e acessórios: Obtenha os mods de roupas ou acessórios que você deseja adicionar. Você pode encontrar mods em Mods GTA5.

Preparando seus arquivos

Baixe os Mods de Roupas ou Adereços: Reúna o .jardas e .YTD arquivos para suas roupas e adereços. Certifique-se de que esses arquivos sejam destinados a modelos MP Freemode. Se forem modelos single-player, alguma conversão pode ser necessária.
Organizar os arquivos: Coloque todos os arquivos baixados em uma pasta. Se os arquivos contiverem prefixos como mp_m_freemode_01, remova-os para manter os nomes dos arquivos simples (por exemplo, altere mp_m_freemode_01_jbib_003 para jbib_000).
Renomear os arquivos: Padronizar a numeração para começar em 000 e incrementar a partir daí (por exemplo, jbib_000, jbib_001). Isso ajuda a evitar conflitos e mantém as coisas organizadas.
Adicionar um prefixo personalizado: É uma boa prática adicionar um prefixo aos seus arquivos que corresponda ao nome do seu projeto. Por exemplo, se o seu arquivo YMT for chamado mp_f_freemode_01_roupas personalizadas, então seus arquivos devem ser renomeados adequadamente (por exemplo, mp_f_freemode_01_roupas personalizadas_jbib_000).

Configurando o YMTEditor

Criar um novo arquivo YMT:
- Abra o YMTEditor e selecione Novo.
- Escolha o personagem MP que você está modificando (por exemplo, feminino).
- Nomeie seu arquivo YMT (por exemplo, mp_f_freemode_01_roupas personalizadas). Certifique-se de que o nome esteja todo em letras minúsculas.
Habilite os componentes que você usará:
- Expanda a lista de componentes no YMTEditor e habilite os relevantes (por exemplo, jbib para tronco, inferior para calças).
- Para cada componente, adicione novas entradas para os modelos e texturas que você está adicionando.
Adicionar texturas para cada drawable:
- Por exemplo, se você estiver adicionando calças (inferior), você pode começar com drawable 000 e adicionar texturas até e (25 texturas no total).
- Configure os drawables com o sufixo apropriado _você para universal ou _r para raça específica.
Definir valores de máscara de adereços:
- Se o modelo tiver pele exposta, você precisa alterar o valor da prop mask para 17, 19 ou 21 no YMTEditor. Isso garante que o jogo reconheça os dados da pele.
Salvar o arquivo YMT:
- Salve suas alterações selecionando Arquivo > Salvar (YMT). Certifique-se de que o nome do arquivo permaneça consistente.

Criando Meta Arquivos

Criar um .meta arquivo para definir como suas roupas e acessórios complementares se integram ao jogo.

Crie o Meta Arquivo:
- Use um editor de texto para criar um novo arquivo chamado mp_f_freemode_01_roupaspersonalizadas.meta.
Adicione a seguinte estrutura XML:

mp_f_modo_livre_01 roupas personalizadas mp_f_freemode_01_roupas personalizadas SCR_CHAR_MULTIJOGADOR_F MP_CreatureMetadata_roupas personalizadas

Configurando o FXManifest

Crie o arquivo FXManifest:
- Na pasta que contém seu YMT e .meta arquivos, crie um novo arquivo chamado fxmanifest.lua.
Adicione o seguinte conteúdo:

fx_version 'cerulean' jogo 'gta5' arquivos { 'mp_f_freemode_01_customclothes.meta' } arquivo_de_dados 'SHOP_PED_APPAREL_META_FILE' 'mp_f_freemode_01_customclothes.meta'

Certifique-se de que os caminhos e nomes dos arquivos correspondem aos usados no seu projeto.
Adicione seu recurso a servidor.cfg:
- Abra o seu servidor servidor.cfg arquivo.
- Adicione a linha iniciar roupas personalizadas (ou use o nome da pasta do seu projeto).

Tutorial completo: FXManifest

Teste e solução de problemas

Carregue seu servidor:
- Inicie o servidor e conecte-se no FiveM.
- Use um editor de personagens (como o vMenu) para navegar até os novos componentes de roupa.
Verificar se há problemas:
- Se as roupas não aparecerem, certifique-se de que todos os nomes de arquivos sejam consistentes.
- Verifique se o arquivo YMT referencia corretamente todos os drawables e texturas.
- Verifique o FXManifest e .meta arquivos para quaisquer erros de digitação ou entradas ausentes.
Problemas comuns:
- Roupas não mostradas: Certifique-se de que o arquivo YMT foi salvo corretamente e que o FXManifest inclui todos os arquivos necessários.
- Texturas não estão carregando: Verifique novamente a convenção de nomenclatura das texturas e certifique-se de que elas correspondem aos nomes dos arquivos desenháveis.
- Problemas de cor da pele: Se o modelo incluir pele, certifique-se de ter definido o valor da máscara de acessório como 17, 19 ou 21.

Perguntas frequentes

P: Quais arquivos são necessários para roupas/adereços?
R: Roupas usam .ydd/.ytd; acessórios usam .ydr/.ytd. Coloque-os em stream/.

P: Preciso editar o ped.ymt?
R: Prefira frameworks como mpclothes para slots de modo livre. Editar ped.ymt diretamente é frágil.

P: Como o recurso deve ser estruturado?
R: /resources/[stream]/your_clothes/stream/* com um fxmanifest.lua. Adicione entradas de arquivo, se necessário, por tipo.

P: Funciona no QBCore e no ESX?
R: O streaming é o mesmo; o uso depende do seu guarda-roupa/script de roupas por estrutura.

P: Por que as texturas são pretas ou invisíveis?
R: Materiais/UVs incorretos, mipmaps ausentes ou texturas grandes demais. Exporte como DDS (BC3/BC7) com mipmaps.

P: Adereços não são exibidos — o que causa isso?
R: LODs incorretos, colisões ausentes ou nomes/caminhos de modelo incorretos. Verifique os erros do console.

P: Como faço para atualizar com segurança em servidores ativos?
R: Carregue em uma pasta [teste], verifique com alguns jogadores, depois mova para [stream] e reinicie fora do horário de pico.

P: Nomeando as melhores práticas?
Nomes de recursos em letras minúsculas, sem espaços, evite pastas versionadas, mantenha um registro de alterações e miniaturas.

Seguindo esses passos, você deve conseguir transmitir com sucesso roupas e adereços personalizados como complementos para modelos MP Freemode no FiveM. Isso dará ao seu servidor um toque único e permitirá que os jogadores personalizem seus personagens com uma gama maior de opções.

Sinta-se à vontade para pedir mais ajuda ou compartilhar seu conteúdo personalizado com Comunidade FiveM!