> For the complete documentation index, see [llms.txt](https://hane-mod-studio.gitbook.io/hane-mod-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hane-mod-studio.gitbook.io/hane-mod-studio/hane-scripts/hane-gps.md).

# Hane GPS

Job-Based Location Tracking System

Hane GPS is a job-based location tracking system designed for emergency service roleplay. It allows on-duty personnel to track their teammates in real-time on the map through a sleek, device-styled NUI interface.

Officers, medics, and other configured units can activate their GPS to see all active members within their department.

***

#### 🔑 Key Features

* **Real-time blip tracking** for same-job personnel
* **Custom device-styled NUI interface** with frame overlay
* **Entity-based blips** with automatic fallback to coordinate blips
* **Callsign and unit name integration** (lb-tablet & Hane Dispatch support)
* **Multi-framework bridge system** (QBX, QBCore, ESX — auto-detected)
* **Multi-inventory support** (ox\_inventory, qb-inventory, qs-inventory)
* **Full locale system** with Turkish and English translations
* **GPS item requirement** with live inventory checking
* **Automatic cleanup** on job change, duty toggle, or player disconnect
* **Configurable per-job blip** sprite, color, and scale
* **Optimized refresh loop** with configurable sync interval

***

#### 📦 Dependencies

| Resource         | Required | Notes                                        |
| ---------------- | -------- | -------------------------------------------- |
| Framework        | ✅ Yes    | QBX, QBCore, or ESX                          |
| Inventory System | ✅ Yes    | ox\_inventory, qb-inventory, or qs-inventory |
| `lb-tablet`      | ❌ No     | Optional — for callsign display              |
| `hane_dispatch`  | ❌ No     | Optional — for unit name display             |

***

#### 📁 Resource Structure

```
hane_gps/
├── bridge/
│   ├── client.lua    # Client-side framework & inventory bridge
│   ├── server.lua    # Server-side framework bridge
│   └── shared.lua    # Shared locale system
├── html/
│   ├── index.html    # NUI interface
│   ├── style.css     # NUI styling
│   ├── script.js     # NUI logic
│   └── gps_frame.png # Device frame overlay
├── locales/
│   ├── en.lua        # English translations
│   └── tr.lua        # Turkish translations
├── client.lua        # Main client logic
├── server.lua        # Server logic & sync
├── config.lua        # Configuration
├── item.txt          # Item registration reference
└── fxmanifest.lua
```

***

#### 🔗 Quick Links

* Installation
* Configuration
* Localization
* FAQ & Troubleshooting