THE ORB
Studio wird gestartet

Weapon Creator: Anleitung und Tutorial

Dein Modell rein, eine Add-on-Waffe raus.

Das Video-Tutorial folgt bald

Bis dahin führt dich die Anleitung unten durch jeden Schritt.

Was es ist

Der Weapon Creator macht aus einem 3D-Modell eine Add-on-Waffe für FiveM: eine neue Waffe neben denen des Spiels, mit eigenem Namen, eigenen Werten und eigenen Aufsätzen. Du startest mit einer Waffe aus dem Spiel, deinem eigenen .glb oder einer, die die KI erzeugt. Dann gehst du acht Schritte durch: Art und Größe wählen, Aufsätze einrichten, die Punkte setzen, die das Spiel liest (wo der Schuss rauskommt, wo die Hülsen fliegen, wo die linke Hand greift), lackieren, Werte einstellen, die Visierung in der Ego-Perspektive ausrichten und bauen. Am Ende hast du eine Resource mit dem Modell samt Skelett, den Meta-Dateien, die das Spiel braucht, und Testbefehlen. Läuft auf Standalone-Servern und mit ox_inventory, QBCore und ESX.

Für wen

  • Serverbesitzer, die eine eigene Waffe für eine Gang, einen Job oder ein Event wollen, ohne 3D-Artist oder Entwickler.
  • Besitzer, die ein Waffenmodell haben, aber nicht wissen, wie es ein Skelett und Meta-Dateien bekommt.
  • Alle, die eine GTA-V-Waffe mit neuem Look oder neuen Werten unter eigenem Namen wollen.

Bevor du anfängst

  • Ein THE ORB Konto. Zum Bauen musst du angemeldet sein.
  • Eins davon: eine Waffe aus der Liste des Spiels, dein eigenes Modell als .glb oder .gltf mit dem Lauf nach vorne (bis 48 MB) oder Credits, um eine mit KI zu erzeugen.
  • Zugriff auf die Dateien deines Servers und die server.cfg und am Ende ein Server-Neustart.

Schritt 1: Modell

Die linke Leiste zeigt die acht Schritte der Reihe nach. Weiter bringt dich vorwärts, und zu jedem Schritt, den du schon gemacht hast, kannst du zurück. Rundgang ansehen, oben, führt dich beim ersten Mal durch.

  1. 1

    Mit einer Waffe aus dem Spiel starten

    Unter Waffen aus dem Spiel suchst du in der Liste und klickst eine an. Sie lädt mit ihren eigenen Bones und Anbaupunkten, genau dort, wo das Spiel sie hat. Später gibst du ihr einen Namen, und sie wird deine eigene Waffe.

  2. 2

    Oder dein eigenes Modell nehmen

    Unter Nimm dein eigenes Modell ziehst du ein .glb oder .gltf rein oder klickst Auswählen. Der Lauf muss nach vorne zeigen. Das Tool misst die Länge und schlägt daraus eine Art vor (Pistole, Gewehr usw.). Kam das Modell viel zu groß oder zu klein, wird es skaliert und du bekommst Bescheid.

  3. 3

    Oder eine mit KI erzeugen

    Unter Mit KI erzeugen wählst du Text und beschreibst die Waffe, zum Beispiel eine kompakte MP mit Klappschaft, oder du wählst Bild und ziehst ein Foto oder Concept Art rein. Wähl einen Typ oder Aus dem Bild erkennen. Drück Erzeugen. Das dauert etwa eine Minute und du kannst weiterarbeiten: Es bleibt unter Aufgaben.

  4. 4

    Wieder öffnen, was du gemacht hast

    Unter Deine stehen die Waffen, die du schon erzeugt hast. Klick eine an, um sie zu öffnen, ohne nochmal zu zahlen.

Dein Text wird geprüft, bevor etwas ausgegeben wird: Er muss eine Waffe beschreiben. Lehnt der Generator ab oder schlägt fehl, zahlst du nichts. Ist das Ergebnis keine Waffe, schickt Zum Prop-Creator verschieben es dorthin.

Schritt 2: Typ & Größe

Die Art bestimmt, wie der Charakter sie hält, ihre Animationen, ihren Sound und ihre Standardwerte. Ein Gewehr hält man nicht wie eine Pistole.

  1. 1

    Die Art wählen

    Unter Art: Pistole, MP, Sturmgewehr, Schrotflinte, Scharfschützengewehr, Maschinengewehr, Schwere Waffe, Wurfwaffe, Nahkampf oder Sonstige. Passt die Länge des Modells zu einer anderen Art, bietet dir ein Hinweis Use <kind> an.

  2. 2

    Die Größe einstellen

    Unter Größe stellst du die Länge in Zentimetern ein. Das Tool zeigt die Größe ähnlicher Waffen aus dem Spiel, damit du sie angleichen kannst. Zurück zur Größe, mit der die Datei kam macht es rückgängig.

  3. 3

    Aufrecht stellen

    Kam sie verdreht rein, nimm unter Stehend die Vierteldrehungen oder tipp die genauen Grad ein. Du kannst auch Drehen über dem Viewer nehmen: Zieh an den Ringen.

  4. 4

    In die Hand setzen

    Mit Bewegen über dem Viewer schiebst du die Waffe in der Hand des Charakters; die Aufsätze wandern mit. Vergleichen stellt eine GTA-V-Waffe derselben Art in echter Größe neben deine, damit du siehst, ob es passt.

