London Studios Documentation
Our StoreSupport PanelYouTube Channel
  • General
    • Documentation
    • Resource Support
    • Downloading Resources
    • Installing Resources
    • Resource Transfers
    • Common Errors
    • Translating Resources
    • Inventory Icons
    • Resource Ideas
    • Integration Requests
  • Vehicles
    • American Rearmount Ladder
      • Setting up
      • Anticheat Issues
    • Advanced Recovery Truck
      • Setting up
      • Anticheat Issues
    • SWAT Vehicle
      • Setting up
      • Anticheat Issues
    • Police Water Cannon
      • Setting up
      • Anticheat Issues
    • British Ladder Truck
      • Setting up
      • Anticheat Issues
    • Tiller Ladder Truck
      • Setting up
      • Anticheat Issues
    • Scissor Lift
      • Setting up
      • Anticheat Issues
    • Car Transporter
      • Setting up
      • Anticheat Issues
    • Water Carrier & Command Unit
      • Setting up
      • Anticheat Issues
    • Water Spray Unit
      • Setting up
      • Anticheat Issues
    • Snow Loader Pack
      • Setting up
      • Anticheat Issues
  • Resources
    • Bike Hire
      • Using the resource
      • Configuring the resource
      • Configuring locations
    • Bomb Disposal Robot (EOD)
      • EOD - How to use
      • EOD - Permissions Check
      • OX_Inventory Integration
      • Other Integrations
    • Car Sale Sign
      • Installation Video
      • Using the resource
      • Configuring the resource
      • Configuring permissions
      • Item Support
    • Congestion Charge
      • Configuring the resource
      • Modifying Zones & Adding Cameras
    • Custom Vinewood Sign
      • Installation Video
      • Sign Setup
    • Decontamination Tent
      • Using the resource
      • Configuring the resource
      • OX_Inventory Integration
      • Other Integrations
    • Directional Spikes
      • Using the resource
      • Configuring the resource
    • Emergency Call Points
      • Using the resource
      • Configuring the resource
    • Fire Supply Line [v2]
      • Using the resource
      • Configuring Fire Supply Line
    • Fire Tools [v2]
      • Using the resource
      • Configuration
      • Permissions, Notifications and Items
      • Item Support
    • Helicopter Rescue
      • Using the resource
      • Configuring the resource
      • Configuring the permissions
      • Configuring locations
    • Mobile Spike
      • Setting up vehicles
      • Misc Configuration Values
      • Permission Checks
      • OX_Inventory Integration
      • Other Integrations
    • Police Grappler
      • Setting up vehicles
      • Misc Configuration Values
      • Permissions, Notifications & Items
      • Item Support
    • Police Shields
      • Using the resource
      • Permissions, Notifications & Items
      • Item Support
    • Rope Rescue Tripod & Basket
      • Using the resource
      • Configuring the resource
      • OX_Inventory Integration
      • Other Integrations
    • Rescue Cushion
      • Using the resource
      • Permissions, Notifications & Items
      • Other Integrations
    • Smart Speed Signs
      • Configuring the resource
      • Adding new locations
    • Smart Airbags
      • Using this resource
      • Permissions & Notifications
    • Smart Bollards
      • Installation Video
      • Configuring the resource
      • Setting up a new set
    • Smart Clamp
      • Permissions, Notifications and Items
      • Item Support
      • Exports and Events
    • Smart Defib
      • Using the resource
      • Defib locations
      • Framework support
      • Setting up blips
      • Chance of success
      • Sound settings
      • Keybind configuration
      • Automatic reset
      • Custom Death Scripts
      • OX_Inventory Integration
      • Other Integrations
    • Smart Drone
      • Using the resource
      • Permission Checks, Notifications & Items
      • Keybinds
      • Item Support
      • Other Integrations
    • Smart Fires
      • Installation Video
      • Putting out fires
      • Fire Alerts
      • Remove Fires Automatically
      • Custom Notifications
      • Automatic Fires
        • Enabling automatic fires
        • Job / Permission Check
        • Adding locations
        • Automatic Fire Chances
        • Other automatic fire settings
      • Commands
      • Command permission checks
      • Editing fire types
      • Editing smoke types
      • Misc configuration values
      • Setting up weapons
      • Area of patrol settings
      • Clock on system
      • Lighter Item & Command
      • Server exports and events
      • Discord logging
      • Society Payments
    • Smart Hose [v2]
      • Using the resource
      • Configuring Smart Hose
    • Smart Matrix
      • Install & Configuration Video
      • OX_Inventory Integration
      • Other Integrations
    • Smart Motorways
      • Using the resource
      • Configuring the resource
    • Smart Signs
      • Configuring the resource
      • Configuring the permissions
    • Smart Speed Cameras
      • Configuring the resource
      • Adding new cameras
    • Smart Taser
      • Using the resource
      • Configuration
      • OX_Inventory Integration
      • Other Integrations
    • Smart Vehicle
      • Compatible Vehicles
      • Free Developer Copy
      • Permission Checks
      • Using a Smart Vehicle
      • Informations for Developers
      • Vehicle Control Menus
    • Police Tracker
      • Setting up vehicles
      • Resource Configuration & Usage
      • Item Support
    • Throw Bag
      • Resource Usage
      • OX_Inventory Integration
      • Other Integrations
    • Vehicle Rescue
      • Using the Resource
      • Permissions, Notifications & Items
      • Copy of Item Support
    • Water Monitor
      • Using the resource
      • Copy of Permissions, Notifications & Items
      • Copy of Item Support
    • Weapon Lanyard
      • Setting up weapons
      • Using the resource
      • Setting up clothing / EUP
