THE ORB
Iniciando o studio

Criador de armas: guia e tutorial

Entra o seu modelo, sai uma arma add-on.

O tutorial em vídeo chega em breve

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

O que é

O Weapon Creator transforma um modelo 3D em uma arma add-on para FiveM: uma arma nova que fica ao lado das armas do próprio jogo, com nome, números e acessórios próprios. Você começa de uma arma do jogo, de um .glb seu ou de uma gerada por IA. Depois passa por oito passos: escolhe o tipo e o tamanho, monta os acessórios, posiciona os pontos que o jogo lê (de onde sai o tiro, para onde voam os cartuchos, onde vai a mão esquerda), pinta, define os números, alinha a mira em primeira pessoa e constrói. Você recebe um resource com o modelo e o esqueleto, os arquivos meta de que o jogo precisa e comandos de teste. Funciona em servidores standalone e com ox_inventory, QBCore e ESX.

Para quem é

  • Donos de servidor que querem uma arma própria para uma gangue, um emprego ou um evento, sem artista 3D nem programador.
  • Donos que têm o modelo de uma arma mas não sabem como dar a ele um esqueleto e arquivos meta.
  • Quem quer uma versão de uma arma do GTA V com outra skin ou outros números, com nome próprio.

Antes de começar

  • Uma conta THE ORB. Para construir, você precisa estar logado.
  • Uma destas opções: uma arma do jogo da lista, um modelo seu em .glb ou .gltf com o cano apontando para frente (até 48 MB), ou créditos para gerar uma com IA.
  • Acesso aos arquivos do seu servidor e ao server.cfg, e reiniciar o servidor no final.

Passo 1: Modelo

A barra da esquerda mostra os oito passos em ordem. Avançar leva você ao próximo, e dá para voltar a qualquer passo que você já fez. Ver o tour, lá em cima, mostra tudo na primeira vez.

  1. 1

    Comece de uma arma do jogo

    Em Armas do jogo, procure na lista e clique em uma. Ela carrega com os próprios ossos e pontos de acessório, onde o jogo os coloca. Dê um nome depois e ela vira uma arma sua.

  2. 2

    Ou use um modelo seu

    Em Use o seu próprio modelo, solte um .glb ou .gltf, ou clique em Escolher. O cano precisa apontar para frente. A ferramenta mede o comprimento e sugere um tipo (pistola, fuzil etc.) a partir disso. Se o modelo chegou grande ou pequeno demais, ele é redimensionado e você fica sabendo.

  3. 3

    Ou gere uma com IA

    Em Gerar com IA, escolha Texto e descreva a arma, por exemplo uma submetralhadora compacta de coronha dobrável, ou escolha Imagem e solte uma foto ou uma arte conceitual. Escolha um Tipo, ou Detectar na imagem. Clique em Gerar. Leva mais ou menos um minuto e você pode continuar navegando: fica em Tarefas.

  4. 4

    Reabra o que você fez

    Suas lista as armas que você já gerou. Clique em uma para abrir sem pagar de novo.

Seu texto é verificado antes de gastar qualquer coisa: ele precisa descrever uma arma. Se o gerador recusar ou falhar, você não paga nada. Se o que saiu não for uma arma, Mover para o criador de props manda para lá.

Passo 2: Tipo e tamanho

O tipo define como o personagem segura a arma, as animações, o som e os números padrão. Um fuzil não se segura como uma pistola.

  1. 1

    Escolha o tipo

    Em Tipo: Pistola, Submetralhadora, Fuzil de assalto, Espingarda, Sniper, Metralhadora, Pesada, De arremesso, Corpo a corpo ou Outra. Se o comprimento do modelo for de outro tipo, um aviso oferece Usar <tipo>.

  2. 2

    Defina o tamanho

    Em Tamanho, defina o comprimento em centímetros. A ferramenta mostra o tamanho de armas parecidas do jogo para você acertar a medida. Voltar ao tamanho com que o arquivo veio desfaz a mudança.

  3. 3

    Deixe em pé

    Em Parada, use Quartos de volta ou digite os graus exatos se ela veio girada. Também dá para usar Girar acima do visualizador: arraste os anéis.

  4. 4

    Encaixe na mão

    Use Mover acima do visualizador para deslizar a arma na mão do personagem; os acessórios vão junto. Comparar coloca uma arma do GTA V do mesmo tipo ao lado da sua, em tamanho real, para você ver se ficou certa.

