# C Jobgps

### ⚙️ **C Tracker Configuration Overview**

**C Tracker** by **C Service** is a modular, realistic, and fully configurable GPS tracking system for FiveM servers.\
This documentation provides a quick overview of all available configuration options and their purpose.

***

#### 🧩 **General Settings**

| Option                  | Description                                                   |
| ----------------------- | ------------------------------------------------------------- |
| `Config.Debug`          | Enables debug mode (prints debug info in console).            |
| `Config.RequiredItem`   | Item name required to activate the tracker (e.g., `tracker`). |
| `Config.ShowOwnBlip`    | Whether players can see their own blip on the map.            |
| `Config.UpdateInterval` | Time (in milliseconds) between GPS updates.                   |

***

#### 🔋 **Battery System**

| Option                 | Description                                                  |
| ---------------------- | ------------------------------------------------------------ |
| `Config.BatterySystem` | Enables the battery system.                                  |
| `Config.BatteryItem`   | Item name used to recharge the tracker.                      |
| `maxCharge`            | Maximum charge percentage (default: 100).                    |
| `drainRate`            | Battery drain rate per minute.                               |
| `warnings`             | Define when warnings are displayed (low, critical, urgent).  |
| `notifyTeamOnEmpty`    | Notify team when the tracker battery runs out.               |
| `autoDisableOnEmpty`   | Automatically disables the tracker when empty (always true). |

💡 **Tip:**\
You can fine-tune the realism by adjusting the `drainRate` or disabling the system entirely.

***

#### 💧 **Water Damage System**

| Option                      | Description                                                    |
| --------------------------- | -------------------------------------------------------------- |
| `Config.WaterDamageEnabled` | Destroys tracker after being in water for more than 5 seconds. |

When destroyed, the tracker sends a **last known position** notification to the team.

***

#### ☠️ **Death Detection System**

| Option                         | Description                                              |
| ------------------------------ | -------------------------------------------------------- |
| `Config.DisableTrackerOnDeath` | Automatically disables the tracker when the player dies. |

If set to `false`, the tracker remains active until the battery runs out — great for realism.

***

#### 🧭 **HUD Customization**

| Option                           | Description                                                                                                     |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `Config.HUD.position`            | HUD position (`top-left`, `top-right`, `bottom-left`, `bottom-right`, `center`, `middle-right`, `middle-left`). |
| `Config.HUD.scale`               | HUD size multiplier (default: `1.0`).                                                                           |
| `Config.HUD.offsetX` / `offsetY` | Fine adjustments for HUD position.                                                                              |

🖼️ **Changing the HUD / Logo / Tracker Image**\
You can replace the **HUD**, **Tracker**, and **Logo** images in:

```
c_tracker/html/images/
```

**Supported formats:** `.png` or `.jpg` (transparent background recommended)

📏 **Recommended image sizes:**

* 🧭 **Tracker Image:** `500 x 500 px`
* 🪪 **Logo:** `268 x 64 px`

💡 **Tip:** Use consistent aspect ratios and transparent backgrounds for the best in-game appearance.

***

#### 🗺️ **Blip Configuration**

| Option                     | Description                                                  |
| -------------------------- | ------------------------------------------------------------ |
| `Config.BlipNameType`      | Display type: `character` (RP name) or `steam` (Steam name). |
| `Config.BlipAlpha`         | Blip transparency (default: 255).                            |
| `Config.BlipScale`         | Blip size (default: 0.8).                                    |
| `Config.MergeVehicleBlips` | Merges blips if multiple players are in the same vehicle.    |

***

#### 📍 **Tracker Removal System**

| Option                             | Description                                                   |
| ---------------------------------- | ------------------------------------------------------------- |
| `Config.TrackerRemovalEnabled`     | Detects if tracker is removed/destroyed.                      |
| `Config.TrackerRemovalBlipTime`    | Duration (seconds) that “Last Position” blip remains visible. |
| `Config.TrackerRemovalBlipColor`   | Color ID for the blip.                                        |
| `Config.TrackerRemovalBlipSprite`  | Sprite ID for the blip.                                       |
| `Config.NotifyTeamOnRemoval`       | Notifies team when a tracker is removed.                      |
| `Config.ShowLastPositionOnRemoval` | Shows last position blip after tracker removal.               |
| `Config.LastPositionBlipText`      | Custom text format for the last position message.             |

***

#### 🧑‍✈️ **Faction Configuration**

You can define unlimited jobs/factions — each with unique colors, icons, and blip sprites.

**Example:**

```lua
Config.Factions = {
    polizei = {
        enabled = true,
        color = 38,
        defaultSprite = 1,
        sprites = {
            foot = 1,
            car = 326,
            heli = 422
        }
    },
    ambulance = {
        enabled = true,
        color = 5,
        defaultSprite = 1
    }
}
```

***

#### 🔔 **Notification System**

| Option                      | Description                             |
| --------------------------- | --------------------------------------- |
| `Config.NotifyType`         | Choose between `esx` or `custom`        |
| `Config.CustomNotify.event` | Custom event for custom notify systems. |
| `Config.CustomNotify.time`  | Display time in ms.                     |

All notification messages can be fully customized in `Config.NotifyText`.

***

#### 🚗 **Vehicle Detection**

Each vehicle class can be linked to a different blip sprite:

```lua
Config.VehicleClasses = {
    foot = -1,
    car = {0,1,2,3,4,5,6,7,9,10,11,12,17,18,19,20},
    bike = {8,13},
    boat = {14},
    heli = {15},
    plane = {16}
}
```

***

#### 🧠 **Final Notes**

✅ Fully customizable for every faction and server type\
✅ Designed for realism and optimized performance\
✅ All messages and features can be adjusted without code editing


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://c-service.gitbook.io/c-service-docs/c-jobgps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.