📡 zrx_tracker — Advanced Tracker System

An advanced, optimized and fully configurable player tracking system for FiveM (ESX).

Perfect for police, EMS, faction and roleplay servers looking for a professional real-time tracking system.

📌 Features

• 📡 Custom sync system with interval and live sync support
• 🛰️ Live blip sync inside OneSync range
• 📍 Coordinate blips outside OneSync range
• 🚨 Siren flash system (red/blue blip flashing)
• 🌊 Water detection system
• 💀 Death detection system
• 🔕 Optional notifications for all tracker actions
• 👮 Job-based tracking restrictions
• 🤝 Shared job visibility groups
• 🎨 Custom colors per shared job
• 🚗 Automatic blip sprite based on vehicle class
• 🧠 StateBag synchronized states
• 🪣 Routing bucket support
• ⚙️ Fully customizable notifications, strings and functions
• 🔐 Optimized and fully synced

📦 Requirements

• ox_lib
• oxmysql
• es_extended

⚙️ Installation

1. Download the resource
2. Place zrx_tracker into your resources folder
3. Add this to your server.cfg

ensure zrx_tracker

1. Edit configuration/config.lua

📤 Exports

Server

exports['zrx_tracker']:disableTracker(player, bool)

Disable or enable the tracker for a player.

🧠 StateBags

📡 Events

⚙️ Configuration Example

Config.Item = 'tracker'

Config.OnlyShowSameBucket = true

Config.Sync.live = true

Config.Sync.liveRefresh = 800

Config.Sync.time = 5

Config.Disable.water = true

Config.Disable.death = true

Config.ShowNotify.onSend = true

Config.ShowNotify.onRemove = true

Config.ShowNotify.onDeath = true

Config.ShowNotify.onWater = true

Config.BlockedJobs = {
    unemployed = true,
}

Config.SharedJobs = {
    { police = { r=0,g=0,b=255 }, ambulance = { r=255,g=0,b=0 } },
}

Config.Blip.changeOwn = false

Config.Blip.extra.siren = true

Config.Blip.extra.heading = true

Config.Blip.extra.height = true

Config.Blip.extra.vision = true

🚗 Vehicle Blip Types

• main
• automobile
• bike
• heli
• boat
• plane
• submarine
• train
• trailer
• water
• death

🔔 Notification Customization

Customize your own notification system inside:

configuration/function.lua

Example:

Config.Function.Notification = function(player, msg, title, type, color, time)

    -- server: TriggerClientEvent
    -- client: lib.notify(...)

end

All notification strings can be edited inside:

configuration/strings.lua

🐞 Debug Logging

Config.Debug = false

Config.DebugLevel = 'INFO'

Available levels:

• TRACE
• DEBUG
• INFO
• WARN
• ERROR

⚡ Performance

• Optimized sync handling
• Low resource usage
• OneSync optimized
• StateBag synchronized
• Production-ready

🛠️ Support

Need help or found a bug?

Discord: https://discord.gg/mcN25FJ33K