Passo 3: Acessórios

Os acessórios são componentes de arma de verdade do GTA: aparecem na roda de armas, se colocam e se tiram como qualquer acessório do jogo, e os outros jogadores veem. São cinco slots: Carregador, Mira, Silenciador, Lanterna e Empunhadura. Armas corpo a corpo não levam nenhum.

  1. 1

    Separe as peças do modelo

    Se o seu modelo tem peças soltas, elas aparecem em Peças do modelo. Para cada uma, diga o que ela é: Parte da arma, um dos slots de acessório, Munição (o que dispara) ou Jogar fora.

  2. 2

    Escolha o que vai em cada slot

    Para cada slot, escolha Sem montar, Só o osso (declara o ponto, mas sem modelo), um dos componentes do próprio jogo para esse slot, ou um seu (uma peça recortada do seu modelo ou gerada junto com a arma).

  3. 3

    Ajuste tamanho e inclinação

    Clique em um slot para selecionar. Se ele tem modelo próprio, abrem Tamanho e Inclinação. Só aquela peça se mexe; a arma fica onde está. Clique duas vezes no tamanho para voltar ao valor original.

  4. 4

    Arrume tudo

    Mostrar todas e Ocultar todas ligam e desligam todos os acessórios no visualizador. Alinhar peças zera a inclinação própria de cada peça. Reiniciar tudo devolve cada acessório ao ponto medido.

Se você começou de uma arma do jogo, a ferramenta avisa quando essa arma não aceita um certo acessório no jogo. Você ainda pode adicionar; confira onde ele fica no visualizador.

Passo 4: Bones

Os ossos são pontos invisíveis dentro do modelo que o jogo lê. Eles viajam dentro do arquivo do modelo, por isso você os posiciona aqui e não num arquivo de texto depois. Eles começam num ponto padrão medido para o tipo; este passo serve para o ajuste fino.

  1. 1

    Veja o que é cada ponto

    Toque em um ponto da arma. O painel explica o que ele faz: gun_muzzle é de onde saem o clarão e as balas, gun_vfx_eject é para onde voam os cartuchos, Mão esquerda é onde a outra mão segura, e os pontos WAP são onde os acessórios se montam.

  2. 2

    Arraste até o lugar

    Arraste o ponto sobre a arma. Segure Shift para empurrar para frente ou para trás. Ctrl+Z desfaz, Ctrl+Shift+Z refaz; as setas ao lado do visualizador fazem o mesmo.

  3. 3

    Teste o cano

    Clique em Tiro para disparar uma vez no visualizador. O clarão sai do gun_muzzle, igual no jogo.

A mão direita não se mexe: ela é o punho. Se a arma ficou deslocada ou torta na mão, use Mover e Girar acima do visualizador, que movem a arma inteira com os pontos.

