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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Modo de disparo
Como <tipo>, Una por clic o Automático.
- 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
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
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
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
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
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
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
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
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:
<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
Suelta la carpeta
Pon la carpeta del pack en
resources/de tu servidor. - 2
Agrégala
Agrega
ensure <pack>aserver.cfg. - 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
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
Pruébala
Como admin, abre la consola F8 y usa los comandos de abajo.
| Comando | Qué hace |
|---|---|
/orbweapons | Lista 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. |
/orbaim | Ajusta 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
- Modelo 3D → FiveMEntra un modelo 3D, sale un prop de FiveM: con texturas y colisión.
- Creador de propsDescribe un prop, o suelta una foto, y te lo fabricamos.
- Prop LibraryObjetos 3D listos para convertir en props de FiveM.
- Vinewood Sign CreatorEl nombre de tu ciudad en la colina de Vinewood.
- Billboard CreatorTus anuncios en carteles, paredes y vidrieras.
- VFX CreatorEfectos de partículas propios para tu servidor.
- Vehicle CreatorArmá un auto único, spawnealo con /car.
- Asset OptimizerEl mismo resource, más liviano: texturas que cargan.
- Livery CreatorDiseñá la livery en el auto y llevate un resource.
