Blip Manager

Live in-game map blip manager — add, edit, move and delete blips from an admin NUI with no code edits or restarts, and take control of every blip on the map, even ones created by other resources.

Live, in-game map blip manager. Add, edit, move and delete map blips from an admin-gated NUI — no code edits, no restarts. Every change is saved to MySQL and pushed to all online players instantly.

Part of the Gas Team Developers FiveM script library.

Author: rr · Gas Team Developers Version: 2.0.0

Features

• In-game editor — open with /blips (configurable). Add / edit / delete blips with a live form.
• Map Scan — control EVERY blip — a second tab lists every blip currently on the map, including ones created by other resources. Hide any of them, or Adopt one (hides the original and drops an editable rr-blips copy in its place). Your choices are enforced on a background loop, so they persist across restarts and won't pop back when the owning resource reloads. Player, GPS and entity-attached blips are excluded so nothing critical breaks.
• Live preview — while editing, a flashing preview blip shows the exact icon, colour and position on your map in real time.
• Use my location — one click drops the blip at your current coordinates.
• Visual pickers — full colour palette (0–85) and a quick-pick sprite list, plus free numeric entry for any sprite/colour ID.
• Per-row tools — set a GPS waypoint to a blip, or teleport straight to it to check placement.
• Database-backed — blips live in the rr_blips table and persist across restarts. Changes broadcast to everyone live.
• Access control — editing is gated to admins by default; jobs / citizenids can be allowed in config.lua. Everyone always sees the blips.
• Auto-seed — your original hardcoded blip list is imported automatically the first time it runs against an empty table.

Requirements

• FiveM artifact cerulean or newer
• ox_lib
• oxmysql
• qbx_core

Installation

1. Drop this folder into resources/[custom]/rr-blips/.
2. ensure rr-blips in your server.cfg (already ensured via [custom]).
3. Start the server. The rr_blips table is created and seeded automatically.

Usage

• /blips — opens the manager (admins by default).
• Optional keybind: set Config.OpenKey (e.g. 'F7') in config.lua, then rebind in GTA Settings → Key Bindings.

Configuration (config.lua)

• Config.Command — chat command that opens the editor.
• Config.OpenKey — optional default keybind (empty = command only).
• Config.Access — who can edit: admin (ace), jobs, citizenids.
• Config.Defaults — defaults applied to a new blip.
• Config.Seed — first-run import list (ignored once the DB has rows).

Notes

• Blip colour and sprite are stored as their GTA numeric IDs. The palette swatches are a visual hint — the in-game live preview shows the true colour, which is authoritative.
• Display modes: 2 = map only, 4 = map + minimap (default), 8 = minimap only.
• Map Scan / foreign blips: hiding a foreign blip stores a rule in rr_blip_overrides matched by icon + nearby coords; the client keeps it hidden on a 5-second loop. A foreign blip that no longer exists (its resource stopped) won't appear in the scan. Un-hiding takes effect immediately if the blip is currently on the map. Only coordinate blips (AddBlipForCoord) are listed — player/GPS/vehicle/ped blips are intentionally excluded.

License

MIT (c) 2026 Real Results / G.A.S. Team Developers.