HZ Scripts

Installation

Step 1 — Download

HZ-Bridge is a free asset. Download it from the Hz-Scripts shop or your FiveM Keymaster:

  1. Log in to keymaster.fivem.net
  2. Go to Granted Assets
  3. Download HZ-Bridge
HZ-Bridge is required by all Hz-Scripts resources. If you already have it installed, you only need to update it when a new version is released.

Step 2 — Files

  1. Extract the archive
  2. Place the HZ-Bridge folder in your resources/ directory
server/
├── resources/
│   ├── [standalone]/
│   │   ├── HZ-Bridge/
│   │   │   ├── bridge/
│   │   │   ├── modules/
│   │   │   │   ├── callback/
│   │   │   │   ├── dispatch/
│   │   │   │   ├── framework/
│   │   │   │   ├── inventory/
│   │   │   │   ├── menu/
│   │   │   │   ├── minigame/
│   │   │   │   ├── notify/
│   │   │   │   └── target/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua
The folder name must be HZ-Bridge (case-sensitive on Linux servers).

Step 3 — server.cfg

Add HZ-Bridge to your server.cfg before any Hz-Script that depends on it:

# Framework (if applicable)
ensure es_extended

ensure qb-core



HZ-Bridge (before all Hz-Scripts)

ensure HZ-Bridge


Your Hz-Scripts

ensure HZ-Television
ensure HZ-Weather

ensure hz-phone
Startup order is critical! HZ-Bridge must start after your framework but before any Hz-Script that uses it.

Step 4 — Configuration (optional)

Open config.lua to customize detection. By default, everything is set to 'auto' and will work out of the box.

See the Configuration page for all options.

Step 5 — Verify

Start your server and check the console for:

[HZ Bridge] v1.0.0 | Framework: qbcore | Inventory: ox_inventory | Notify: ox_lib | Dispatch: builtin | Target: ox_target | Menu: ox_lib
Done! If you see the detection line with your systems correctly identified, HZ-Bridge is working. All Hz-Scripts will now use it automatically.

Updating

  1. Download the latest version from Keymaster
  2. Replace all files (there is no user config to preserve — config.lua is minimal)
  3. Restart: ensure HZ-Bridge, then restart your Hz-Scripts
HZ-Bridge updates are backward compatible. Your existing Hz-Scripts will continue working after an update.

Troubleshooting

HZ-Bridge doesn't detect my framework
  • Ensure your framework (es_extended, qb-core, qbx_core) is ensured before HZ-Bridge
  • Check the resource name is exact (case-sensitive)
  • If you want to force a framework, set HZBridge.Framework = 'esx' (or 'qbcore', etc.) in config.lua
A script says "HZ-Bridge not found"
  • Verify HZ-Bridge is in your server.cfg with ensure HZ-Bridge
  • Make sure the folder is named exactly HZ-Bridge
  • HZ-Bridge must start before the script that needs it
Wrong system detected

If auto-detection picks the wrong system (e.g., wrong inventory), you can override it in config.lua:

HZBridge.Inventory = 'ox_inventory'  -- Force specific inventory