# Tracking Configuration

## Shared.EnableTracking

Whether or not the `/dtrack` command should be enabled. This ONLY effects the `/dtrack` command, and using `/dscent` is still possible when this is false (Can be turned off in a different config option). 

```lua
Shared.EnableTracking = true -- Whether or not the tracking system should be enabled. NOTE: If this is false and Shared.EnableFindingID is true, the finding ID + subsequent track will still function.
```

## Shared.EnableTrackingMenu

Whether or not to send a prompt to the tracking target asking them if they want to be tracked. If this is true, the player that is being tracked must accept the track in order for a dog to track them. If this is false, the dog will track players without their confirmation.

```lua
Shared.EnableTrackingMenu = true -- Whether or not to send a prompt to the tracking target asking them whether or not they can be tracked.
```

## Shared.EnableWarning

Whether or not to enable a warning for a dog handler when a track is started, that advises them of the OneSync restriction that the dog can't track more than 400 GTA Units. If this is true, the frequency can be changed below.

```lua
Shared.EnableWarning = true -- Whether or not to send a warning when a track is started advising of GTA restrictions in terms of tracking distance. (Tracks more than 400m don't work)
```

## Shared.WarningFrequency

If the above `Shared.EnableWarning` is true, then this configuration option determines how often the warning is shown. If this is set to "FIRST", a dog handler will only be shown this warning the first time they use the script. If this is "EVERY", a dog handler will be shown this every time they start a track.

```lua
Shared.WarningFrequency = "FIRST" -- FIRST or EVERY - whether or not to only send the notification the first time a user starts a track, or every time.
```

## Shared.EnableFindingID

Whether or not to enable the `/dscent` command. This is a very cool feature that allows dog handlers to track players from a car. They can approach an abandoned car, run this command and specify either the driver or passenger, and the dog will know who the last person in that seat was, and start a track. 

This can be true even if `Shared.EnableTracking` is false, and the only method of tracking will be through this system.

```lua
Shared.EnableFindingID = true -- Whether or not to enable the /dscent <driver|passenger> command. This allows you to find the ID of the last person in the drivers/passengers seat to start a track with.
```

## Shared.BarkOnTrackingSuccess

Whether or not the dog should bark at a player when they locate them following a track. If false, the dog will continue to track the target until `/dctrack` is run to cancel the track. If true, the dog will automatically stop the track when they are within the below range, and start barking at the target.

```lua
Shared.BarkOnTrackingSuccess = true -- Whether or not the dog should bark at a tracking target after a successful track, if true, the track will stop when the dog is within the below distance of the target and will bark in their direction. If not, the dog will continue tracking until /dctrack is ran.
```