
Advanced Custom Blips v4.0.0
Permissions / License
Do NOT re-upload this mod to any other site.
Do NOT sell, bundle, or include this mod in paid content.
You may share your own custom INI/JSON files as long as they require this mod to work.
Please always link back to the official mod page when sharing INI/JSON files.
If you enjoy this mod, consider supporting me — even $1 helps!
PayPal: Soliman@dapoupharma.com
---
Table of Contents:
1. Description
2. Features
3. Requirements
4. Installation
5. Known Bugs & Mod Conflicts
6. FAQs
7. Changelog
8. Credits
1. Description
Advanced Custom Blips lets you add and manage custom map blips exactly the way you want. The mod features an on-screen icon selection, a preview blip in front of the player, and 10+ editable properties for blip including name, group, icon, color, size, transparency and much more. You can load Addon Blips mod config blips with a single button (see the "FAQ" section to learn more). Create, edit, teleport, copy, and manage custom blips entirely using LemonUI menu. All blip data and settings are now stored in JSON format (with automatic migration from older INI files), allowing full naming freedom for blips and groups, support for decimal coordinates, and seamless update checking. Predefined locations for gas stations, fire departments, police departments, markets, medical centers, ATMs, and metro stations are included. Each category can be toggled individually via the in-game LemonUI menu (all categories are off by default).
Hotkeys (Configurable):
Toggle Coordinates Key:
Function: Toggles the on-screen display of the player's current coordinates (X, Y, Z).
Default Key: F1
Reload Blips Key:
Function: Reloads the script.
Default Key: F2
Toggle Blip Visibility Key:
Function: Hides or shows all the custom blips that have been loaded from the JSON file on the map.
Default Key: F3
Open Menu Key:
Function: Opens the main LemonUI menu for the script, allowing access to settings, adding blips, and managing existing ones.
Default Key: F10
Useful Notes:
When adding a new blip in "Add New Blip" menu, leaving the Size/Scale field empty will automatically use the default blip size (1.0). Similarly leaving the X, Y, and Z fields empty will automatically use your current player coordinates. Same can be said for Flash Interval (100)
In "Global Settings" menu when choosing key, you can either scroll through the list or press Enter then press the key you want to assign
When choosing an icon from on-screen, make sure to click as much as possible at the center of the icon to select it
When choosing the icon or color in "Add New Blip" menu or edit blip menu, you can type icon/color names or IDs directly (Icon reference here) (Color reference here)
Important:
The full list of the 800+ blip icons are not shown on the screen, what is shown on screen are some not all, to see all available blip icons either scroll through the icon list or select it then type icon name or ID directly (reference here)
There are some blips that are not clickable because I could not find its ID
Flash Interval has no effect if Flashing State is not enabled
This script has only been tested on the Legacy version of GTA V. I cannot guarantee its functionality on the Enhanced version of GTA V (it may or may not work as intended), as it was not tested there and won't get tested by me
The "Manage Existing Blips" menu has not been fully tested yet. If you encounter any bugs, errors, or weird/unintended behavior, please report them
Don’t hesitate to suggest features, improvements, bug, or anything else about this script mod. I’ll be more than happy to read your suggestions
2. Features
LemonUI menu for adding, editing, copying, deleting, and teleporting to custom blips in-game
10+ editable properties for custom blips
Real-time preview of the blip in front of your player before saving
On-screen icon selection with a color preview
Support for Addon Blips — you can now seamlessly load their TXT blip files
800+ available blip icons
80+ available blip colors
Configurable hotkeys (display coordinates, reload blips, open menu, and toggle visibility of custom blips)
Predefined locations for gas stations, fire departments, police departments, markets, medical centers, ATMs, and metro stations. Each category can be toggled on or off individually via the in-game LemonUI menu (all categories are disabled by default).
Group system for organizing blips in the "Manage Existing Blips" menu for easier custom blip management
JSON-based storage system (automatic migration from INI with backup support for older versions of the script)
Lightweight — the script is optimized for performance
3. Requirements
Grand Theft Auto V Legacy (as mentioned above)
Script Hook V
Script Hook V .NET (nightly)
.NET Framework 4.8
LemonUI
4. Installation
Ensure that Script Hook V, Script Hook V .NET (nightly), .NET Framework 4.8, and LemonUI are properly installed
Extract all files into your "scripts" folder (create it if missing, using the exact same name) in your GTA V Legacy directory
Add blips via the in-game menu (open menu with the F10 key)
5. Known Bugs & Mod Conflicts
When opening the "Manage Existing Blips" menu while a large number of blips exist (e.g., 100+), the game may freeze for 3–4 seconds. Why does this happen? Because for each group, the script creates a menu containing all blips within that group. Additionally, for every blip item inside the group menu, the script creates another submenu with 14 event handlers. Good news: A fix is currently in development for a future update to make this process smoother and more optimized.
6. FAQs
Q: I found a bug(s) and/or mod conflict(s). How can I report it?
A: Contact me directly through the mod’s page (officially on the GTA5Mods website) and include the contents of "Advanced Custom Blips Log.txt".
Q: Can I add blips manually?
A: Technically you can, but it is much harder because of the JSON format and that the script itself as of v4.0.0 doesn't support anything except the index number for color and icon items.
Q: Can I use custom-made textures/icons?
A: No, only built-in GTA V Legacy blip icons are supported.
Q: Will you add support for Enhanced version of GTA V?
A: As discussed, it may or may not work — it has not been tested there and won't get tested by me. But if many users report that it does work as intended, I will update the mod page to confirm it is functioning on this version.
Q: Does this mod affect performance (FPS)?
A: Only the moment when opening the "Manage Existing Blips" menu, else no impact. Refer to "Known Bugs & Mod Conflicts" section for more information. Feel free to report any performance issues.
Q: How to disable a key (e.g., menu key, reload key, coordinates display key, and etc.)?
A: You can disable keys in two ways:
In-game menu: Open the menu using F10, go to Global Settings, and find the key you wish to disable.
Scroll through the list until it shows "None", then select and press Save Changes.
Via JSON file: Open "Advanced Custom Blips Settings.json" then find the key you want to disable and replace its value with "None".
Q: How to add custom blips from "Addon Blips" mod to this mod?
A: Step 1: Place the "Addon Blips" folder (the folder that contains the mod's .txt blip files) in scripts folder.
Step 2: Open the in-game menu (default F10) → go to Global Settings → check "Enable Add-On blips" → press Save. The Addon Blips will be loaded automatically at script startup.
Important notes:
You do NOT need the full Addon Blips mod installed — only its folder and .txt files are required.
Unchecking the option and saving removes those blips from Advanced Custom Blips.json only; the original .txt files in the Addon Blips folder are left untouched.
Q: What does the "Group" field do? Is it the same as the in-game blip categories (like Ammu-Nation, Tennis, etc.)? Why don’t blips appear grouped on the main map even though they are in the same group?
A: The “Group” field is only for organizing blips in the in-game LemonUI menu. It does not change how blips appear on the main map or create any new in-game categories. Think of it as a folder or label to help you manage many custom blips more easily. You can freely name groups anything you like — it’s purely for your convenience in the menu.
7. Changelog
v4.0.0 – Robust & Optimized for Performance
Added: Automatic handling of the "Access Denied" error
Added: Full backward compatibility — existing INI files automatically migrate to JSON on first launch (a backup is saved as Advanced Custom Blips.ini.backup)
Added: Transparency field for blip properties, allowing control over how transparent a blip is
Added: Group field for blips to make them easier to manage in the "Manage Existing Blips" menu
Added: Ability to type icon/color names or IDs directly (not just scroll through lists in the "Add New Blip" and edit blip menus)
Added: Automatic and manual update checker
Added: Reset to Defaults button in the "Global Settings" menu that restores all options to their default values
Improved: Significantly improved the performance and smoothness of the script
Improved: Switched from INI to JSON format
Improved: Complete naming freedom — both blip and group names can now contain ANY characters (underscores, spaces, special symbols, empty names, whitespace — no more restrictions, thanks to JSON)
Improved: Clarified all script messages and item descriptions
Improved: From version 4.0.0 and beyond, the script follows Semantic Versioning
Improved: X, Y, and Z fields in the "Add New Blip" menu now behave as follows: Uses the provided coordinates if all are present and valid. Fills in only missing coordinates (X, Y, or Z) using the player’s current position. Falls back entirely to the player’s position if the provided coordinates are invalid. Stops execution if a valid player cannot be obtained.
Improved: Normalized both "." (dot) and "," (comma) as decimal separators — the script no longer differentiates between them; use whichever you prefer
Improved: Preview blip now updates its position with the player
Improved: Enhanced key assignment visuals in the "Global Settings" menu
Improved: Reworked the "Manage Existing Blips" menu — it now lists all groups first; each group contains its blips, and each blip includes its own edit menu
Improved: Support for decimal numbers in Add-On blips .txt files
Improved: Settings are now stored in a dedicated file called "Advanced Custom Blips Settings.json"
Fixed: Flash interval having no effect on blips
Fixed: Color mismatch for on-screen icons (Colors 6, 7, and 38)
Fixed: "Save Changes" button in the "Global Settings" menu incorrectly saving keys to the INI file, which disabled menu interactions
Fixed: Coordinates display system randomly stopping or not appearing at all
Fixed: Color field in the "Edit (blip name)" menu
Fixed: DirectoryNotFoundException error when loading Add-On blips if the directory does not exist
Fixed: 1–2 seconds of freezing when enabling or disabling category blips
Fixed: Custom blip names disappearing
Fixed: Disappearing vanilla blips when a large number of custom blips exist
Removed: Flash and flash interval effects from the preview blip
Removed: Saving actual names of blip icons/colors in INI files (not just IDs). JSON is stricter; manual editing will return in future updates
Removed: Teleport menu
v3.0 – Improved
Added: On-screen icons selection with preview of their color
Added: Support for "Addon Blips" txt files
Added: More blips
Improved: Upgraded to LemonUI menu
Fixed: Flickering of the menu
Fixed: Blip name in "Edit (blip name)" menu
Fixed: Mismatch between blip icon ID and blip icon name
v2.0 – Major Overhaul
Added: Full NativeUI in-game menu (add, edit, copy, delete, and teleport to custom blips)
Added: Real-time preview blip in front of player
Added: Configurable hotkeys (reload, toggle visibility, open menu, and show coordinates)
Added: Predefined locations of gas stations, fire departments, police departments, markets, medical centers, ATMs, and metro stations. Each category can be toggled on or off individually via the in-game NativeUI menu (all categories are toggled off by default)
Added: Save actual names of Blip Icons/Colors in INI (not just IDs). Useful for manual editing users
Improved: Error handling & coordinate display system
v1.0 – Initial Release
Basic INI-based blip creation

