# Installation (/docs/orbit-studios-resources/orbit-dynamichud-stress)



# Installation [#installation]

`orbit-dynamichud-stress` adds the stress state used by `orbit-dynamichud`. It can increase stress from speeding and weapon usage, reduce stress from custom integrations, and apply blur or ragdoll effects at high stress levels.

<Callout type="warn" title="Required order">
  Start `ox_lib`, `orbit-lib`, and `orbit-dynamichud` before `orbit-dynamichud-stress`.
</Callout>

Use this resource when you want DynamicHUD to manage stress as a replicated player state value. Other resources can read `LocalPlayer.state.stress` on the client or `Player(source).state.stress` on the server.

<Cards>
  <Card title="Dependencies" description="Required DynamicHUD, orbit-lib, ox_lib, and optional seatbelt/inventory integrations." href="/docs/orbit-studios-resources/orbit-dynamichud-stress/dependencies" />

  <Card title="Configuration" description="Speeding, weapon stress, whitelisted jobs, blur intensity, and effect intervals." href="/docs/orbit-studios-resources/orbit-dynamichud-stress/configuration" />

  <Card title="Events" description="Stress initialize, gain, relief, and state-bag usage." href="/docs/orbit-studios-resources/orbit-dynamichud-stress/events" />

  <Card title="Stress Relief Items" description="Examples for ox_inventory, QB usable items, and ESX usable items." href="/docs/orbit-studios-resources/orbit-dynamichud-stress/stress-relief-items" />

  <Card title="Troubleshooting" description="Fix stress display, speed thresholds, whitelisted jobs, and screen effects." href="/docs/orbit-studios-resources/orbit-dynamichud-stress/troubleshooting" />
</Cards>

## File Structure [#file-structure]

<Files>
  <Folder name="resources">
    <Folder name="[orbit]">
      <Folder name="orbit-lib" />

      <Folder name="orbit-dynamichud" />

      <Folder name="orbit-dynamichud-stress">
        <File name="fxmanifest.lua" />

        <File name="config.lua" />

        <File name="client.lua" />

        <File name="server.lua" />
      </Folder>
    </Folder>
  </Folder>
</Files>

## What You Edit [#what-you-edit]

Only the public `config.lua` is needed for normal setup:

<Files>
  <Folder name="orbit-dynamichud-stress">
    <File name="config.lua" />
  </Folder>
</Files>

Use it to change stress gain chance, speeding thresholds, whitelisted jobs, blur strength, ragdoll timing, and weapon exclusions. Use the stress relief items page when you want cigarettes, consumables, or other inventory items to reduce stress.

## Installation [#installation-1]

```properties title="server.cfg"
ensure ox_lib
ensure [framework-resources]
ensure orbit-lib
ensure orbit-dynamichud
ensure orbit-dynamichud-addons
ensure orbit-dynamichud-stress
```

<Callout type="info" title="Seatbelt integration">
  `orbit-dynamichud-stress` reads `LocalPlayer.state.seatbelt` when deciding whether to use the buckled or unbuckled speeding threshold.
</Callout>

If you do not use `orbit-dynamichud-addons`, your own seatbelt resource should set `LocalPlayer.state.seatbelt` to `true` or `false`. Without that state, the stress resource cannot know whether the player is buckled.