Gun Range

Buy Here

FiveM Forums Post

YouTube Walkthrough Video

INSTALLATION GUIDE

Step 0 - First Steps

1. Download your resource from FiveM's Keymaster.

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

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 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 Frameworkand Importantsections at the top of the config.lua. Everything else is optional.

NEW: Auto Framework Detect!

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. You can move your target further away to get a higher score by using the #Chat Command.
2. Use the #Chat Command to start your game and wait for the countdown to begin.
3. 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.
4. The script will automatically recognise your weapon type and add your score to the scoreboard if high enough.

INFORMATION

Chat Commands

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

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.

COMMON ISSUES

Please check out our Troubleshooting Guide before contacting our support.

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

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

CHANGELOG

Files Changed

Not every update requires replacing the entire folder. To avoid redoing your configs, use the option that applies

Key	Meaning
Full Re-Download Required	Delete the old folder and replace it with the latest version. Reuse your config.lua unless told otherwise.
Update Specific Files	Only the files listed below need to be replaced.
Config Update Required	Your config.lua must be updated for this version.
Requires Auto SQL Enabled	Enable Config.AutoInsertSQL in config.lua to apply required database updates.

Skipping Updates

If you’ve skipped previous updates, it’s recommended to update all files to avoid issues.
For example, if you're on v4.0.1, skipped v4.0.2, and are updating to v4.0.3, use the Full Download option.

DANGER

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.