Blips

This is a server module and can not be used on the client.

CreateBlip

Creates a new blip on the map using the provided configuration. This function wraps RageMP’s native mp.blips.new API to simplify blip creation and ensure unique identifiers. Each blip is stored internally, preventing accidental duplication. If a blip with the same ID already exists, the existing one is returned instead of creating a new one.

Parameter	Type	Required	Default	Description
id	string	✅ Yes	—	Unique identifier for the blip. Must be unique across all created blips.
sprite	number	✅ Yes	—	The sprite index of the blip (see RageMP blip sprite list).
position	Vector3	✅ Yes	—	World position where the blip will appear.
name	string	❌ No	''	The display name of the blip shown on the map.
scale	number	❌ No	1.0	The scale (size) of the blip.
color	number	❌ No	0	The color of the blip.
alpha	number	❌ No	255	The transparency level (0–255).
drawDistance	number	❌ No	100	Distance at which the blip becomes visible.
shortRange	boolean	❌ No	false	If true, the blip is only visible when the player is close.
rotation	number	❌ No	0	The rotation of the blip.
dimension	number	❌ No	0	The dimension the blip appears in.
radius	number	❌ No	0	Optional radius for area-type blips.

JavaScript

const Blips = require('../blips/blips.js')

Blips.CreateBlip({
    id: 'test_blip',
    sprite: 51,
    position: new mp.Vector3(-789.38, 87.98, 54.23),
    name: 'Test Blip',
    color: 3
});

RemoveBlip

Removes an existing blip from the map using its unique ID.

Parameter	Type	Required	Description
blipId	string	✅ Yes	The unique ID of the blip to remove. Must match the ID used when creating the blip.

JavaScript

const Blips = require('../blips/blips.js');
const removed = Blips.RemoveBlip('test_blip');

if (removed) {
    console.log('Blip removed successfully!');
} else {
    console.warn('Blip not found.');
}