Schritt 3: Aufsätze

Aufsätze sind echte GTA-Waffenkomponenten: Sie erscheinen im Waffenrad, lassen sich an- und abbauen wie jeder Aufsatz im Spiel, und andere Spieler sehen sie. Es gibt fünf Slots: Magazin, Zielfernrohr, Schalldämpfer, Taschenlampe und Griff. Nahkampfwaffen nehmen keine.

  1. 1

    Die Teile des Modells sortieren

    Hat dein Modell lose Teile, stehen sie unter Teile des Modells. Sag für jedes, was es ist: Teil der Waffe, einer der Aufsatz-Slots, Munition (was sie verschießt) oder Wegwerfen.

  2. 2

    Wählen, was in jeden Slot kommt

    Für jeden Slot wählst du Nicht montiert, Nur der Knochen (setzt den Punkt, aber ohne Modell), eine der Komponenten des Spiels für diesen Slot oder eine eigene (ein Teil aus deinem Modell oder mit der Waffe erzeugt).

  3. 3

    Größe und Neigung anpassen

    Klick einen Slot an, um ihn auszuwählen. Hat er ein eigenes Modell, gehen Größe und Neigung auf. Nur dieses Teil bewegt sich; die Waffe bleibt, wo sie ist. Doppelklick auf die Größe setzt sie zurück.

  4. 4

    Aufräumen

    Alle zeigen und Alle ausblenden schalten alle Aufsätze im Viewer um. Teile ausrichten entfernt die eigene Neigung jedes Teils. Alles zurücksetzen setzt jeden Aufsatz wieder auf seinen gemessenen Platz.

Startest du mit einer Waffe aus dem Spiel, sagt dir das Tool, wenn diese Waffe einen Aufsatz im Spiel nicht annimmt. Du kannst ihn trotzdem hinzufügen; schau im Viewer, wo er sitzt.

Schritt 4: Bones

Bones sind unsichtbare Punkte im Modell, die das Spiel liest. Sie stecken in der Modelldatei, deshalb setzt du sie hier und nicht später in einer Textdatei. Sie starten an einem gemessenen Standardplatz für die Art; dieser Schritt ist zum Feintuning.

  1. 1

    Lesen, was jeder Punkt ist

    Tipp auf einen Punkt der Waffe. Das Panel sagt dir, was er macht: gun_muzzle ist, wo Mündungsfeuer und Kugeln rauskommen, gun_vfx_eject ist, wo die Hülsen fliegen, Linke Hand ist, wo die andere Hand greift, und die WAP-Punkte sind, wo Aufsätze montiert werden.

  2. 2

    An die richtige Stelle ziehen

    Zieh den Punkt auf die Waffe. Halt Shift gedrückt, um ihn nach vorne oder hinten zu schieben. Ctrl+Z macht rückgängig, Ctrl+Shift+Z stellt wieder her; die Pfeile neben dem Viewer tun dasselbe.

  3. 3

    Die Mündung testen

    Klick Schuss, um im Viewer einmal zu schießen. Das Mündungsfeuer kommt aus gun_muzzle, wie im Spiel.

Die rechte Hand bewegt sich nicht: Sie ist der Griff. Sitzt die Waffe verschoben oder schief in der Hand, nimm Bewegen und Drehen über dem Viewer; die bewegen die ganze Waffe mit ihren Punkten.

