THE ORB
Iniciando o studio

Modelo 3D → FiveM: guia e tutorial

Entra um modelo 3D, sai um prop de FiveM: com texturas e colisão.

O tutorial em vídeo chega em breve

Enquanto isso, o guia escrito abaixo te leva por cada passo.

O que é

O 3D Model → FiveM pega um modelo 3D que você já tem (do Meshy, do Blender, do Sketchfab, do Prop Creator ou da Prop Library) e transforma em um prop que o seu servidor pode usar. Você vê o modelo em tamanho real ao lado de uma pessoa de 1,80 m, recebe uma nota de quanto ele pesa para o seu servidor, reduz se precisar, escolhe do que ele é feito e baixa um resource: uma pasta que você solta em resources/. Dentro vêm os arquivos do jogo (modelo .ydr, texturas e colisão) e um script pequeno que dá a você um /comando para colocar o prop onde você estiver. Sem código e sem Blender da sua parte.

Para quem é

  • Donos de servidor que têm um modelo 3D e querem ele na cidade como prop.
  • Mappers que precisam de alguns objetos próprios para uma loja, uma casa ou um emprego.
  • Quem vem do Prop Creator ou da Prop Library e quer ajustar o prop antes de baixar.

Antes de começar

  • Uma conta THE ORB. Ver um modelo é grátis e acontece no seu navegador; para converter, você precisa estar logado.
  • Um modelo em .glb, .gltf (com o .bin e as texturas) ou .obj (com o .mtl e as texturas). Outros formatos precisam ser exportados para um destes antes.
  • Depois de otimizado, o modelo precisa pesar 12 MB ou menos para ser enviado para conversão.

Carregue o seu modelo

A barra da esquerda tem quatro passos: Modelo, Prop, Material e Pacote. Você começa em Modelo.

  1. 1

    Solte o arquivo

    Arraste o modelo para o visualizador, ou clique em Escolher um .glb. Para um .obj, solte o .obj junto com o .mtl e as imagens de textura de uma vez. Para um .gltf solto, solte com o .bin e as texturas. O arquivo é lido no seu navegador; nada é enviado ainda.

  2. 2

    Ou comece pela biblioteca

    Clique em Da biblioteca para abrir a Prop Library dentro da ferramenta. Escolha um objeto e ele carrega aqui já em tamanho real, com o crédito da licença junto.

  3. 3

    Ou traga do Prop Creator

    No Prop Creator, Transformar em prop de FiveM abre esta página com o modelo gerado já carregado.

  4. 4

    Solte vários de uma vez

    Se você soltar mais de um modelo, cada um vai direto para o seu pack (veja a seção do pack abaixo). Quantos cabem de uma vez depende do seu plano.

O modelo em que você está trabalhando fica guardado neste aparelho. Se você fechar a aba, na próxima visita aparece Retomado e ele volta. Começar de novo apaga tudo.

Compare o tamanho com uma pessoa

Modelos feitos por IA ou exportados de outro programa costumam vir 100 vezes grandes ou pequenos demais. No jogo, isso vira uma caixa do tamanho de um prédio, ou uma que ninguém acha. O visualizador coloca uma figura de 1,80 m ao lado do modelo e uma grade de um metro embaixo dele, para você ver na hora.

  1. 1

    Leia o aviso

    Se o lado mais comprido passar de 20 m ou ficar abaixo de 5 cm, um aviso acima do visualizador diz que parece uma exportação errada.

  2. 2

    Defina a altura

    No controle Altura, arraste o slider ou digite a altura que ele deve ter em metros. Restaurar volta ao tamanho original. O novo tamanho é gravado no modelo quando você baixa ou envia.

  3. 3

    Teste na mão

    Para algo que o jogador segura, clique em Na mão. O personagem do jogo segura o seu prop com uma animação que você escolhe (em pé, celular, copo, garrafa, caixa, papéis e mais). Mova e gire até o lugar certo e defina o tamanho ali. Você também pode enviar uma animação sua (.ycd, .fbx, .bvh ou .glb) só para a prévia.

  4. 4

    Copie a linha do emote

    Ainda em Na mão, Copiar a linha do emote dá uma linha pronta para o rpemotes (AnimationList.lua) e para menus com o mesmo formato, com a posição que você definiu.

  5. 5

    Ande em volta

    Modo jogador deixa você andar em volta do prop como um personagem, e Primeira pessoa mostra ele da altura dos olhos. Malha, Textura e Pessoa ligam e desligam essas camadas.

Veja quanto ele pesa e otimize

