THE ORB
Arrancando el studio

Creador de armas: guía y tutorial

Entra tu modelo, sale un arma add-on.

El videotutorial llega pronto

Mientras tanto, la guía escrita de abajo te lleva por cada paso.

Qué es

El Weapon Creator convierte un modelo 3D en un arma add-on para FiveM: un arma nueva que convive con las del juego, con su propio nombre, sus números y sus accesorios. Empiezas desde un arma del juego, tu propio .glb o una generada con IA. Después recorres ocho pasos: eliges su tipo y su tamaño, armas sus accesorios, colocas los puntos que lee el juego (por dónde sale el disparo, por dónde salen los casquillos, dónde va la mano izquierda), la pintas, pones sus números, alineas la mira en primera persona y la construyes. Recibes un resource con el modelo y su esqueleto, los archivos meta que necesita el juego y comandos de prueba. Funciona en servidores standalone y con ox_inventory, QBCore y ESX.

Para quién es

  • Dueños de servidor que quieren un arma propia para una banda, un trabajo o un evento sin un artista 3D ni un programador.
  • Dueños que tienen un modelo de arma y no saben cómo darle un esqueleto y sus archivos meta.
  • Quien quiere una versión de un arma de GTA V con otra pintura u otros números, con su propio nombre.

Antes de empezar

  • Una cuenta de THE ORB. Para construir tienes que iniciar sesión.
  • Una de estas: un arma del juego de la lista, tu propio modelo en .glb o .gltf con el cañón hacia adelante (hasta 48 MB), o créditos para generar una con IA.
  • Acceso a los archivos de tu servidor y a server.cfg, y un reinicio del servidor al final.

Paso 1: Modelo

La barra de la izquierda muestra los ocho pasos en orden. Siguiente te lleva adelante, y puedes volver a cualquier paso que ya hiciste. Ver el recorrido, arriba, te los muestra la primera vez.

  1. 1

    Empieza desde un arma del juego

    En Armas del juego, busca en la lista y haz clic en una. Se carga con sus propios huesos y sus puntos de accesorio, donde los pone el juego. Le pones nombre al final y pasa a ser tu propia arma.

  2. 2

    O usa tu propio modelo

    En Usa tu propio modelo, suelta un .glb o .gltf, o haz clic en Elegir. El cañón tiene que apuntar hacia adelante. La herramienta mide su largo y sugiere un tipo (pistola, fusil, etc.) a partir de eso. Si el modelo llegó demasiado grande o demasiado chico, se reescala y te avisa.

  3. 3

    O genera una con IA

    En Generar con IA, elige Texto y describe el arma, por ejemplo un subfusil compacto con culata plegable, o elige Imagen y suelta una foto o un dibujo. Elige un Tipo, o Detectar en la imagen. Aprieta Generar. Tarda alrededor de un minuto y puedes seguir navegando: queda en Tareas.

  4. 4

    Vuelve a abrir lo que hiciste

    Tuyas muestra las armas que generaste antes. Haz clic en una para abrirla sin pagar de nuevo.

Tu texto se revisa antes de gastar nada: tiene que describir un arma. Si el generador lo rechaza o falla, no se te cobra. Si lo que salió no es un arma, Mover al Prop Creator la manda ahí.

Paso 2: Tipo y tamaño

El tipo decide cómo la sostiene el personaje, sus animaciones, su sonido y sus números de entrada. Un fusil no se sostiene como una pistola.

  1. 1

    Elige el tipo

    En Tipo: Pistola, Subfusil, Fusil de asalto, Escopeta, Francotirador, Ametralladora, Pesada, Arrojadiza, Cuerpo a cuerpo u Otra. Si el largo del modelo corresponde a otro tipo, una nota te ofrece Usar <tipo>.

  2. 2

    Ajusta el tamaño

    En Tamaño, pon su largo en centímetros. La herramienta te muestra el tamaño de armas parecidas del juego para que coincida. Volver al tamaño con el que vino el archivo lo deshace.

  3. 3

    Ponla derecha

    En Parada, usa Cuartos de vuelta o escribe los grados exactos si vino girada. También puedes usar Girar sobre el visor: arrastra los anillos.

  4. 4

    Acomódala en la mano

    Usa Mover sobre el visor para correr el arma en la mano del personaje; los accesorios la acompañan. Comparar pone al lado un arma de GTA V del mismo tipo, a tamaño real, para que veas si se ve bien.

