LogoLogo
  • Codesign Documentation
  • Information
    • Discord Roles
    • FiveM Asset Escrow System
    • Authentication & Transfers
  • Coding Information
    • Register Key Mapping
    • Code Snippets
    • Self Debugging
  • Paid scripts
    • Arm Wrestling
      • Configs, Locales & SQL
    • Car HUD
      • Configs, Locales & SQL
    • CCTV Cameras
      • Configs, Locales & SQL
    • Darts
      • Configs, Locales & SQL
    • Dispatch
      • Configs, Locales & SQL
      • Resource Integration
    • Door Lock
      • Configs, Locales & SQL
    • Garage
      • Keys/Chat/Events/Exports
      • Optional Features
      • Configs, Locales & SQL
      • Resource Integration
    • Gun Range
      • Configs, Locales & SQL
    • Identity
      • Configs, Locales & SQL
    • Multicharacter
      • Configs, Locales & SQL
    • Player HUD
      • Configs, Locales & SQL
    • Props
      • Configs, Locales & SQL
    • Radar
      • Configs, Locales & SQL
    • Spawn Select
      • Configs, Locales & SQL
    • Terminal Hacker
      • Configs, Locales & SQL
    • Vehicle Control
      • Configs, Locales & SQL
    • VIP Shop
      • Configs, Locales & SQL
  • Free Scripts
    • Easytime
      • Keys/Chat/Events/Exports
      • Optional Features
      • Configs & Locales
    • Drawtext UI
    • Devtools
    • Keymaster - Minigame
    • Staff Support
    • Notifications
Powered by GitBook
LogoLogo

Codesign Software © All rights reserved

On this page
  • INSTALLATION GUIDE
  • Step 0 - First Steps
  • Step 1 - Configure Resource
  • HOW TO USE
  • INFORMATION
  • Chat Commands
  • Events
  • COMMON ISSUES
  • ERROR CODES
  • CHANGELOG

Was this helpful?

  1. Paid scripts

Gun Range

Step-by-step installation guide, common issues & solutions, code snippets, error codes, config previews, locales previews, SQL previews, and changelogs; all in 1 easily accessible place.

PreviousResource IntegrationNextConfigs, Locales & SQL

Last updated 2 months ago

Was this helpful?

FiveM Forums Post

Translate

INSTALLATION GUIDE

Step 0 - First Steps

1. Download your resource from .

2. Unzip the cd_gunrange.zip folder and place this folder in your server's resource folder.

3. Add the resource to your server start config (server.cfg): ensure cd_gunrange. If you are using a framework, it must be placed anywhere below your framework resource e.g., es_extended, not above.

ensure es_extended
ensure cd_gunrange

Step 1 - Configure Resource

Introducing our new 'auto_detect' feature! It automatically identifies your framework and applies the appropriate default settings.

HOW TO USE

This resource is very easy to install and configure. Once the steps above are complete, the rest is simple:

  1. Try to aim for the head and centre body for the highest score. You can track where your bullets hit on the UI to the left of your screen.

  2. The script will automatically recognise your weapon type and add your score to the scoreboard if high enough.

INFORMATION

Chat Commands

The exact usage for each command will be displayed in the chat suggestions when using the commands in-game.

Command
Description

/gunrange_start

Start a ranked shooting session.

/gunrange_movetarget

Open the UI to move the target.

/gunrange_scoreboard

Open the UI to view your servers top scores.

/gunrange_practice

Start a unranked practise shooting session.

Events

These events are completely optional; you can use them if needed.

Start a ranked shooting session

Ranked sessions adds your score to your servers scoreboard.
TriggerEvent('cd_gunrange:client:Start')

Open the UI to move the target

Move the target closer or further away from you (further = higher score).
TriggerEvent('cd_gunrange:client:MoveTarget')

Open the UI to view your servers scoreboard

View the top scores from players in your server from all the different weapon categories.
TriggerEvent('cd_gunrange:client:ShowScoreBoard')

Start an unranked practice shooting session

Practise sessions do not get added to the scoreboard.
TriggerEvent('cd_gunrange:client:PracticeMode')

