Configuration

legends_blips can be configured through either the in-game menu or by directly editing the config/config.json file.

In-Game Management (Recommended)

The easiest way to manage blips is through the in-game menu.

Opening the Menu

Type /manageblips in chat (requires legends_blips.manage permission).

Creating Blips

1. Select "Create New Blip"
2. Choose the blip type:
   • Normal Blip - Always visible on map
   • Area Blip - Shows a radius circle
   • Closest Only Blip - Only shows nearest from category
3. Fill in the details:
   • Blip Name - Display name on map
   • Sprite ID - Icon type (1-826)
   • Color ID - Color (0-85)
   • Scale - Size (0.1-2.0)
4. For Area blips: Set the radius in meters
5. For Closest blips: Enter a category name (e.g., "ATM", "Gas Station")
6. The blip is created at your current location

Managing Existing Blips

1. Select "Manage Existing Blips"
2. Choose a blip from the list
3. Options available:
   • Edit Blip Properties - Modify name, sprite, color, scale
   • Teleport to Blip - Go to the blip's location
   • Delete Blip - Permanently remove the blip

Settings

1. Select "Settings" from the main menu
2. Configure:
   • Update Cooldown - How often closest blips update (5-60 seconds)
   • Debug Mode - Enable/disable console debug output

Manual Configuration (Advanced)

For advanced users, blips can be configured directly in config/config.json.

Configuration File Structure

Location: config/config.json

{
    "EnableDebug": false,
    "updateCooldown": 10000,
    "blips": [],
    "areaBlips": [],
    "closestOnlyBlips": {}
}

Global Settings

EnableDebug

"EnableDebug": false

Description: Controls whether debug messages are shown in the console.

Type: boolean

Default: false

updateCooldown

"updateCooldown": 10000

Description: Time in milliseconds between closest blip distance checks.

Type: number (milliseconds)

Default: 10000 (10 seconds)

Blip Types

Normal Blips

Standard map markers that are always visible.

"blips": [
    {
        "name": "City Hall",
        "coords": [-544.56, -204.32, 38.22],
        "sprite": 419,
        "color": 3,
        "scale": 0.8
    },
    {
        "name": "Airport",
        "coords": [-1037.35, -2963.99, 13.95],
        "sprite": 307,
        "color": 0,
        "scale": 1.0
    }
]

Best for: Unique locations like city hall, airport, hospital, etc.

Area Blips

Blips with a radius circle showing coverage area.

"areaBlips": [
    {
        "name": "Safe Zone",
        "coords": [195.17, -934.58, 30.69],
        "sprite": 1,
        "color": 2,
        "scale": 0.8,
        "radius": 100.0
    },
    {
        "name": "Event Area",
        "coords": [-1600.12, -1012.45, 13.02],
        "sprite": 398,
        "color": 5,
        "scale": 0.9,
        "radius": 250.0
    }
]

Best for: Zones, districts, event areas, safe zones.

Closest Only Blips

Only shows the nearest blip from each category to reduce map clutter.

"closestOnlyBlips": {
    "ATM": [
        {
            "name": "ATM",
            "coords": [149.72, -1040.46, 29.37],
            "sprite": 108,
            "color": 2,
            "scale": 0.6
        },
        {
            "name": "ATM",
            "coords": [-710.17, -818.68, 23.75],
            "sprite": 108,
            "color": 2,
            "scale": 0.6
        }
    ],
    "Gas Station": [
        {
            "name": "Gas Station",
            "coords": [265.65, -1261.84, 29.29],
            "sprite": 361,
            "color": 1,
            "scale": 0.8
        },
        {
            "name": "Gas Station",
            "coords": [-724.62, -935.16, 19.21],
            "sprite": 361,
            "color": 1,
            "scale": 0.8
        }
    ]
}

Best for: Businesses with multiple locations (banks, ATMs, gas stations, stores).

Blip Properties Reference

Common Sprite IDs

For a complete list, see FiveM Blip Sprites (opens in a new tab).

Common Color IDs

Example Full Configuration

{
    "EnableDebug": false,
    "updateCooldown": 10000,
    "blips": [
        {
            "name": "Police Station",
            "coords": [441.82, -982.14, 30.69],
            "sprite": 60,
            "color": 3,
            "scale": 1.0
        }
    ],
    "areaBlips": [
        {
            "name": "Legion Square",
            "coords": [195.17, -934.58, 30.69],
            "sprite": 398,
            "color": 5,
            "scale": 0.8,
            "radius": 50.0
        }
    ],
    "closestOnlyBlips": {
        "24/7 Store": [
            {
                "name": "24/7",
                "coords": [25.73, -1347.32, 29.50],
                "sprite": 52,
                "color": 2,
                "scale": 0.7
            },
            {
                "name": "24/7",
                "coords": [-707.53, -913.52, 19.22],
                "sprite": 52,
                "color": 2,
                "scale": 0.7
            }
        ]
    }
}

Troubleshooting

Blips Not Appearing

1. Enable debug mode: Set "EnableDebug": true
2. Use /refreshblips to reload all blips
3. Check console for error messages
4. Verify JSON syntax is valid

Permission Denied

1. Verify ACE permissions are set in server.cfg
2. Check the identifier format matches your setup
3. Restart the server after adding permissions

Config Errors

Use a JSON validator to check your config file syntax. Common issues:

• Missing commas between array items
• Trailing commas before closing brackets
• Incorrect quote characters (use " not ")

Need Help?

Join our Discord for support: discord.gg/lgnds (opens in a new tab)