Custom Street Names
Rename HUD street labels by hash, with optional GTA zone aliases.
Custom Street Names
Add aliases in shared/config.lua. The client registers them once when the HUD resource starts. The Orbit HUD displays street names, not zone names. Optional zone aliases change GTA text entries that other interfaces may use. A street alias can also appear in other GTA UI that uses the same text entry.
Config.CustomLocationNames = {
enabled = true,
streets = {
[0x7999837] = "My Road", -- Replace with the street's actual hash
},
zones = {}, -- Optional GTA zone aliases; not shown by the Orbit HUD
}Street keys are numeric street hashes from GetStreetNameAtCoord. Their replacements are the text shown by GetStreetNameFromHashKey. Use the actual hash for the road you intend to rename.
Find a hash
Use the GTA V street and zone hash reference to find a street hash. Its street entries use hexadecimal numbers such as 0x7999837 (Route 68). If the reference is unavailable, you can also check the public street list.
You can confirm a location in-game with a temporary client-side command:
RegisterCommand('streethash', function()
local coords = GetEntityCoords(PlayerPedId())
local streetHash = GetStreetNameAtCoord(coords.x, coords.y, coords.z)
print(('Street: 0x%X'):format(streetHash))
end)Put the numeric hash in square brackets without quotation marks. Remove the temporary command after checking your map.
Optional zone aliases
The Orbit HUD does not display GTA zone names. If another game interface on your server uses GTA's zone text entries, you can also add aliases to zones:
zones = {
AIRP = "LAX Airport", -- Code returned by GetNameOfZone
}Zone keys are uppercase codes from GetNameOfZone, not street hashes. You can find them in the same hash reference or the public zone list. The replacement is used by GTA text lookups such as GetLabelText; it does not add a zone field to the HUD.
Set enabled = false to skip registration entirely. Restart the resource after editing aliases. The Admin HUD can also stage these mappings, but its changes take effect on restart. Each mapping is limited to 512 entries and each replacement to 80 bytes when edited through the Admin HUD.
This feature changes GTA text entries, not street geometry or the road network. Other scripts reading those same game text entries may show the custom name too. Set each alias once at startup; do not call AddTextEntryByHash every frame.