Paso 3: Accesorios

Los accesorios son componentes de arma reales de GTA: aparecen en la rueda de armas, se ponen y se quitan como cualquier accesorio del juego, y los demás jugadores los ven. Hay cinco lugares: Cargador, Mira, Silenciador, Linterna y Empuñadura. Las armas cuerpo a cuerpo no llevan.

  1. 1

    Ordena las piezas del modelo

    Si tu modelo tiene piezas sueltas, aparecen en Piezas del modelo. Para cada una, di qué es: Parte del arma, uno de los lugares de accesorio, Munición (lo que dispara) o Tirarla.

  2. 2

    Elige qué va en cada lugar

    Para cada lugar elige Sin montar, Sólo el hueso (declara el punto pero sin modelo), uno de los componentes del juego para ese lugar, o uno tuyo (una pieza sacada de tu modelo o generada con el arma).

  3. 3

    Ajusta tamaño e inclinación

    Haz clic en un lugar para elegirlo. Si tiene un modelo propio, se abren Tamaño e Inclinación. Sólo se mueve esa pieza; el arma queda donde está. Doble clic en el tamaño lo reinicia.

  4. 4

    Ordénalo

    Mostrar todas y Ocultar todas prenden y apagan todos los accesorios en el visor. Alinear piezas borra la inclinación propia de cada pieza. Reiniciar todo devuelve cada accesorio a su lugar medido.

Si empiezas desde un arma del juego, la herramienta te avisa cuando esa arma no lleva cierto accesorio en el juego. Igual puedes agregarlo; revisa dónde queda en el visor.

Paso 4: Huesos

Los huesos son puntos invisibles dentro del modelo que el juego lee. Viajan dentro del archivo del modelo, por eso se colocan acá y no en un archivo de texto después. Arrancan en un lugar medido para cada tipo; este paso es para afinarlos.

  1. 1

    Lee qué es cada punto

    Toca un punto sobre el arma. El panel te dice qué hace: gun_muzzle es por donde salen el fogonazo y las balas, gun_vfx_eject es por donde salen los casquillos, Mano izquierda es donde agarra la otra mano, y los puntos WAP son donde se montan los accesorios.

  2. 2

    Arrástralo a su lugar

    Arrastra el punto sobre el arma. Mantén Shift para llevarlo adelante o atrás. Ctrl+Z deshace y Ctrl+Shift+Z rehace; las flechas al lado del visor hacen lo mismo.

  3. 3

    Prueba la boca del cañón

    Haz clic en Disparo para disparar una vez en el visor. El fogonazo sale de gun_muzzle, igual que en el juego.

La mano derecha no se mueve: es la empuñadura. Si el arma queda corrida o torcida en la mano, usa Mover y Girar sobre el visor, que mueven el arma entera con sus puntos.

