> For the complete documentation index, see [llms.txt](https://laot7490.gitbook.io/ltbridge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://laot7490.gitbook.io/ltbridge/game-systems/blip/blip-properties.md).

# BlipProperties

The `data` table passed to `LT.Blip.Create` uses these fields. You must provide either `coords` **or** `entity` — not both.

| Field           | Type                 | Required             | Description                                     |
| --------------- | -------------------- | -------------------- | ----------------------------------------------- |
| `label`         | string               | Yes                  | Text shown on the map                           |
| `coords`        | vector3 or `{x,y,z}` | One of coords/entity | World position for a static blip                |
| `entity`        | number               | One of coords/entity | Entity handle for a blip that follows something |
| `sprite`        | number               | No                   | Blip icon ID (default: 1)                       |
| `color`         | number               | No                   | Blip color ID (default: 1)                      |
| `scale`         | number               | No                   | Size multiplier (default: 1.0)                  |
| `shortRange`    | boolean              | No                   | Only visible when nearby (default: true)        |
| `display`       | number               | No                   | Display mode (default: 2)                       |
| `rotation`      | number               | No                   | Blip rotation in degrees                        |
| `alpha`         | number               | No                   | Transparency 0–255 (default: 255)               |
| `highDetail`    | boolean              | No                   | High detail rendering (default: false)          |
| `route`         | boolean              | No                   | Show GPS route to blip                          |
| `routeColor`    | number               | No                   | Route line color                                |
| `bright`        | boolean              | No                   | Bright blip style                               |
| `flash`         | boolean              | No                   | Flashing blip                                   |
| `flashInterval` | number               | No                   | Flash speed in ms (default: 500)                |

## Example

```lua
local blip = LT.Blip.Create({
    label = 'Mechanic Shop',
    coords = vector3(1175.0, 2640.0, 37.0),
    sprite = 72,
    color = 5,
    scale = 0.9,
    shortRange = true,
})

-- Later, remove it
if blip then
    blip:delete()
end
```

## Handler methods

`LT.Blip.Create` returns a handler object (not a raw blip ID):

| Method               | Returns   | Description                          |
| -------------------- | --------- | ------------------------------------ |
| `:delete()`          | —         | Removes the blip from the map        |
| `:setCoords(coords)` | `boolean` | Moves a coord blip to a new position |
| `:setColor(color)`   | `boolean` | Changes the blip color               |

Back to [Blip](/ltbridge/game-systems/blip.md)