Abra o passo Prop. A primeira linha, Carga no servidor, dá ao modelo uma nota de 0 a 100 e uma frase sobre o que isso significa para os seus jogadores, seguida dos motivos: triângulos demais para o tipo, texturas grandes, muitos materiais, arquivo pesado ou um tamanho estranho.

  1. 1

    Diga o que ele é

    Em O que é?, escolha o tipo mais próximo. Cada um tem o próprio orçamento, e a nota é medida contra ele.

  2. 2

    Arrume

    Se o modelo tem muitas malhas ou materiais separados, aparece um botão Arrumar. Ele junta o que dá sem mudar a aparência do prop.

  3. 3

    Veja a otimização antes

    Clique em Ver otimizado (ou Otimizar para o orçamento). O visualizador troca para a versão otimizada e mostra os triângulos e o tamanho do arquivo antes e depois. Alterne entre Original e Otimizado para comparar.

  4. 4

    Escolha o que vai

    Em O que vai no zip, escolha Otimizado ou Como está. Otimizado vem ligado por padrão.

TipoParaTriângulos atéTexturas até
Objeto de mãona mão, arremessado, em cima de uma mesa10.0002048 px
Móveisinteriores, lojas, casas12.0002048 px
Prop de ruabarracas, placas, decoração15.0002048 px
Peça principaluma peça central vista de perto50.0004096 px

Prop de rua vem selecionado por padrão. Uma Peça principal funciona bem para um ponto de destaque, mas uma rua cheia delas vai aparecer no FPS dos seus jogadores.

Escolha do que ele é feito

Abra o passo Material. Ele define como o prop soa e reage quando leva um tiro, uma pancada ou quando alguém pisa nele. Não muda a aparência. A colisão (a forma invisível em que jogadores e carros batem) vem sempre incluída e segue a forma do próprio modelo.

  1. 1

    Escolha uma superfície

    Em Do que é feito?, escolha uma: Padrão, Madeira (maciça), Madeira (oca), Metal (maciço), Metal (oco), Concreto, Pedra, Vidro, Plástico, Plástico (oco), Borracha, Papelão, Tecido ou Terra. Cada uma mostra uma linha curta com exemplos. Padrão mantém a superfície neutra que todo prop tinha antes.

  2. 2

    Ajuste o brilho (opcional)

    Em Como brilha (shader), Automático escolhe o shader do jogo pelos mapas que o seu modelo traz. Você pode forçar normal_spec, normal, spec, default (cor lisa) ou emissive (a textura brilha, para placas e telas).

  3. 3

    Ajuste fino dos números (opcional)

    Relevo, Brilho e Queda começam no padrão do jogo. Clique em um para definir um valor seu. Voltar ao automático restaura tudo. A prévia é parecida com o jogo, não idêntica.

Dê um nome e adicione o comando para posicionar

  1. 1

    Digite o nome do prop

    Em Nome do prop, digite um nome. Ele é limpo para letras minúsculas, números e underlines. Esse nome vira o nome do modelo no jogo e o nome do comando, então use um que não se repita no seu servidor.

  2. 2

    Deixe o comando ligado

    Colocar um /comando no zip vem ligado por padrão. Com ele, o resource adiciona um comando com o nome do prop: fique na cidade onde você quer o prop e digite o comando.

  3. 3

    Desligue se você posiciona props de outro jeito

    Se você usa um editor de mapa ou outro script de posicionamento, desmarque. Aí o zip só traz os arquivos do modelo.

Coloque vários props em um resource

Um pack são vários props em uma pasta, cada um com o próprio comando. Uma pasta para soltar, uma linha no server.cfg.

  1. 1

    Adicione o primeiro

    Com um modelo carregado e com nome, clique em Adicionar a um pacote. O prop mantém o próprio tipo, colisão e escolha de otimização.

  2. 2

    Adicione mais

    Clique em Adicionar outro prop e solte o próximo modelo. Abra o passo Pacote, à esquerda, para ver a lista e o total de triângulos, e clique em qualquer prop para editar de novo.

  3. 3

    Dê um nome ao pack

    Digite um Nome do pack. Ele vira o nome da pasta do resource.

  4. 4

    Baixe

    Clique em Baixar pack. Cada prop é otimizado e convertido separadamente, um depois do outro, e depois todos são juntados em um só resource.

Quantos props cabem em um pack depende do seu plano e de quantas conversões você ainda tem. Cada prop do pack conta como uma conversão.

Projetos e conversões que você já fez

  • Meus projetos guarda o seu pack para você voltar a ele. Os projetos ficam salvos neste navegador, e os planos pagos também guardam uma cópia na sua conta.
  • Já convertidos, embaixo do painel, lista o que você converteu antes. Clique em um para baixar de novo. Os arquivos convertidos ficam guardados por 30 dias.
  • Se o modelo veio da Prop Library ou de outra fonte aberta, o autor e a licença aparecem embaixo do visualizador e o crédito vai no zip.

O que você baixa

Clique em Exportar este prop (ou Baixar pack). O modelo é otimizado no seu navegador, se você escolheu isso, enviado e convertido no nosso servidor com o Blender. Você vê Na fila, depois Convertendo no Blender e depois Empacotando o resource. Um prop leva mais ou menos um minuto; dá para acompanhar o progresso no painel.

Você recebe um .zip com o nome do seu prop. Dentro dele:

O que vem no zip
<prop>/
  fxmanifest.lua
  stream/<prop>.ydr        the model
  stream/<prop>.ytd        the textures (when the model has them)
  stream/<prop>.ybn        the collision
  stream/<prop>.ytyp       registers the model so it can be spawned by name
  client.lua               /<prop> and /<prop>_view (if the command is on)
  html/index.html          the viewer screen used by /<prop>_view
  ATTRIBUTION.txt          the author's credit (only for library or open models)
  INSTRUCTIONS.txt / LEEME.txt / LEIAME.txt

Um pack tem a mesma estrutura, com uma pasta por prop dentro de stream/, um client.lua com um comando para cada prop e um ATTRIBUTION.txt com todos os créditos.

No plano Free, cada conversão gasta créditos. Os planos pagos convertem sem limite. Veja os preços.

Instalar no seu servidor

  1. 1

    Descompacte em resources

    Coloque a pasta dentro da pasta resources/ do seu servidor.

  2. 2

    Adicione ao server.cfg

    Adicione a linha ensure <prop> com o nome do seu prop.

  3. 3

    Reinicie

    Reinicie o servidor, ou digite refresh e depois ensure <prop> no console do servidor.

  4. 4

    Posicione

    Na cidade, fique onde você quer o prop e digite /<prop>. Ele aparece 1,5 m na sua frente, no chão, virado para onde você está olhando. /<prop> undo tira o último que você colocou.

  5. 5

    Veja de perto

    Digite /<prop>_view para ver ele flutuando na sua frente. Arraste com o mouse ou use W A S D para girar, a rodinha para dar zoom e Esc para sair. G abre o modelo 3D original ao lado para comparar.

Com um servidor conectado pelo ORB Core, você pode pular o zip: clique em Enviar ao servidor em vez de baixar. O pack vai para resources/[orb]/[props]/ e liga sozinho, e os admins online recebem uma mensagem no chat. Para conectar um servidor pela primeira vez, clique em Conecte seu servidor e siga os três passos.

Os props colocados com o comando não ficam salvos em lugar nenhum: somem quando o servidor reinicia. O comando serve para testar e para posicionar rápido. Para algo fixo, use a sua ferramenta de mapa com o nome do prop.

Problemas comuns

Diz que o modelo continua grande demais depois de otimizar.

O limite para enviar um modelo é 12 MB. Escolha um tipo mais leve em O que é?, que reduz os triângulos e o tamanho das texturas, e tente de novo. Uma Peça principal mantém texturas de 4096 px e é a que mais costuma passar do limite.

O prop fica enorme ou minúsculo no jogo.

O tamanho que você vê ao lado da pessoa é o tamanho com que ele sai. Volte, defina a Altura antes de exportar e baixe de novo.

O prop não aparece quando eu digito o comando.

Confira se o nome da pasta em resources/ bate com a linha do ensure, se você reiniciou o servidor e se digitou o nome do prop exatamente como está no zip. Se /<prop>_view disser que o modelo não carregou, os arquivos do jogo não estão chegando aos jogadores: confira se a pasta está completa.

As texturas ficam borradas no jogo.

O tipo que você escolheu limita o tamanho das texturas. Objeto de mão, Móveis e Prop de rua vão até 2048 px, Peça principal até 4096 px. Escolha um tipo maior, ou mande Como está se o original já for leve.

Diz que eu já usei as conversões de hoje.

A janela mostra quanto custa mais uma conversão em créditos, se o seu plano permitir, ou você pode fazer upgrade. Conversões que falharam não contam.

Diz que eu preciso estar no Discord.

No plano Free, para converter você precisa ser membro do Discord da THE ORB com a mesma conta com que fez login. Entre e tente de novo.

Perguntas frequentes

Preciso do Blender?

Não. A conversão para arquivos do jogo roda no nosso servidor com o Blender. Você só precisa do arquivo do modelo.

Posso converter modelos que eu achar na internet?

Só se a licença permitir. Nos modelos da Prop Library, o crédito vai em ATTRIBUTION.txt dentro do resource. Mantenha esse arquivo: a licença pede isso.

Os jogadores podem usar o /comando?

O comando em client.lua não verifica permissão, então qualquer pessoa no servidor pode digitar. Se você não quer isso, desmarque Colocar um /comando no zip, ou apague o client.lua e a linha dele no fxmanifest.lua.

Posso baixar uma conversão de novo depois?

Sim, por 30 dias. Abra Já convertidos na ferramenta e clique na que você quer.

O que acontece se a conversão falhar do nosso lado?

Ela não conta nas suas conversões, e nas conversões pagas os créditos voltam.

Conferido com a ferramenta em 15 de novembro de 2026.

Experimente o Modelo 3D → FiveM agora

Suba um modelo 3D do Meshy ou do Blender e receba um prop de FiveM, com texturas e colisão, pronto para jogar no seu servidor.

Mais guias de Props e modelos