Links

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.
Buy Here
FiveM Forums Post

Translate

START HERE

1. Unzip the cd_gunrange.zip folder and place this folder in your server's resource folder.
2. Add the resource to your server start config: ensure cd_gunrange (if you are using a framework it must be placed anywhere below your framework resource eg., es_extended, not above).
3. WARNING The name of the folder must not be changed or the resource will not function correctly.
4. WARNING Do not edit the encrypted files in any way.

INSTALLATION GUIDE

Step 1 - Configure the resource

You MUST read all of the configurable options inside the config.lua and configure them to suit your server's needs. Please read the ”commented out help text” at the end of each line so you can understand what each config option does.
The most important sections are the options under the Framework and Important sections at the top of the config.lua. Everything else is optional.

HOW TO USE

This resource is very easy to install and configure. Once the steps above are complete the rest is simple:
  1. 1.
    You can move your target further away to get a higher score by using the #Chat Command.
  2. 2.
    Use the #Chat Command to start your game and wait for the countdown to begin.
  3. 3.
    Try to aim for the head and centre body for the highest score. You can track where your bullets are hitting on the UI to the left of your screen.
  4. 4.
    The script will automatically recognise your weapon type and add your score to the scoreboard if high enough.

INFORMATION

Chat Commands

All of these chat commands can be renamed and disabled/enabled in the config.
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.
client-side to client-side
server-side to client-side
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 a 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 a unranked practice shooting session
Practise sessions do not get added to the scoreboard.
TriggerClientEvent('cd_gunrange:client:PracticeMode', source)

COMMON ISSUES

Please check out our Troubleshooting Guide before contacting our support.
🔔 Folder Name Make sure the name of the folder either cd_gunrange.

ERROR CODES

If you see an error code which isn't listed below please open a script support ticket in the Codesign Discord.
Server
Client
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 delete your old cd_gunrange folder, download and add in the latest version, reconfigure the configs folder and restart your server.
  • Specific Files - This means you can simply 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.
v1.0.0
v1.0.2

20/12/2022

Files Changed:
  • All files
  • Specific Files
Update Type:
  • Mandatory
  • Optional
Changelog:
STATUS
  • Development Stage: COMPLETE
  • Alpha Test Stage: COMPLETE
  • Beta Test Stage: COMPLETE

29/01/2023

Files Changed:
  • All files
  • Specific Files
Update Type:
  • Mandatory
  • Optional
Changelog:
Add
  • Added option to create new gun ranges anywhere.
Fix
  • Various bug fixes.