Powered by GitBook
On this page
  • Commands
  • Deploying and using
  • Location on map
  • Controls
  • Blips
  • Main Section
  • Sonoran CAD Integration
  • Permissions
  • Notifications
  • Inventory Items
  • Discord Logging
  • Translations
  • Animation

Was this helpful?

  1. Resources
  2. Police Tracker

Resource Configuration & Usage

The following document explains how to configure Police Tracker!

PreviousSetting up vehiclesNextItem Support

Last updated 4 months ago

Was this helpful?

Please note that this resource is named Star Chase on Cfx Portal / Keymaster. We are unable to rename assets on this system. Please ensure the folder is named policetracker.

All vehicles used with Police Tracker must be setup in the config.lua file. This document will show you how to configure the resource and setting up vehicles was covered in the previous document.

Commands

/tracker [install/load/remove/removetracker]

If you have items enabled, you'll need the item in your inventory to either load or install the police tracker. Removing the tracker should return this item back to your inventory.

  • Install - This installs the tracker on the vehicle in front of you. You must not be inside a vehicle.

  • Load - This loads a cartridge on the vehicle in front of you, which must already have a police tracker setup on it. You must not be inside a vehicle. You may want to run this command twice to ensure that your police tracker is loaded with two cartridges and ready to be deployed.

  • Remove - This removes the tracker and cartridges on the vehicle in front of you, which must already have a police tracker setup on it. You must not be inside a vehicle.

  • Removetracker - This allows you to remove a tracking dart from a target vehicle when stood in front of it, preventing the location of the target vehicle from being updated any further.

Deploying and using

Once you have installed a tracker on your current police vehicle, press X by default to ready/un-ready the police tracker, making it good to deploy. Next, you will see a green line appearing behind target vehicles which shows the possibility for you to deploy the police tracker.

When ready, press Y by default to deploy the police tracker.

Location on map

You will then see the location of the target vehicle updating on your map by a blip, also showing you the numberplate of the target vehicle. If configured, this will also show for other police units online.

Controls

controls = {
    ready = {0, 73}, -- X by default
    deploy = {0, 246}, -- Y by default
}

Blips

blipSettings = {
    blipID = 596, -- This is the icon
    blipColour = 46, -- This is the colour
    blipScale = 1.5, -- This is the size
    blipName = "License:" -- This is the text
}

This section allows you to edit the blip which will be displayed after the tracker is deployed on a target vehicle, showing you their current location and also their number plate.

Main Section

