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: revisada em 9 de agosto de 2026 com base na documentação oficial de manifestos de recursos da Cfx.re. Siga sempre a licença e as instruções 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
- Verifique a licença e confirme se a redistribuição e o uso em servidores comerciais são permitidos.
- Crie um recurso dedicado em vez de misturar modelos não relacionados.
- Mantenha o manifesto e a estrutura de pastas fornecidos, a menos que a documentação diga o contrário.
- Adicione o recurso à configuração do servidor de teste e reinicie em uma janela controlada.
- Faça o spawn do modelo pelo comando, menu ou script documentado — não por um comando universal presumido.
- 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 RPCrate.