# Custom Street Names (/docs/orbit-studios-resources/orbit-dynamichud-v2/custom-location-names)



# Custom Street Names [#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.

```lua title="resources/[orbit]/orbit-dynamichud-v2/shared/config.lua"
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 [#find-a-hash]

Use the [GTA V street and zone hash reference](https://github.com/zoxile/gtav-street-zone-hashes) 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](https://github.com/jgscripts/gtav-street-zone-hashes/blob/main/streets.txt).

You can confirm a location in-game with a temporary **client-side** command:

```lua
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 [#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`:

```lua
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](https://github.com/zoxile/gtav-street-zone-hashes) or the [public zone list](https://github.com/jgscripts/gtav-street-zone-hashes/blob/main/zones.txt). 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.
