Como Transmitir Coleções de Roupas Adicionais no FiveM

Transmita roupas adicionais como uma coleção nomeada cujos nomes de drawable, textura e metadados concordam. Mantenha os ativos de vestuário separados do menu de aparência que os seleciona e salva. Renomear arquivos sem atualizar os metadados da coleção pode quebrar tanto a exibição quanto os trajes salvos.

Confirme a edição de GTA de destino antes de instalar ou exportar assets. Pacotes Legacy não estão automaticamente prontos para o Enhanced; siga a orientação oficial de conversão de assets para o Enhanced quando esse for o seu objetivo.

Escolha o fluxo de trabalho correto

Decida se você está adicionando uma coleção de roupas freemode, substituindo um item existente ou adicionando um objeto de mundo comum. Estes usam diferentes nomes e metadados. Confirme o ped masculino ou feminino pretendido e o slot de componente/prop antes de exportar.

Use ativos que você pode modificar e distribuir. Registre o YMTEditor e versões do exportador. Verifique qualquer requisito de licença de servidor atual no Portal Cfx.re; instruções antigas de chave do Patreon não são um procedimento de instalação.

Prepare a coleção

1. Mantenha uma cópia intocada dos ativos de origem. No fluxo de trabalho do editor suportado, crie ou abra a coleção para o ped pretendido.
2. Defina os drawables e suas texturas nos dados YMT. Preserve a convenção de nomenclatura emitida por esse fluxo de trabalho; não remova prefixos de ped ou renumere uma coleção ativa existente casualmente.
3. Gere os metadados de vestuário correspondentes e certifique-se de que o nome da coleção concorda com o YMT e os arquivos exportados. Configure as flags de skin/material de acordo com a documentação do ativo e do editor, não um número universal.
4. Coloque os ativos streamable exportados no diretório stream de um recurso dedicado. Mantenha o arquivo .meta de vestuário no caminho registrado em fxmanifest.lua.

Registre os metadados de vestuário

Para um recurso com customclothes.meta em sua raiz, este é o registro do manifesto. O conteúdo dos metadados em si deve ser gerado para sua coleção real:

fx_version 'cerulean'
game 'gta5'
files { 'customclothes.meta' }
data_file 'SHOP_PED_APPAREL_META_FILE' 'customclothes.meta'

Ver tipos de arquivo de dados Cfx.re. Adicione ensure seguido pelo nome exato da pasta de recursos ao server.cfg após as dependências necessárias.

Integre e teste trajes salvos

Verifique como seu recurso de aparência identifica as roupas. A documentação nativa baseada em coleção explica a seleção local da coleção; os índices globais de drawable podem mudar quando as coleções são alteradas.

No ambiente de teste, teste cada drawable e textura no ped pretendido, animações comuns, recorte e aparência de skin/material. Salve os trajes, reconecte, reinicie e teste os trajes existentes, bem como os novos. Use um cliente novo para detectar arquivos empacotados ausentes.

Se uma atualização alterar os índices de trajes salvos, restaure a coleção e a configuração anteriores enquanto planeja uma migração de dados explícita. Mover uma pasta para um grupo chamado test não a isola de um servidor ativo.