Start a ranked shooting session

Ranked sessions adds your score to your servers scoreboard.
TriggerClientEvent('cd_gunrange:client:Start', source)

Open the UI to move the target

Move the target closer or further away from you (further = higher score).
TriggerClientEvent('cd_gunrange:client:MoveTarget', source)

Open the UI to view your servers scoreboard

View the top scores from players in your server from all the different weapon types.
TriggerClientEvent('cd_gunrange:client:ShowScoreBoard', source)

Start an unranked practice shooting session

Practise sessions do not get added to the scoreboard.
TriggerClientEvent('cd_gunrange:client:PracticeMode', source)

COMMON ISSUES

🔔 Folder Name Make sure the name of the folder either cd_gunrange.

🔔 Encrypted Files Do not edit the encrypted files in any way.

ERROR CODES

N/A

N/A

CHANGELOG

Files Changed

Not every update requires you to replace the whole folder. We do this because we understand it's a pain to redo the configs for every update.

  • All Files - This means you should make a backup of the JSON Files folder, delete your old cd_gunrange folder, download and add in the latest version, replace the new JSON Files folder with the one you made a backup of, configure the configs folder and restart your server.

  • All Files Except config.lua - This means you should do all of the above (in the All Files section) but additionally make a backup of the config.lua file and replace the new config.lua file with the one you made a backup of.

  • Specific Files - This means you can copy and paste the SPECIFIC new files over the old ones and restart the server.

Update Type

On rare occasions, you are forced to update to the latest version. Mostly due to authentication updates where the old versions will no longer work.

  • Mandatory - This means you MUST update to this new version, or the old versions will no longer work.

  • Optional - This means it's completely your choice whether you wish to update to the latest version. But we do not offer support for old versions for obvious reasons; they are old.

PLEASE READ! (JSON files)

When updating a resource that uses JSON files as a database as this one does, DO NOT delete/replace the files/folders inside the JSON files folder, as this will overwrite your saved database.

Skipping Updates

If you are attempting to update to the latest version but have skipped previous updates, you should update all files just to be safe. For example., let's say you are currently on v4.0.1, you did not update when v4.0.2 was released, and now v4.0.3 is released, and you want to update; you should always use the “All Files” update method.

20/12/2022

Files Changed:

Update Type:

Changelog:

STATUS

  • Development Stage: COMPLETE

  • Alpha Test Stage: COMPLETE

  • Beta Test Stage: COMPLETE

29/01/2023

Files Changed:

Update Type:

Changelog:

Add

  • Added option to create new gun ranges anywhere.

Fix

  • Various bug fixes.

12/02/2023

Files Changed:

Update Type:

Changelog:

Add

  • Auto Framework Detection - We have added a new feature we are calling 'auto_detect', which will automatically identify your framework and apply the appropriate default settings.

  • Added the option to display debug prints.

17/09/2024

Files Changed:

Update Type:

Changelog:

Add

  • Added webhooks.

Edit

  • Code optimisation.

  • Removed unnecessary prints.

Fix

  • Bug fix with custom gun ranges.

19/02/2025

Files Changed:

fxmanifest.lua
configs/config.lua
configs/server_customise_me.lua
server/server.lua

Update Type:

Changelog:

Fix

  • Fix for esx character names.

You MUST read all configurable options inside the [cd_gunrange/configs/config.lua] file and configure them to suit your server's needs. Please read the at the end of each line so you can understand what each config option does.

The most important sections are the options under the and sections at the top of the config.lua. Everything else is optional.

You can move your target further away to get a higher score by using the .

Use the to start your game and wait for the countdown to begin.

These chat commands can be renamed and/or disabled in the section of the [configs/config.lua].

Please check out our before contacting our support.

If you see an error code not listed below, please open a script support ticket in the .

Buy Here
YouTube Walkthrough Video
Click here to translate this page.
How do I change language?
FiveM’s Keymaster
”commented out help text”
Framework
Important
NEW: Auto Framework Detect!
Keys and Commands
Troubleshooting Guide
Codesign Discord
#Chat Command
#Chat Command