FiveM Peds: Instale, Teste e Escolha Modelos Personalizados

Os peds do FiveM são modelos de personagem usados para jogadores, empregos, NPCs ambientes ou cenas roteirizadas. Um ped add-on normalmente adiciona um novo nome de modelo; um ped de substituição sobrescreve um modelo existente do GTA V. Os add-ons geralmente são mais fáceis de isolar e reverter, enquanto as substituições podem afetar qualquer recurso que chame o modelo original.

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.

Base técnica: Revisado em 9 de agosto de 2026 contra o Cfx.re oficial documentação do manifesto de recursos. Sempre siga a licença e as notas de instalação do próprio pacote.

O que um pacote de ped deve conter

Um modelo streamable normalmente inclui arquivos de drawable e de textura, além de um manifesto de recurso. Os arquivos exatos variam conforme o tipo de modelo. Não renomeie arquivos nem os copie para outro recurso antes de entender a estrutura do pacote; os nomes dos modelos, os metadados e as referências nos scripts precisam continuar correspondendo.

Adicional ou substituto?

Tipo	Melhor para	Principal risco
Ped adicional	Personagens nomeados, profissões e modelos de jogador opcionais	Conflitos de nome de modelo ou um script que não suporta modelos personalizados
Ped substituto	Uma substituição visual global deliberada	Mudanças inesperadas onde quer que o modelo original seja usado
NPC por script	Lojas, missões e cenas	Erros de spawn no lado do cliente, de propriedade de rede ou de limpeza

Fluxo de trabalho de instalação

1. Verifique a licença e confirme se a redistribuição e o uso em servidores comerciais são permitidos.
2. Crie um recurso dedicado em vez de misturar modelos não relacionados.
3. Mantenha o manifesto e a estrutura de pastas fornecidos, a menos que a documentação diga o contrário.
4. Adicione o recurso à configuração do servidor de teste e reinicie em uma janela controlada.
5. Faça o spawn do modelo pelo comando, menu ou script documentado — não por um comando universal presumido.
6. Teste reconexão, roupas/componentes, animações, veículos, armas e renderização à distância.

Verificações de desempenho e qualidade

• Inspecione a resolução da textura e o tamanho do arquivo. Um ped visualmente simples ainda pode ter texturas superdimensionadas.
• Teste várias cópias de uma vez; um único modelo em uma cena vazia não representa um servidor movimentado.
• Fique atento a texturas faltando, níveis de detalhe quebrados, clipping e incompatibilidade de animações.
• Confirme que as entidades NPC geradas sejam removidas pelo script que as cria quando a cena dele termina ou quando ele é parado; o recurso de streaming por si só não é responsável por esse ciclo de vida.
• Verifique a saída do console F8 do cliente e do console do servidor em busca de erros de streaming ou de modelo.

Falhas comuns

Se o modelo estiver invisível, verifique se o recurso foi iniciado e se o nome do modelo solicitado corresponde aos arquivos transmitidos. Se as texturas estiverem faltando, restaure os nomes de arquivo originais e a estrutura do pacote. Se apenas um script não conseguir selecionar o ped, confirme se o script suporta modelos adicionais e se qualquer lista de permissões usa o nome correto. Reverta o recurso dedicado se travamentos ou pressão de memória começarem após a implantação.

Antes de publicar um ped

Mantenha o criador, licença, versão, URL de origem e notas de instalação com o recurso. Evite republicar um modelo quando a licença estiver ausente. Para decisões de compra em todo o servidor, use a lista de verificação de pré-compra do RPScripts.