Installation
Install Orbit DynamicHUD Stress for speeding stress, weapon stress, state bags, effects, and relief integrations.
Orbit DynamicHUD Stress
Orbit DynamicHUD Stress manages the replicated stress value displayed by DynamicHUD. It can increase stress from speeding and weapon usage, reduce it through custom integrations, and apply blur or ragdoll effects at high stress levels.
Open-source attribution and support
This resource is adapted and isolated from the QBX qbx_hud stress system. Credit remains with the QBX project and contributors, and the resource is provided as-is without official support.
Dependencies
Required DynamicHUD, Orbit Lib, ox_lib, optional seatbelt, and item integrations.
Configuration
Speeding, weapon stress, whitelisted jobs, blur intensity, and effect intervals.
Events
Replicated stress state plus initialize, gain, relief, and direct state integrations.
Stress Relief Items
Implement relief items with ox_inventory, QB usable items, or ESX usable items.
Troubleshooting
Resolve startup, display, thresholds, whitelists, state, and screen effects.
Installation
- Download or clone orbitstudiossoftware/orbit-dynamichud-stress.
- Stop the server and extract the folder as
orbit-dynamichud-stress. - Install ox_lib, Orbit Lib, and Orbit Dynamic HUD 2.0.
- Review the public
config.luafor stress gain, speed units, thresholds, whitelisted jobs, weapon exclusions, and effects. - Start the stress addon after DynamicHUD and after the optional seatbelt state provider.
- Add relief items only after the base stress state initializes and displays correctly.
ensure ox_lib
ensure [framework-resources]
ensure orbit-lib
ensure orbit-dynamichud-v2
# Optional seatbelt state provider.
ensure orbit-dynamichud-addons
ensure orbit-dynamichud-stressResource structure
Use config.lua to change stress gain chance, speeding thresholds, whitelisted jobs, blur strength, effect timing, and weapon exclusions. Use Stress Relief Items when cigarettes, consumables, or other inventory items should reduce stress.
Framework setup
Configure ESX in Orbit Lib. Whitelisted jobs must match the ESX job names returned by the normalized player bridge.
Configure QB-Core in Orbit Lib. Whitelisted jobs must match PlayerData.job.name; state-based stress integrations remain compatible with common QB HUD events.
Configure QBX in Orbit Lib. The stress system is adapted from QBX HUD behavior and uses the same replicated player-state integration style.
Configure Config.Standalone.fetchJob in Orbit Lib when job whitelisting is needed. Otherwise the configured default job is used.
Seatbelt integration
The stress addon reads LocalPlayer.state.seatbelt to choose its buckled or unbuckled speeding threshold. Orbit DynamicHUD Addons publishes this state; another seatbelt resource can publish the same boolean instead.
First-run verification
- Confirm ox_lib, Orbit Lib, DynamicHUD, and the stress addon start without errors.
- Join with a fully loaded character and verify
LocalPlayer.state.stressbecomes a number from0to100. - Confirm DynamicHUD has its stress value enabled and displays the replicated state.
- Test unbuckled and buckled speeding with thresholds temporarily set to safe test values.
- Fire an eligible weapon and verify whitelisted weapons do not add stress.
- Test a whitelisted and non-whitelisted job through
hud:server:GainStress. - Set stress into each configured effect range and tune blur or interval values one range at a time.
- Test one relief integration and confirm stress never falls below
0or rises above100.
Related Orbit resources
- Orbit Dynamic HUD 2.0 displays and reacts to the replicated stress value.
- Orbit DynamicHUD Addons provides the compatible seatbelt state used by speeding thresholds.
- Orbit Lib provides normalized framework and job data.
Support
This resource is provided as-is. For reproducible issues, include the client/server console error, framework, relevant stress config, current stress and seatbelt state values, and exact reproduction steps when reporting through the GitHub repository. Keep the original QBX attribution with redistributed copies.