main = {
    soundVolume = 0.7, -- Max of 1.0
    disableBeeps = true,
    timeBetweenUpdates = 5, -- Time between coordinate updates.
    developerMode = false,
    disableSonoranCad = false, -- Manually disable SonoranCAD integration (If you're using SonoranCAD but do not want to use the integration set to true.)
}

This section allows you to set the sound volume of the sounds, whether you want beep sounds enabled, the time in seconds between coordinate updates and whether you want developer mode enabled.

Sonoran CAD Integration

By default, Sonoran CAD is fully integrated and no further action is required from yourself. If you'd rather disable Sonoran CAD, just set disableSonoranCad to true in the main section.

Permissions

Permissions = {
    EnablePermissions = false,
    AcePermissions = {
        Enabled = false,
        Permissions = {"tracker.use", "tracker.police"}
        -- This enables ace permissions on the starchaser
    },
    -- We've added ESX integration. All you need to do is enable it below and configure which jobs can use the command
    ESX = {
        Enabled = false,
        CheckJob = {
            Enabled = false, -- Enable this to use ESX job check
            Jobs = {"police"} -- A user can have any of the following jobs, allowing you to add multiple
        }
    },
    -- We've added vRP integration. All you need to do is enable it below. Then, configure if you wish to check for groups or permissions, or even both
    vRP = {
        Enabled = false,
        CheckGroup = {
            Enabled = false, -- Enable this to use vRP group check
            Groups = {"police"}, -- A user can have any of the following groups, meaning you can add different jobs
        },
        CheckPermission = {
            Enabled = false, -- Enable this to use vRP permission check
            Permissions = {"police"} -- A user can have any of the following permissions, allowing you to add multiple
        },
    },
    -- We've added QBCore integration. All you need to do is enable it below. Then, configure if you wish to check for jobs or permissions, or even both
    QBCore = {
        Enabled = false,
        CheckJob = {
            Enabled = false, -- Enable this to use QBCore job check
            Jobs = {"police"}, -- A user can have any of the following jobs, meaning you can add different jobs
        },
        CheckPermission = {
            Enabled = false, -- Enable this to use QBCore permission check
            Permissions = {"police"}, -- A user can have any of the following permissions, allowing you to add multiple
        },
    },
    QBX = {
        Enabled = false,
        CheckJob = {
            Enabled = false, -- Enable this to use QBX job check
            Jobs = {"police"}, -- A user can have any of the following jobs, meaning you can add different jobs
        }
    },
}

This section allows you to enable permissions for AcePermissions, ESX, vRP, QBCore and QBX. These permissions will operate on the /tracker command if items are not enabled and will also decide who is shown the live location of vehicles which have had a tracker deployed on them.

For example, if you have items enabled and also set QBCore permissions to the police group, anyone with the tracker item will be able to install the tracker, but only users in the police group will be shown the live location of vehicles which currently have a tracker dart attached to them.

Adding custom permissions

The code for our permissions is located in sv_utils.lua and we encourage you to make edits.

Notifications

Notifications = {
    Enabled = true,
    Framework = {
        QBCore = false, 
        QBX = false,
        ESX = false,
        vRP = false, 
        okok = false, -- https://okok.tebex.io/package/4724993
    }
}

This allows you to modify the notifications used for the resource. By default, notifications will be base game notifications shown ontop of the map. However, you may enable a framework/resource such as QBCore, QBX, ESX, vRP or OKOKNotify.

Adding custom notifications

The code for our notifications is located in cl_utils.lua and we encourage you to make edits.

Inventory Items

Inventory = {
    cartridgeItemName = "tracker_cartridge",
    trackerItemName = "tracker",
    oxInventory = false,
    quasarInventory = false,
    coreInventory = false,
    ESX = false,
    vRP = false,
    qbCore = false,
}

The next section allows you to configure whether inventory items are enabled/disabled. Setting up inventory items is covered in the next page of this documentation.

Discord Logging

Police Tracker has full support for Discord Logging, allowing you to receive logs straight to your Discord channel via a webhook.

logging = {
    enabled = true,
    displayName = "Police Tracker",
    colour = 31487,
    title = "**New Log**",
    icon = "https://i.imgur.com/n3n7JNW.png",
    footerIcon = "https://i.imgur.com/n3n7JNW.png",
    dateFormat = "%d-%m-%Y %H:%M:%S", -- Day-Month-Year Hour-Minute-Second
}

After configuring this section, you'll need to add your webhook into the sv_utils.lua file.

Translations

The translations section of the config allows you to translate the resource into another language.

translations = {
    starChaseCommandHelp = "Install, load and remove police tracker",
    starChaseParameterOne = "Action",
    starChaseParameterOneHelp = "install/load/remove/removetracker",
    invalidStarChaseArguments = "~r~Error~w~: Invalid command arguments.",
    noPermission = "~r~Error~w~: You do not have permission to access this command.",
    inVehicle = "~r~Error~w~: You must not be in a vehicle.",
    noVehicleFound = "~r~Error~w~: No vehicle found.",
    vehicleNotAllowed = "~r~Error~w~: This vehicle does not support police tracker.",
    cannotPerformAction = "~r~Error~w~: You are unable to perform that action.",
    installed = "~g~Success~w~: Police tracker installed.",
    installedStarChase = "Installed and Loaded police tracker",
    vehicle = "Vehicle: ",
    noStarChaseFound = "~r~Error~w~: No police tracker found to load, or full.",
    noStarChaseFoundToRemove = "~r~Error~w~: No police tracker found to remove.",
    starChaseRemovedPolice = "~r~Tracker Issue~w~: Tracker has not moved in 20 seconds for the vehicle with the plate: ",
    starChaseRemovedCriminal = "~g~Success~w~: Tracker removed from vehicle.",
    recentlyReloaded = "~r~Error~w~: Please wait for the cooldown to finish.",
    loadedStarChase = "Loaded police tracker",
    removedStarChase = "Removed police tracker",
    press = "Press",
    ready = "Police tracker ~g~ready~w~ to deploy.",
    unready = "Police tracker ~r~unreadied~w~ to deploy.",
    loadedFirst = "Police tracker: ~g~Loaded~w~ the first tracker.",
    loadedSecond = "Police tracker: ~g~Loaded~w~ the second tracker.",
    loadingPleaseWait = "Loading the tracker...",
    noItem = "You do not have the requireds item",
}

Animation

By default, Police Tracker has an animation which is used when installing or removing a police tracker on any vehicle. In this section, you can disable/enable the animation and also adjust the animation used.

animation = {
    enabled = true,
    dict = "mini@repair",
    name = "fixing_a_ped"
}

This allows you to change the controls to ready and deploy the Police Tracker. For a full list of controls, see the FiveM list .

here