Schritt 5: Optik

  1. 1

    Werks-Skins

    Bei einer Waffe aus dem Spiel zeigt Werks-Skins die Tints, die sie im Spiel hat. Klick einen an, um ihn zu nutzen.

  2. 2

    Jedes Teil lackieren

    Unter Lackierung steht jedes Material des Modells. Gib jedem eine Farbe aus den Feldern, Jede andere Farbe oder Ein Bild verwenden. Back to the model's own texture macht es rückgängig. Farbe der Aufsätze lackiert die Aufsätze.

  3. 3

    Video-Skin (optional)

    Füg einen Link zu einer Videodatei ein (er muss mit http:// oder https:// anfangen). Im Spiel läuft es auf der Waffe, solange die Resource läuft; es steckt nicht im Modell und macht es nicht größer. Am besten wirkt ein Loop, der das ganze Bild füllt.

  4. 4

    Partikel (optional)

    Wähl einen GTA-Partikeleffekt, der auf der Waffe läuft, während sie in der Hand ist, oder Eigener mit einem beliebigen Effektnamen oder deiner eigenen .ypt-Datei. Stell Farbe, Größe, Deckkraft ein, wo er rauskommt und ob er im Loop läuft.

  5. 5

    Animierter Teil (optional)

    Füg ein GIF oder Video hinzu (.gif, .mp4 oder .webm), klick auf die Waffe, um es zu platzieren, und stell Größe und Drehung ein. Es wird in die Textur der Waffe eingebacken und läuft im Spiel von selbst. Zum Bauen brauchst du Chrome oder Edge.

Alles außer dem Video-Skin landet im Modell selbst. Was du im Viewer siehst, ist also das, was rausgeht.

Schritt 6: Werte

  1. 1

    Die Werte einstellen

    Schaden, Magazin, Kadenz, Reichweite, Nachladetempo und Rückstoß. Jeder startet mit einem sinnvollen Wert für die Art. Bei Nahkampf multipliziert Schaden den Treffer des Spiels (x1 ist wie das Original).

  2. 2

    Feuermodus

    Like <kind>, Einer pro Klick oder Vollautomatik.

  3. 3

    Was sie verschießt

    Standardmäßig Kugeln. Du kannst auch Granaten, Raketen, Lenkraketen, Leuchtfackeln, Feuerwerk, EMP, Brand- oder Sprengmunition, einen Laserstrahl, einen Taser und mehr wählen. Nahkampfwaffen wählen stattdessen einen Stil: Messer, Machete, Schlagstock, Axt, Schläger oder Schlagring.

  4. 4

    Schussgeräusch

    Wähl, nach welcher Waffe sie klingt. Schusseinstellungen hat Extra-Optionen für die gewählte Munition.

Schritt 7: Zielen

Dieser Schritt betrifft nur die Ego-Perspektive: wo die Waffe vor der Kamera sitzt, wenn du über Kimme und Korn zielst. Wie die Waffe gehalten wird, ändert er nicht.

  1. 1

    Die Visierung ausrichten

    Verschieb Hoch / runter, Vor / zurück, Links / rechts und Drehung, bis die Visierung mit dem Punkt in der Mitte übereinstimmt. Null ist die Stelle des Spiels.

  2. 2

    Im Spiel prüfen

    Bau einmal, geh ins Spiel und ziel mit /orbaim (kommt mit der Resource). Kopier die vier Werte, die es ausgibt, zurück in diesen Schritt, damit der nächste Build sie mitnimmt.

Schritt 8: Bauen

  1. 1

    Einen Namen geben

    Tipp einen Namen ein. Er wird zum Spielnamen der Waffe, WEAPON_<NAME>: Den gibst du Spielern und den trägst du in dein Inventar ein.

  2. 2

    Die Zusammenfassung prüfen

    Zusammenfassung zeigt die Art, wie viele Aufsätze ein Modell haben, wie viele Teile lackiert sind und Was im Zip steckt. Hast du die Bones nie bewegt, ist ein Aufsatz leer oder liegt ein Bone außerhalb der Waffe, warnt dich ein Hinweis; bauen kannst du trotzdem.

  3. 3

    Das Pack wählen

    Unter Paket wählst du, in welches Pack der Build kommt, oder Neues Pack…, um eins anzufangen. Ein Pack ist eine Resource mit mehreren Waffen, und sein Name ist der Ordnername.

  4. 4

    Bauen

    Klick Waffe bauen. Die Lackierung wird eingebacken, das Modell hochgeladen und unser Server schreibt die Spieldateien. Wenn er fertig ist, landet die Waffe im Pack.

  5. 5

    Herunterladen oder senden

    Klick Waffe herunterladen oder bei einem Pack Alle N herunterladen. Mit verbundenem Server installiert An Server senden sie stattdessen direkt dort.

Deine Arbeit wird laufend in deinem Konto gespeichert. Projekte, oben, listet jede Waffe mit Namen, damit du sie später wieder öffnen kannst. In der Galerie teilen veröffentlicht die ganze Waffe, damit andere eine Kopie remixen können.

Was du herunterlädst

Du bekommst ein .zip mit dem Namen des Packs. Drin ist:

Was im Zip steckt
<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

Je nachdem, was du genutzt hast, kommen noch client/laser.lua (Laservisier), client/video.lua und html/video.html (Video-Skin), client/particles.lua (Partikel) und html/*_anim.webm (animierter Teil) dazu.

Nur die Meta-Dateien, neben dem Build-Zähler, lädt nur die Meta-Dateien herunter, für Besitzer, die sie von Hand bearbeiten wollen.

Credits: Waffen aus dem Spiel, dein eigenes .glb und das Bauen kosten keine KI-Credits. Eine Waffe mit KI erzeugen kostet 40 Credits, abgebucht nur, wenn sie rauskommt. Im Free-Plan zählt jeder Build als Konvertierung und verbraucht Credits; bezahlte Pläne bauen ohne Tageslimit. Siehe Preise.

Auf deinem Server installieren

  1. 1

    Den Ordner ablegen

    Leg den Pack-Ordner in resources/ deines Servers.

  2. 2

    Ensure eintragen

    Füg ensure <pack> in die server.cfg ein.

  3. 3

    Neu starten und neu verbinden

    Starte den Server neu und verbinde dich neu. Waffendaten werden beim Spielstart gelesen; die Resource auf einem laufenden Server zu starten reicht also nicht.

  4. 4

    Die Items eintragen

    Mit einem Inventar (ox_inventory, QBCore, ESX) ist die Waffe ein Item, und das Inventar entfernt jede Waffe, die es nicht kennt. Im README steht für jedes der fertige Item-Block zum Einfügen. Kopier die PNGs aus images/ in den Bilderordner deines Inventars.

  5. 5

    Testen

    Öffne als Admin die F8-Konsole und nutz die Befehle unten.

BefehlWas er macht
/orbweaponsListet die Waffen und Aufsätze im Pack.
/orbweapon <name>Gibt dir die Waffe, über dein Inventar, falls du eins hast.
/orbattachall <name>Baut alle Aufsätze an.
/orbattach <name> <attachment>Baut einen an. /orbattachoff nimmt ihn wieder ab.
/orbdiag <name>Wenn die Waffe nicht auftaucht, sagt es dir, wo es hakt.
/orbaimStellt das Zielen in der Ego-Perspektive ein. Enter speichert es in data/weapons.meta und startet die Resource neu.

Die Testbefehle gehen nur für Spieler mit der ACE-Berechtigung command (deine Admins) und lassen sich in config.lua abschalten. Mit einem über ORB Core verbundenen Server installiert An Server senden das Pack in resources/[orb]/[weapons]/ und startet es; taucht die Waffe nicht auf, starte den Server neu und verbinde dich neu.

Häufige Probleme

Die Waffe erscheint nicht in der Hand.

Führ /orbdiag <name> aus. Meistens wurde der Server nicht neu gestartet, oder eine andere Resource nutzt schon denselben WEAPON_-Namen (das Spiel behält den ersten).

Das Inventar nimmt mir die Waffe weg.

Das Item ist nicht eingetragen. Füg den Item-Block aus dem README in die Item-Datei deines Inventars ein und starte neu.

Das Mündungsfeuer kommt aus dem Schaft.

Das Modell kam verkehrt herum rein oder gun_muzzle sitzt falsch. Zieh in Bones gun_muzzle ans Ende des Laufs und prüf es mit Schuss.

Die Waffe sitzt schief in der Hand.

Nimm Bewegen und Drehen über dem Viewer, in Typ & Größe oder Bones. Die rechte Hand ist fest; die Waffe bewegt sich um sie herum.

Es heißt, die Waffe sei zu schwer.

Das Limit zum Senden einer Waffe liegt bei 48 MB. KI-Waffen kommen in voller Dichte; erzeug sie neu oder starte mit einem leichteren Modell. Der Build bringt Mesh und Texturen auf das, was das Spiel annimmt.

Nach vielen Waffen wurde es instabil.

FiveM-Clients werden ab etwa 115 Add-on-Waffenmodellen auf einem Server instabil. Jede Waffe und jeder Aufsatz zählt mit.

Häufige Fragen

Ersetzt sie eine GTA-V-Waffe?

Nein. Sie ist ein Add-on: eine neue Waffe mit eigenem WEAPON_-Namen, neben denen des Spiels.

Geht das mit meinem Inventar?

Ja. Im README stehen fertige Blöcke für ox_inventory (Qbox, ox_core), QBCore und ESX, und die Testbefehle geben die Waffe über dein Inventar.

Kann ich mehrere Waffen in eine Resource packen?

Ja. Bau jede ins selbe Pack und hol sie dir zusammen mit Alle N herunterladen.

Brauche ich Blender oder CodeWalker?

Nein. Modell und Skelett werden auf unserem Server gebaut, und die Meta-Dateien werden für dich geschrieben.

Können Spieler die Testbefehle nutzen?

Nur Spieler mit der ACE-Berechtigung command, also normalerweise Admins. Du kannst sie in config.lua abschalten.

Am 15. November 2026 mit dem Tool abgeglichen.

Probier Weapon Creator jetzt aus

Zieh dein Modell rein, setz die Knochen dahin, wo sie hingehören, und bekomm eine FiveM-Add-on-Waffe: die .ydr mit ihrem Skelett, die Metas und die Resource.

Weitere Anleitungen: Props & Modelle