Installation
Install Orbit DynamicHUD Addons for standalone seatbelt and cruise-control integration.
Orbit DynamicHUD Addons
Orbit DynamicHUD Addons provides standalone seatbelt and cruise-control behavior tailored for DynamicHUD. It uses ox_lib keybinds and locales, publishes client state bags, and can send notifications through DynamicHUD or a custom client function.
GPLv3 open-source resource
This addon is adapted from QBX GPL resources and is distributed under GPLv3. Keep the included license, source availability, and original QBX attribution when modifying or redistributing it.
If your server already has seatbelt or cruise control, you can skip this addon and make the existing resource publish the compatible states documented under Exports and Events.
Dependencies
Required ox_lib and DynamicHUD resources, optional integrations, and start order.
Configuration
Keybinds, seatbelt thresholds, cruise control, harness behavior, and notifications.
Exports and Events
State bags, toggle events, and the deprecated HasHarness compatibility export.
Language Support
Included locales, selection, customization, and adding translations.
Troubleshooting
Resolve startup, keybind, notification, cruise, harness, and HUD state issues.
Installation
- Download or clone orbitstudiossoftware/orbit-dynamichud-addons.
- Stop the server and extract the folder as
orbit-dynamichud-addons. - Install ox_lib and Orbit Dynamic HUD 2.0.
- Review
config.lua, especially enabled systems, keybind defaults, speed thresholds, harness behavior, andConfig.Notify. - Start the addon after ox_lib and DynamicHUD.
- Restart the server or reconnect the test client after changing default keybinds.
ensure ox_lib
ensure orbit-lib
ensure orbit-dynamichud-v2
ensure orbit-dynamichud-addonsResource structure
Normal setup lives in resources/[orbit]/orbit-dynamichud-addons/config.lua. Change keybinds, enable or disable cruise and seatbelt behavior, adjust ejection thresholds, and replace the notification function there. Keep the included GPL license and attribution files with the resource.
Framework setup
No ESX player bridge is required. Keep the DynamicHUD notification function or replace Config.Notify with a client-side ESX notification wrapper.
No QB-Core dependency is required. If an existing harness system owns harness state, make it update LocalPlayer.state.harness instead of running duplicate seatbelt logic.
The addon is adapted from QBX seatbelt and cruise resources, but its normal QBX core requirements were removed. Do not run overlapping QBX seatbelt/cruise resources at the same time.
No framework player data is required. Keep ox_lib started first and configure Config.Notify for whichever client notification interface your server uses.
First-run verification
- Confirm ox_lib, DynamicHUD, and the addon start without errors.
- Enter the driver seat and verify the seatbelt and cruise keybinds appear in FiveM settings.
- Toggle the seatbelt and confirm
LocalPlayer.state.seatbeltand the DynamicHUD indicator update together. - Drive forward in a supported vehicle, toggle cruise, and confirm
LocalPlayer.state.cruiseupdates. - Brake, reverse, leave the driver seat, and change vehicles to verify cruise disables correctly.
- Test buckled, unbuckled, and harness ejection thresholds in a safe test environment.
- Trigger one success and one unavailable notification and verify the active locale text.
Related Orbit resources
- Orbit Dynamic HUD 2.0 displays the seatbelt and cruise states.
- Orbit DynamicHUD Stress can use the seatbelt state when choosing speeding thresholds.
Support
This GPL resource is provided as-is. For reproducible issues, include the client console error, relevant config values, vehicle class, current state-bag values, and clear reproduction steps when reporting through the GitHub repository. Do not remove the included license or original attribution.