Skip to content
Crosshair Generator

Crosshair Generator

Design a FiveM crosshair and export it as a NUI overlay resource, a transparent PNG, an SVG or the real cl_crosshair console settings.

Open the tool Last updated

The Crosshair Generator draws a crosshair in your browser and gives you four ways to use it: a complete NUI overlay resource, a transparent PNG, an SVG, and the FiveM console settings that come closest to it. Everything is rendered on your own machine and nothing is uploaded.

Quick start

  1. Pick a shape at the top of the controls, or a preset under the preview.
  2. Set length, thickness, gap, colour, opacity and outline in the sections on the right.
  3. Switch the preview background between the dark scene, the light scene and the two Los Santos views to check that it still reads.
  4. Open Output, choose NUI overlay, and copy or download the three files.

Press Surprise me for a random crosshair, Ctrl + Z to undo it.

The parts

Each section can be switched on or off on its own, so you can mix them freely. A ring around a T shape with a red dot is a normal thing to build here.

Part Controls
Lines Length, thickness, gap, colour and opacity, which of the four arms are drawn, rounded ends, outline.
Centre dot Size, colour and opacity, square or round, outline.
Circle Radius, thickness, a cut out in degrees that breaks the ring into four arcs, colour and opacity, outline.
Brackets Leg length, distance from the centre, thickness, colour and opacity, rounded ends, outline.
Chevrons Width, distance from the centre, thickness, which of the four directions are drawn, rounded ends, outline.
Outline One width, colour and opacity for the whole crosshair. Each part chooses whether it uses it.

Gap is the distance from the centre of the screen to the inner end of each arm, in pixels. Length is the arm itself, so the outer tip sits at gap plus length.

Shapes and presets

The shape buttons switch parts on and off, they do not throw your settings away. Pick Circle to add the ring to what you already have, pick Cross to go back.

Preset What it is
Minimal dot A single small white dot with an outline.
Classic The four line cross with a gap in the middle.
Classic and dot The same cross with a centre dot.
Sniper Long thin lines, a one pixel red dot and a wide broken ring.
Shotgun A wide ring with short stubby arms.
Roleplay HUD Soft white corner brackets and a small dot.
T shape No top arm, so nothing covers the head of what you are aiming at.
Chevrons Two arrows pointing at the centre.

Preview

  • The zoom buttons (1x, 2x, 4x) only change the preview. Check the crosshair at 1x before you export it, that is the size it will be in game.
  • The spread buttons show the crosshair while standing still, while moving and while firing. This is a preview of your Spread values, the game never does this by itself. The exported overlay can do it if you switch it on.
  • The two Los Santos backgrounds are there to catch the usual mistake: a crosshair that looks great on a dark panel and disappears over concrete.

Sharing and saving

Your crosshair is written into the address bar as you work, so Copy share link gives someone the exact crosshair you are looking at. It is also saved in this browser, so closing the tab does not lose it.

The NUI overlay

The overlay is the output that works for everyone on your server, on any build, without touching anyone’s settings.

Options:

  • Resource name: the folder name, also what you put after ensure in your server.cfg.
  • Show it: always, only while aiming, or only while armed.
  • Hide it in a vehicle.
  • Hide the game reticule: adds a loop that hides the game’s own reticule while the resource runs. It does not change the player’s settings.
  • Open it up while moving and firing: adds a Lua loop that reads the player’s speed and whether they are shooting and pushes the spread to the page.

You get three files:

Text
crosshair/
  fxmanifest.lua
  client.lua
  ui/
    index.html

Drop the folder in your resources, add ensure crosshair to your server.cfg (or whatever you named it) and restart. The page loads nothing from the internet: no fonts, no images, no scripts. It never takes mouse focus, so it cannot block anything.

Tip

If you already have a HUD resource, you do not need a second one. Copy the <div id="crosshair"> block and its styles out of the generated index.html into your own NUI page.

PNG and SVG

  • PNG exports at 128, 256 or 512 px with transparency. By default the crosshair is drawn at its real pixel size and centred, which is what you want when you are dropping it into an overlay or a HUD. Turn on the scale option when you want it to fill the image, for example for a release post.
  • SVG is the same drawing as vectors. Use it in your own HTML, or open it in Figma or Inkscape.
  • Copy PNG puts the image straight on the clipboard where the browser allows it.

Console settings

GTA V has no crosshair commands. It has two options in Settings, Display, which FiveM exposes as convars:

Setting What it is
profile_reticule Weapon Target. 0 is the simple dot, 1 is the complex crosshair that changes per weapon.
profile_reticuleSize Simple Reticule Size. Values below zero shrink the simple dot until it is gone, and -10 is what most people use to get rid of it.

On top of that, the FiveM client draws a crosshair of its own behind cl_customCrosshair. It copies the Counter-Strike crosshair, so it can do four bars, a square centre dot, a black outline, one colour and one opacity. It has no circles, no brackets, no chevrons, no rounded ends and no second colour.

The Console settings tab maps your design onto those convars as closely as they go, lists everything that is lost on the way, and draws what the client will really produce next to your design so you can compare them.

Three things to know about them:

  • They are a client setting, saved with the player’s own FiveM settings. You cannot ship them to your players, and they stay set on every other server until the player changes them.
  • The bar length and thickness are scaled by the player’s vertical resolution, so pick your resolution in the tab before you copy the lines.
  • The only one a server can control is setr cl_customCrosshair false in your server.cfg, which switches the built in crosshair off for everyone while they are on your server. Use it together with the overlay so players do not end up with two crosshairs.

Note

Styles 0, 1 and 3 draw the same crosshair today, because the spread the dynamic styles react to is fixed in the client. Style 2 splits every bar into two pieces and pulls the inner pair into the centre. Style 4 is the one whose gap does not change with resolution, so it is the safest choice.

Tips

  • Keep a 1 px black outline. It is the difference between a crosshair you can see on a white car and one you cannot.
  • Below 2 px thick, a line mostly disappears at 1080p.
  • A large gap reads better for roleplay, where you are not shooting most of the time, and it keeps the middle of the screen clear.
  • Green and cyan hold up almost everywhere on the map. Red disappears on brick and on brake lights.
  • If you build a crosshair for a weapon shop or a minigame, export the PNG and use it as an image in your own NUI instead of shipping a second overlay resource.