Passo 5: Visual

  1. 1

    Skins de fábrica

    Para uma arma do jogo, Skins de fábrica mostra as cores que ela tem no jogo. Clique em uma para usar.

  2. 2

    Pinte cada parte

    Em Pintura aparecem todos os materiais do modelo. Dê a cada um uma cor das amostras, Qualquer outra cor ou Usar uma imagem. Voltar à textura original do modelo desfaz. Cor dos acessórios pinta os acessórios.

  3. 3

    Skin de vídeo (opcional)

    Cole o link de um arquivo de vídeo (precisa começar com http:// ou https://). No jogo, ele roda na arma enquanto o resource estiver ligado; não fica dentro do modelo e não aumenta o tamanho dele. Um clipe em loop que preencha o quadro funciona melhor.

  4. 4

    Partículas (opcional)

    Escolha um efeito de partículas do GTA para rodar na arma enquanto ela estiver na mão, ou Próprio, com qualquer nome de efeito ou um arquivo .ypt seu. Defina Cor, Tamanho, Opacidade, de onde ele sai e se fica em loop.

  5. 5

    Parte animada (opcional)

    Adicione um GIF ou um vídeo (.gif, .mp4 ou .webm), clique na arma para posicionar e defina tamanho e rotação. Ele é gravado na textura da arma e roda sozinho no jogo. Para construir, você precisa do Chrome ou do Edge.

Tudo, menos a skin de vídeo, vai dentro do próprio modelo: o que você vê no visualizador é o que vai para o jogo.

Passo 6: Números

  1. 1

    Defina os números

    Dano, Carregador, Cadência, Alcance, Velocidade de recarga e Recuo. Cada um começa num valor razoável para o tipo. Em armas corpo a corpo, Dano multiplica o golpe do próprio jogo (x1 é igual ao original).

  2. 2

    Modo de tiro

    Como <tipo>, Uma por clique ou Automático.

  3. 3

    O que ela dispara

    Balas, por padrão. Você também pode escolher granadas, foguetes, foguetes teleguiados, sinalizadores, fogos de artifício, EMP, munição incendiária ou explosiva, um raio laser, um taser e mais. Armas corpo a corpo escolhem um estilo: faca, facão, cassetete, machado, taco ou soco-inglês.

  4. 4

    Som do tiro

    Escolha com qual arma ela soa. Ajustes do disparo tem opções extras para a munição escolhida.

Passo 7: Mira

Este passo só afeta a primeira pessoa: onde a arma fica na frente da câmera quando você mira pela alça. Não muda o jeito como a arma é segurada.

  1. 1

    Alinhe a mira

    Mexa em Cima / baixo, Frente / trás, Esquerda / direita e Giro até a mira ficar alinhada com o ponto no centro. Zero é a posição do próprio jogo.

  2. 2

    Confira no jogo

    Construa uma vez, entre no jogo e mire com /orbaim (vem no resource). Copie de volta para este passo os quatro valores que ele mostra, para o próximo build já sair com eles.

Passo 8: Construir

  1. 1

    Dê um nome

    Digite um nome. Ele vira o nome da arma no jogo, WEAPON_<NAME>, que é o que você dá aos jogadores e registra no seu inventário.

  2. 2

    Confira o resumo

    Resumo mostra o tipo, quantos acessórios têm modelo, quantas partes estão pintadas e O que vem no zip. Se você nunca mexeu nos ossos, se algum acessório está vazio ou se um osso ficou fora da arma, um aviso mostra; mesmo assim dá para construir.

  3. 3

    Escolha o pack

    Em Pacote, escolha em qual pack o build entra, ou Novo pack para começar um. Um pack é um resource com várias armas, e o nome dele é o nome da pasta.

  4. 4

    Construa

    Clique em Construir arma. A pintura é gravada, o modelo é enviado e o nosso servidor escreve os arquivos do jogo. Quando termina, a arma entra no pack.

  5. 5

    Baixe ou envie

    Clique em Baixar a arma, ou em Baixar todas as N para um pack. Com um servidor conectado, Enviar ao servidor instala lá direto.

Seu trabalho vai sendo salvo na sua conta. Projetos, lá em cima, lista todas as armas com nome para você reabrir depois. Compartilhar na galeria publica a arma inteira para que outras pessoas façam um remix de uma cópia.

O que você baixa

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

O que vem no zip
<pack>/
  fxmanifest.lua
  config.lua                      test commands and permissions
  data/weapons.meta               damage, fire rate, clip, range, attach points
  data/weaponcomponents.meta      the attachments (when it has any)
  data/weaponanimations.meta      how it is held, fired and reloaded
  data/weaponarchetypes.meta      one entry per model
  data/pedpersonality.meta        how it is drawn from the holster
  client/names.lua                names in the weapon wheel
  client/commands.lua             test commands
  client/aim.lua                  /orbaim
  server/commands.lua             gives the weapon for the test commands
  server/aim.lua                  saves /orbaim results
  images/                         inventory icons (transparent PNG)
  stream/                         the models (.ydr) and textures (.ytd)
  README.md / LEEME.md / LEIAME.md

Dependendo do que você usou, ele também traz client/laser.lua (mira laser), client/video.lua e html/video.html (skin de vídeo), client/particles.lua (partículas) e html/*_anim.webm (parte animada).

Só os arquivos meta, ao lado do contador de builds, baixa apenas os arquivos meta, para quem quer editá-los na mão.

Créditos: armas do jogo, um .glb seu e o build não gastam créditos de IA. Gerar uma arma com IA custa 40 créditos, cobrados só se ela sair. No plano Free, cada build conta como uma conversão e gasta créditos; os planos pagos constroem sem limite diário. Veja os preços.

Instalar no seu servidor

  1. 1

    Solte a pasta

    Coloque a pasta do pack em resources/ do seu servidor.

  2. 2

    Dê ensure

    Adicione ensure <pack> ao server.cfg.

  3. 3

    Reinicie e reconecte

    Reinicie o servidor e reconecte. Os dados das armas são lidos quando o jogo abre, então ligar o resource com o servidor já rodando não basta.

  4. 4

    Registre os itens

    Com um inventário (ox_inventory, QBCore, ESX), a arma é um item e o inventário tira qualquer arma que ele não conhece. O README traz o bloco do item pronto para colar, um para cada arma. Copie os PNGs de images/ para a pasta de imagens do seu inventário.

  5. 5

    Teste

    Como admin, abra o console F8 e use os comandos abaixo.

ComandoO que faz
/orbweaponsLista as armas e acessórios do pack.
/orbweapon <name>Dá a arma para você, pelo inventário se houver um.
/orbattachall <name>Coloca todos os acessórios.
/orbattach <name> <attachment>Coloca um. /orbattachoff tira.
/orbdiag <name>Se a arma não aparece, mostra onde está o problema.
/orbaimAjusta a mira em primeira pessoa. Enter salva em data/weapons.meta e reinicia o resource.

Os comandos de teste só funcionam para jogadores com a permissão ACE command (seus admins) e podem ser desligados no config.lua. Com um servidor conectado pelo ORB Core, Enviar ao servidor instala o pack em resources/[orb]/[weapons]/ e liga ele; se a arma não aparecer, reinicie o servidor e reconecte.

Problemas comuns

A arma não aparece na mão.

Rode /orbdiag <name>. Na maioria das vezes o servidor não foi reiniciado, ou outro resource já usa o mesmo nome WEAPON_ (o jogo fica com o primeiro).

O inventário tira a arma.

O item não está registrado. Cole o bloco do item do README no arquivo de itens do seu inventário e reinicie.

O clarão do tiro sai pela coronha.

O modelo veio virado para trás ou o gun_muzzle está no lugar errado. Em Bones, arraste o gun_muzzle até a ponta do cano e use Tiro para conferir.

A arma fica torta na mão.

Use Mover e Girar acima do visualizador, em Tipo e tamanho ou em Bones. A mão direita é fixa; a arma se move em volta dela.

Diz que a arma está pesada demais.

O limite para enviar uma arma é 48 MB. As armas de IA vêm com densidade máxima; gere de novo ou comece de um modelo mais leve. O build reduz a malha e as texturas até o que o jogo aceita.

As armas ficaram instáveis depois de adicionar muitas.

Os clientes do FiveM ficam instáveis acima de mais ou menos 115 modelos de arma add-on num servidor. Cada arma e cada acessório contam.

Perguntas frequentes

Ela substitui uma arma do GTA V?

Não. É um add-on: uma arma nova com nome WEAPON_ próprio, ao lado das armas do jogo.

Funciona com o meu inventário?

Sim. O README traz blocos prontos para ox_inventory (Qbox, ox_core), QBCore e ESX, e os comandos de teste dão a arma pelo seu inventário.

Posso colocar várias armas em um resource?

Sim. Construa cada uma no mesmo pack e baixe todas juntas com Baixar todas as N.

Preciso de Blender ou CodeWalker?

Não. O modelo e o esqueleto são construídos no nosso servidor, e os arquivos meta são escritos para você.

Os jogadores podem usar os comandos de teste?

Só jogadores com a permissão ACE command, que normalmente são os admins. Você pode desligá-los no config.lua.

Conferido com a ferramenta em 15 de novembro de 2026.

Experimente o Criador de armas agora

Solte o seu modelo, coloque os ossos no lugar certo e receba uma arma add-on de FiveM: o .ydr com o esqueleto, as metas e o resource.

Mais guias de Props e modelos