Language Support

Orbit DynamicHUD Addons uses the ox_lib locale system. The active locale supplies seatbelt and cruise keybind labels plus success, disabled, and unavailable notifications.

Included Locales

Select A Locale

Set the replicated ox_lib locale before starting the addon.

setr ox:locale en

ensure ox_lib
ensure orbit-dynamichud-v2
ensure orbit-dynamichud-addons

For Turkish, use setr ox:locale tr. Restart the addon after changing the convar or a locale file.

Customize Existing Text

Edit values in the active JSON file while keeping its keys and nesting intact.

{
  "actions": {
    "toggle_cruise_control": "Toggle Cruise Control"
  },
  "success": {
    "cruise_control_enabled": "Cruise control enabled"
  }
}

Add A Language

1. Copy locales/en.json to a new file such as locales/pt.json.
2. Translate values only and preserve every key, nested object, and placeholder.
3. Validate the file as JSON.
4. Set setr ox:locale pt and restart the addon.
5. Test both keybind labels and every cruise success/error notification.

Changing a default keybind label may require the client to reconnect before it appears in FiveM settings. Existing player key overrides remain client-owned.