Client Blips

File: client/blips.lua

GPS blip system for group member tracking.

Responsibilities

• Create/remove blips for group members
• Detect vehicle type and change blip sprite
• Handle blip color, scale, and range
• Toggle GPS on/off per player

Configuration

Config.Blips = {
    enabled = true,
    requireItem = true,        -- Must have item to use GPS
    item = 'gps_tracker',      -- Required item
    autoToggle = true,         -- Auto-enable on group join

    color = 3,
    scale = 0.8,
    display = 4,
    shortRange = false,

    footInterval = 500,        -- Update interval on foot (ms)
    vehicleInterval = 500,     -- Update interval in vehicle (ms)

    sprites = {
        onFoot = 1,
        car = 225,
        bike = 226,
        boat = 410,
        helicopter = 64,
        plane = 16,
        train = 304,
        submarine = 308,
    },
}

Vehicle Detection

Vehicle class → sprite mapping:

• Classes 0-7, 17-18, 20 → car
• Class 8-9 → bike
• Class 10-14, 19, 21 → boat
• Class 15-16 → plane

Special model overrides for helicopters (cargobob, buzzard, etc.), boats (dinghy, speeder, etc.), and trains.

Events

Event	Description
wtf_group:client:gpsSync	Receive blip data from server
wtf_group:client:gpsToggled	GPS toggle state changed