Paso 5: Aspecto

  1. 1

    Pinturas de fábrica

    En un arma del juego, Pinturas de fábrica muestra los tintes que tiene en el juego. Haz clic en uno para usarlo.

  2. 2

    Pinta cada parte

    En Pintura aparece cada material del modelo. Dale a cada uno un color de la paleta, Cualquier otro color o Usar una imagen. Volver a la textura propia del modelo lo deshace. Color de los accesorios pinta los accesorios.

  3. 3

    Skin de vídeo (opcional)

    Pega el enlace a un archivo de video (tiene que empezar con http:// o https://). En el juego se reproduce sobre el arma mientras corre el resource; no va dentro del modelo y no le suma peso. Funciona mejor un clip en bucle que llene el cuadro.

  4. 4

    Partículas (opcional)

    Elige un efecto de partículas de GTA para que se vea sobre el arma mientras está en la mano, o Propio con cualquier nombre de efecto o tu propio archivo .ypt. Ajusta Color, Tamaño, Opacidad, de dónde sale y si se repite.

  5. 5

    Parte animada (opcional)

    Suma un GIF o un video (.gif, .mp4 o .webm), haz clic sobre el arma para ubicarlo y ajusta su tamaño y su giro. Queda dentro de la textura del arma y se reproduce solo en el juego. Para construirla hace falta Chrome o Edge.

Todo menos el skin de vídeo va dentro del modelo, así que lo que ves en el visor es lo que sale.

Paso 6: Números

  1. 1

    Pon los números

    Daño, Cargador, Cadencia, Alcance, Velocidad de recarga y Retroceso. Cada uno arranca en un valor razonable para el tipo. En las armas cuerpo a cuerpo, Daño multiplica el golpe del juego (x1 es como el original).

  2. 2

    Modo de disparo

    Como <tipo>, Una por clic o Automático.

  3. 3

    Qué dispara

    Balas de entrada. También puedes elegir granadas, cohetes, cohetes teledirigidos, bengalas, fuegos artificiales, EMP, munición incendiaria o explosiva, un rayo láser, un táser y más. Las armas cuerpo a cuerpo eligen un estilo: cuchillo, machete, porra, hacha, bate o puño americano.

  4. 4

    Sonido del disparo

    Elige a qué arma suena. Ajustes del disparo tiene opciones extra para la munición elegida.

Paso 7: Puntería

Este paso sólo cambia la primera persona: dónde queda el arma delante de la cámara al apuntar con la mira. No cambia cómo se sostiene el arma.

  1. 1

    Alinea la mira

    Mueve Arriba / abajo, Adelante / atrás, Izquierda / derecha y Giro hasta que la mira quede alineada con el punto del centro. Cero es el lugar propio del juego.

  2. 2

    Revisa en el juego

    Construye una vez, entra al juego y apunta con /orbaim (viene en el resource). Copia los cuatro valores que imprime en este paso para que la próxima construcción los lleve.

Paso 8: Construir

  1. 1

    Ponle nombre

    Escribe un nombre. Es el nombre del arma en el juego, WEAPON_<NOMBRE>, el que das a los jugadores y registras en tu inventario.

  2. 2

    Revisa el resumen

    Resumen muestra el tipo, cuántos accesorios tienen modelo, cuántas partes están pintadas y Qué sale en el zip. Si nunca moviste los huesos, si un accesorio quedó vacío o si un hueso quedó afuera del arma, un aviso te lo dice; igual puedes construir.

  3. 3

    Elige el pack

    En Pack, elige a qué pack va la construcción, o Pack nuevo para empezar uno. Un pack es un resource con varias armas, y su nombre es el nombre de la carpeta.

  4. 4

    Construye

    Haz clic en Construir arma. La pintura se integra, el modelo se sube y nuestro servidor escribe los archivos del juego. Cuando termina, el arma queda en el pack.

  5. 5

    Descarga o manda

    Haz clic en Descargar el arma, o Descargar las N en un pack. Con un servidor vinculado, Mandar al server la instala ahí en lugar de descargarla.

Tu trabajo se guarda en tu cuenta sobre la marcha. Proyectos, arriba, muestra cada arma con nombre para que la vuelvas a abrir. Compartir en la galería publica el arma entera para que otros remezclen una copia.

Qué descargas

Recibes un .zip con el nombre del pack. Adentro:

Qué trae el zip
<pack>/
  fxmanifest.lua
  config.lua                      comandos de prueba y permisos
  data/weapons.meta               daño, cadencia, cargador, alcance, puntos de enganche
  data/weaponcomponents.meta      los accesorios (si tiene)
  data/weaponanimations.meta      cómo se sostiene, se dispara y se recarga
  data/weaponarchetypes.meta      una entrada por modelo
  data/pedpersonality.meta        cómo se saca de la funda
  client/names.lua                nombres en la rueda de armas
  client/commands.lua             comandos de prueba
  client/aim.lua                  /orbaim
  server/commands.lua             entrega el arma de los comandos de prueba
  server/aim.lua                  guarda los resultados de /orbaim
  images/                         íconos para el inventario (PNG transparente)
  stream/                         los modelos (.ydr) y las texturas (.ytd)
  README.md / LEEME.md / LEIAME.md

Según lo que usaste, también trae client/laser.lua (mira láser), client/video.lua y html/video.html (skin de vídeo), client/particles.lua (partículas) y html/*_anim.webm (parte animada).

Solo los archivos meta, al lado del contador de construcciones, baja sólo los archivos meta, para quien quiere editarlos a mano.

Créditos: las armas del juego, tu propio .glb y construir no usan créditos de IA. Generar un arma con IA cuesta 40 créditos, y sólo se cobra si sale. En el plan Free cada construcción cuenta como una conversión y usa créditos; los planes pagos construyen sin límite diario. Mira los precios.

Instalarlo en tu servidor

  1. 1

    Suelta la carpeta

    Pon la carpeta del pack en resources/ de tu servidor.

  2. 2

    Agrégala

    Agrega ensure <pack> a server.cfg.

  3. 3

    Reinicia y vuelve a conectarte

    Reinicia el servidor y vuelve a entrar. Los datos de las armas se leen cuando arranca el juego, así que arrancar el resource con el servidor en marcha no alcanza.

  4. 4

    Registra los ítems

    Con un inventario (ox_inventory, QBCore, ESX), el arma es un ítem y el inventario quita cualquier arma que no conoce. El README trae el bloque del ítem listo para pegar en cada uno. Copia los PNG de images/ a la carpeta de imágenes de tu inventario.

  5. 5

    Pruébala

    Como admin, abre la consola F8 y usa los comandos de abajo.

ComandoQué hace
/orbweaponsLista las armas y los accesorios del pack.
/orbweapon <nombre>Te da el arma, a través de tu inventario si hay uno.
/orbattachall <nombre>Pone todos los accesorios.
/orbattach <nombre> <accesorio>Pone uno. /orbattachoff lo quita.
/orbdiag <nombre>Si el arma no aparece, te dice dónde falla.
/orbaimAjusta la mira en primera persona. Enter lo guarda en data/weapons.meta y reinicia el resource.

Los comandos de prueba sólo funcionan para jugadores con el permiso ACE command (tus admins) y se pueden apagar en config.lua. Con un servidor vinculado por ORB Core, Mandar al server instala el pack en resources/[orb]/[weapons]/ y lo arranca; si el arma no aparece, reinicia el servidor y vuelve a conectarte.

Problemas comunes

El arma no aparece en la mano.

Ejecuta /orbdiag <nombre>. Casi siempre el servidor no se reinició, u otro resource ya usa el mismo nombre WEAPON_ (el juego se queda con el primero).

El inventario me quita el arma.

El ítem no está registrado. Pega el bloque del ítem del README en el archivo de ítems de tu inventario y reinicia.

El fogonazo sale por la culata.

El modelo vino mirando al revés o gun_muzzle está mal puesto. En Huesos, arrastra gun_muzzle a la punta del cañón y revísalo con Disparo.

El arma queda torcida en la mano.

Usa Mover y Girar sobre el visor, en Tipo y tamaño o en Huesos. La mano derecha está fija; el arma se mueve alrededor de ella.

Dice que el arma es demasiado pesada.

El límite para mandar un arma es 48 MB. Las armas hechas con IA llegan con mucho detalle; genérala de nuevo o empieza desde un modelo más liviano. La construcción baja la malla y las texturas a lo que acepta el juego.

Las armas se volvieron inestables después de agregar muchas.

Los clientes de FiveM se vuelven inestables con más de unos 115 modelos de armas add-on en un servidor. Cada arma y cada accesorio cuentan.

Preguntas frecuentes

¿Reemplaza un arma de GTA V?

No. Es un add-on: un arma nueva con su propio nombre WEAPON_, al lado de las del juego.

¿Funciona con mi inventario?

Sí. El README trae bloques listos para ox_inventory (Qbox, ox_core), QBCore y ESX, y los comandos de prueba entregan el arma a través de tu inventario.

¿Puedo poner varias armas en un solo resource?

Sí. Construye cada una en el mismo pack y bájalas juntas con Descargar las N.

¿Necesito Blender o CodeWalker?

No. El modelo y su esqueleto se arman en nuestro servidor, y los archivos meta se escriben solos.

¿Los jugadores pueden usar los comandos de prueba?

Sólo los que tienen el permiso ACE command, que normalmente son los admins. Puedes apagarlos en config.lua.

Revisada contra la herramienta el 15 de noviembre de 2026.

Prueba Creador de armas ahora

Suelta tu modelo, coloca sus huesos donde corresponde y recibe un arma add-on de FiveM: el .ydr con su esqueleto, las metas y el recurso.

Más guías de Props y modelos