Skip to content
SwisserAI LogoSwisserAI
Weapon Studio HelpSwisserAI HelpOpen app

Start

Your first weapon

From an empty studio to a camo rifle with a suppressor, a sight, a bigger magazine and a foregrip on your server. The build itself takes under a minute.

Before you start

  • A SwisserAI account with at least 450 credits: 250 for the reskin and 50 for each of the four parts.
  • An image for the texture. We use a desert camo pattern; a PNG, JPG or WebP up to 16 MB works.
  • Access to your FiveM server files and its server.cfg.
The texture for this walk-through: a camo pattern that fills the whole image.

The eight steps

We turn the Assault Rifle into the Sandstorm Rifle: a camo finish, a suppressor, a holographic sight, a curved magazine and a foregrip.

  1. 1

    Open the Weapon Studio

    In the sidebar open Assets, then Weapon Studio. The studio opens on step 1 of seven, listed on the left.

    1. 1. Weapon Studio: opens the studio
  2. 2

    Pick the base weapon

    On the right, click Assault Rifle. Each tile shows how the base handles, its magazine size and its attach points. Then press Next: Look at the bottom right.

    1. 1. Assault Rifle: handling, magazine size and attach points under the name
  3. 3

    Upload the texture

    Reskin the base model is already picked. Under Texture slots, press Upload next to Weapon body (main texture) and choose your image. Leave Markings and decals as it is.

    1. 1. Weapon body (main texture): the texture that paints the weapon
    2. 2. Upload: pick a PNG, JPG or WebP for the slot
    3. 3. Markings and decals: the second slot, kept from vanilla here

    Press Next: Attachments. A reskin skips Fit & size, because the shape stays the same.

  4. 4

    Add attachments

    Click a mount on the right, then a part: Tactical Suppressor for Muzzle, Holographic Sight for Optic, Extended Curved Magazine for Magazine and Vertical Foregrip for Under grip. Each part appears on the weapon at once.

    Each pick in the mount list puts the part on the weapon at once, at the size and spot it will be built: Tactical Suppressor at the muzzle, Holographic Sight on the rail, Extended Curved Magazine under the receiver, Vertical Foregrip under the barrel.

    Press Side and check that the suppressor touches the muzzle and the magazine shows below the weapon.

    1. 1. MUZZLE: a mount label; click it, then drag the part
    2. 2. Side / Front / Top: check the fit from every side
    3. 3. Mount chips: the part on each mount; × removes it
  5. 5

    Name your weapon

    Click Identity & stats on the left and type Sandstorm Rifle into Name in the weapon wheel. The weapon name WEAPON_SANDSTORMRIFLE appears below it. Leave the rest as it is; step 5, First person, is optional.

    1. 1. Name in the weapon wheel: what players see
    2. 2. Weapon name, Model, Slot: derived from the name
    3. 3. Like the base / Single shot / Full auto: fire mode
    4. 4. Magazine, Damage, Range (m): empty fields keep the base values
  6. 6

    Build it

    Click Build & install, check the price and press Build weapon · 450 credits. The page switches to the build, which lists each step as it finishes. This one took 22 seconds.

    1. 1. credits: the price of this build
    2. 2. Build weapon · 450 credits: starts the build
  7. 7

    Check the result and download

    The result page shows the finished weapon from the game file, its names and one component per part. Press FiveM .zip at the top right to download weapon_sandstormrifle.zip.

    1. 1. Render tabs: side and three-quarter view of the game file
    2. 2. Weapon, Model, Base, Ammo, Fire mode: the names you use on the server
    3. 3. Attachments: one component name per part
    4. 4. checks passed: every check passed before the zip was made
    1. 1. FiveM .zip: downloads the resource
  8. 8

    Install it and give it to a player

    Unzip the download into your server's resources folder, add one line to server.cfg and restart the server:

    ensure weapon_sandstormrifle

    Give the weapon and its parts from any client script. The result page lists these lines for your weapon:

    local ped = PlayerPedId()
GiveWeaponToPed(ped, GetHashKey('WEAPON_SANDSTORMRIFLE'), 250, false, true)
GiveWeaponComponentToPed(ped, GetHashKey('WEAPON_SANDSTORMRIFLE'), GetHashKey('COMPONENT_SANDSTORMRIFLE_TACTICALSUPPRESSOR'))
GiveWeaponComponentToPed(ped, GetHashKey('WEAPON_SANDSTORMRIFLE'), GetHashKey('COMPONENT_SANDSTORMRIFLE_HOLOGRAPHICSIGHT'))
GiveWeaponComponentToPed(ped, GetHashKey('WEAPON_SANDSTORMRIFLE'), GetHashKey('COMPONENT_SANDSTORMRIFLE_EXTENDEDCURVEDMAGAZINE'))
GiveWeaponComponentToPed(ped, GetHashKey('WEAPON_SANDSTORMRIFLE'), GetHashKey('COMPONENT_SANDSTORMRIFLE_VERTICALFOREGRIP'))

    With a framework or an inventory, the weapon first has to be in its weapon list. See ESX, QBCore and ox_inventory.

Good to know

This build cost 450 credits: 250 for the reskin and 4 × 50 for the parts. To add or swap parts later, use Add attachments on the result page: the weapon is not charged again, only the parts on it.

Where to go from here

Set it up on your server

Inventory entries, components and a test command.

Your own model

Upload a GLB, FBX or OBJ and fit it to the base.

Design one from a picture

One side view in, a 3D weapon out.

Name and stats

Fire mode, damage, range and first person.