Skip to content
M2O Scripting APIScripting reference
GuideMaintainer authored

Map blips

Mafia II map icons are selected with a (library, iconId) pair. Library 0 contains twelve icons addressed by IDs 1 through 12; the other available libraries contain one icon each at ID 0.

Blips are authoritative server entities. They replicate to connected players, can remain at a fixed world position, and can follow a player or vehicle.

Use Blip.create(x, y, z, library, iconId, color?, virtualWorld?) from a server resource:

const droppedBlips = [];
Events.on("playerCommand", (player, command) => {
if (command !== "dropblip") return;
const position = player.position;
const blip = Blip.create(
position.x,
position.y,
position.z,
0, // Library
1, // Icon ID
5 // Navigation palette index
);
droppedBlips.push(blip);
});

Call blip.setIcon(library, iconId) to change an existing icon. blip.attachToPlayer(player) and blip.attachToVehicle(vehicle) make it follow an entity; blip.destroy() removes it. Keep references to created blips so your resource can destroy them when they are no longer needed.

The optional color is an index from 0 to 8 into the game’s navigation palette; a blip created without one uses 1. The game names these entries after what it uses them for (default, player, enemy, neutral, friendly, objective, vehicle, shop, police), and the names do not describe the colour that renders: in game, 0 draws black, 7 red, and 8 green. Place a test blip before relying on any other index for a particular colour.

Library Icon ID Preview
0 1 Map blip library 0 icon 1
0 2 Map blip library 0 icon 2
0 3 Map blip library 0 icon 3
0 4 Map blip library 0 icon 4
0 5 Map blip library 0 icon 5
0 6 Map blip library 0 icon 6
0 7 Map blip library 0 icon 7
0 8 Map blip library 0 icon 8
0 9 Map blip library 0 icon 9
0 10 Map blip library 0 icon 10
0 11 Map blip library 0 icon 11
0 12 Map blip library 0 icon 12
1 0 Map blip library 1 icon 0
2 0 Map blip library 2 icon 0
3 0 Map blip library 3 icon 0
4 0 Map blip library 4 icon 0
5 0 Map blip library 5 icon 0
6 0 Map blip library 6 icon 0
7 0 Map blip library 7 icon 0
8 0 Map blip library 8 icon 0
9 0 Map blip library 9 icon 0
10 0 Map blip library 10 icon 0
11 0 Map blip library 11 icon 0
12 0 Map blip library 12 icon 0
13 0 Map blip library 13 icon 0
14 0 Map blip library 14 icon 0
16 0 Map blip library 16 icon 0
17 0 Map blip library 17 icon 0
18 0 Map blip library 18 icon 0
19 0 Map blip library 19 icon 0
21 0 Map blip library 21 icon 0
22 0 Map blip library 22 icon 0
23 0 Map blip library 23 icon 0
24 0 Map blip library 24 icon 0
25 0 Map blip library 25 icon 0
26 0 Map blip library 26 icon 0