Ped addon invisível ou crashando? Resolva
Um ped addon que carrega como nada, como um manequim cinza ou roxo, ou que crasha o cliente quase sempre se resume a uma de seis coisas. Verifique nesta ordem.
1. Os arquivos não estão em stream/
O FiveM só faz stream de assets dentro de uma pasta chamada stream (em qualquer profundidade abaixo dela). Um ped colocado na raiz do resource, ou numa pasta chamada models, nunca carrega. Confira se todo .ydd, .yft, .ytd e .ymt do ped está dentro de stream/.
2. O peds.meta está faltando ou não é carregado
Um ped novo precisa de uma entrada no peds.meta, e o manifest tem que carregá-lo:
files { 'peds.meta' }
data_file 'PED_METADATA_FILE' 'peds.meta'Sem isso o nome do modelo existe, mas o jogo não tem a definição do ped e não spawna nada, ou volta para um padrão.
3. Os nomes não batem
O nome do modelo no peds.meta, o .yft, o .ydd e o .ytd precisam usar todos o mesmo nome base. Um erro de digitação e as texturas ou os drawables falham sem aviso. Use tudo em minúsculas; evite espaços e hífens.
4. Texturas grandes demais
Um dicionário de texturas grande demais (um único .ytd acima de 16 MB, ou alguns mapas 4K) pode simplesmente não carregar, o que aparece como um ped invisível ou sem textura e, em clientes mais fracos, como crash. Reduza as texturas; um ped raramente precisa de mapas maiores que 2048 px.
5. Um esqueleto que o GTA não conhece
Se o ped aparece mas fica em T-pose, desliza ou tem membros torcidos, o esqueleto e os pesos dele não batem com o que as animações do GTA esperam. Montar sobre o esqueleto freemode evita isso por completo: toda animação e emote roda nele.
6. Coleções de roupas demais
Se adicionar o ped coincide com todo ped MP masculino ou feminino crashando, o problema não é o ped, e sim as coleções de roupas carregadas com ele: o GTA só carrega um número limitado de arquivos de roupa .ymt por gênero. Veja o guia sobre o limite de YMT.
Teste isolado
Suba um servidor só com o seu framework e o ped, e então spawne ele com SetPlayerModel. Se funcionar assim, outro resource está sobrescrevendo o mesmo nome de modelo ou passando de algum limite.
Perguntas frequentes
O ped está invisível, mas vejo a sombra ou o nome dele. Por quê?
O modelo foi carregado, mas os drawables não: normalmente um dicionário de texturas que falhou ao carregar (grande demais ou com nome errado) ou drawables com nomes diferentes do que o modelo espera.
O ped fica em T-pose e não anima. Por quê?
O esqueleto dele não é um que as animações do GTA conhecem. As animações rodam em bones com nome; um ped feito com esqueleto próprio só roda animações feitas para ele.
Um único ped quebrado pode crashar todo mundo?
Sim. Um ped cujos arquivos passam dos limites de streaming ou cujo meta está malformado pode crashar todo cliente que carrega ele, e é por isso que muitas vezes parece um crash aleatório perto de um lugar específico.
Experimente grátis
Crie uma conta grátis, entre no Discord para receber seus créditos e monte seu primeiro asset em minutos.