# Dependencies (/docs/orbit-studios-resources/orbit-dynamichud-v2/dependencies)



# Dependencies [#dependencies]

## Required [#required]

| Dependency          | Why it is needed                                                              | Link                                                                             |
| ------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `ox_lib`            | Cache helpers, locales, callbacks, keybinds, commands, and runtime utilities. | [overextended/ox\_lib](https://github.com/overextended/ox_lib)                   |
| `orbit-lib`         | Normalized framework player/inventory data and Orbit resource integration.    | [orbit-lib docs](/docs/orbit-studios-resources/orbit-lib)                        |
| Supported framework | ESX, QB-Core, QBX, or the configured standalone adapter in `orbit-lib`.       | [orbit-lib configuration](/docs/orbit-studios-resources/orbit-lib/configuration) |

## Required for Settings Share [#required-for-settings-share]

| Dependency | Why it is needed                                                             | Link                                                            |
| ---------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------- |
| `oxmysql`  | Stores presets, likes, downloads, ownership, moderation state, and metadata. | [overextended/oxmysql](https://github.com/overextended/oxmysql) |

Settings Share is enabled by default. If it remains enabled, `oxmysql` must start before DynamicHUD 2.0 and its Lua library must be loaded in the manifest.

```lua title="fxmanifest.lua"
dependency 'oxmysql'
server_script '@oxmysql/lib/MySQL.lua'
```

## Optional integrations [#optional-integrations]

| Dependency                | Feature                                                                                            |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| `screenshot-basic`        | One supported Settings Share capture provider. Install it only when selected in `captureProvider`. |
| `screencapture`           | Alternative Settings Share capture provider. Install it only when selected in `captureProvider`.   |
| FiveManage API key        | Hosts uploaded preset screenshots through a server-requested presigned URL.                        |
| `orbit-dynamichud-addons` | Orbit seatbelt and cruise-control integration.                                                     |
| `orbit-dynamichud-stress` | Replicated stress gain, relief, and effects.                                                       |
| `pma-voice`               | Voice/radio state on servers using pma-voice.                                                      |
| Supported inventory       | Inventory-backed ammo, item counts, and inventory-open state.                                      |
| Custom fuel resource      | Fuel values through `Config.GetVehicleFuelLevel`.                                                  |

See [Settings Sharing](/docs/orbit-studios-resources/orbit-dynamichud-v2/settings-sharing#thumbnail-capture) before enabling screenshots, then follow [FiveManage Setup](/docs/orbit-studios-resources/orbit-dynamichud-v2/fivemanage) to create and secure the API key. Keep the key in a server convar, never in shared/client code.

## Start order [#start-order]

```properties title="server.cfg"
ensure ox_lib
ensure oxmysql
ensure [framework-resources]
ensure [inventory]
ensure orbit-lib

# Only required when preset screenshots are enabled. Start the provider
# selected by Config.SettingsShareServer.thumbnail.captureProvider.
ensure screencapture
# ensure screenshot-basic

ensure orbit-dynamichud-v2

# Optional integrations
ensure orbit-dynamichud-addons
ensure orbit-dynamichud-stress
```

The selected framework must be available before `orbit-lib`. Start optional state providers after the base HUD unless their own documentation requires otherwise.

## Feature failure behavior [#feature-failure-behavior]

* Missing `ox_lib` callbacks prevent Settings Share initialization.
* Missing `oxmysql` prevents Settings Share initialization but should not be treated as a valid production setup when the feature is enabled.
* A missing/mismatched capture provider or missing API credentials disables custom screenshot capture; preset uploads can continue with fallback previews.
* Setting `music.onlyLocalMusic = true` avoids all server-side dynamic-sound work and does not need an external audio resource.