Installation

Step 1 — Download

After your purchase on hzscripts.com/shop, your FiveM Keymaster account receives two separate assets:

1. Log in to keymaster.fivem.net (or portal.cfx.re/assets)
2. Go to Granted Assets
3. Download both:

Step 2 — Dependencies

Required

1. hz_lib — free asset from hzscripts.com/shop. Handles framework / inventory / target / menu / notification detection. Always use the latest version — every HZ-Television release is tested against the latest Bridge. Must start before HZ-Television. See hz_lib Installation.
2. HZ-TelevisionProps — downloaded separately from Keymaster alongside HZ-Television (see Step 1). Streams the 12 DashScreen prop variants (hz_dashscreen + hz_dashscreen_1..11) + their calibration JSON. Must start before HZ-Television.
3. A menu system — at least one of:

1. A SQL driver (required for persistence, accounts, playlists, abandon cleanup). HZ-Television auto-detects both at runtime:

Optional

• ox\_target or qb-target — for crosshair-based interaction (otherwise TextUI / DrawText3D fallback)
• lb-phone — required for the phone companion app lb-hztelevision

[hz_television] SQL compat: detected oxmysql, MySQL.Async shim installed
[hz_television] SQL compat: detected existing MySQL.Async (mysql-async or compatible)

Step 3 — Files

1. Extract both archives (hz_television.zip and hz_televisionprops.zip) downloaded from Keymaster in Step 1
2. Place the two resulting folders in your resources/ directory — grouping them under a common category folder like [hz-scripts]/ keeps things tidy

server/
├── resources/
│   ├── ox_lib/
│   ├── oxmysql/                    ← or mysql-async (both supported)
│   ├── [hz-scripts]/
│   │   ├── hz_lib/
│   │   ├── hz_televisionprops/        ← 2nd Keymaster download (12 dashscreen props + calibration.json)
│   │   ├── hz_television/          ← 1st Keymaster download (the main script)
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── html/
│   │   │   ├── config.lua
│   │   │   ├── fxmanifest.lua
│   │   │   └── ...

Step 4 — Inventory Items

HZ-Television ships 10 placeable items out of the box. Pre-configured item definitions for every supported inventory are in hz_television/items/.

Items shipped

For ox\_inventory

Open ox_inventory/data/items.lua and append the content of hz_television/items/ox_inventory.txt (10 entries including hz_dashscreen).

Example entry:

['hz_tv_m'] = {
    label = 'Smart TV (Medium)',
    weight = 12000,
    stack = true,
    close = true,
    description = 'A medium wall-mounted smart TV',
    client = {
        event = 'hz_television:useItem'
    }
},
['hz_dashscreen'] = {
    label = 'DashScreen Screen',
    weight = 3000,
    stack = true,
    close = true,
    description = 'Dashboard Smart TV — use while sitting in a vehicle',
    client = {
        event = 'hz_television:useItem'
    }
},

For qb-inventory / qs-inventory / ps-inventory

Copy the content of the matching hz_television/items/<inventory>.txt file into your inventory's items file.

Step 5 — Database (recommended)

Enable in config.lua:

Config.Placer = {
    Persistence        = true,   -- placed TVs + DashScreens survive restart
    MaxPerPlayer       = 0,      -- 0 = unlimited, N = cap per owner identifier
    AutoCleanupDays    = 0,      -- 0 = disabled, N = auto-remove after N days inactive
    AutoCleanupInterval = 6,     -- hours between cleanup ticks (0 = startup only)
    BlockOnRoad        = false,  -- true = block placing props on roads (DashScreen exempt)
    CleanupAdminPermission = 'admin',  -- ACE perm for /tvclean
}

The following tables are created automatically on first startup (all use CREATE TABLE IF NOT EXISTS + additive ALTER TABLE ADD COLUMN IF NOT EXISTS migrations):

• hz_television_placed — static placed TVs (walls, floors, curved, billboards)
• hz_dashscreen_placed — DashScreen placements keyed by vehicle plate
• hz_tv_users, hz_tv_sessions, hz_tv_favorites, hz_tv_history, hz_tv_playlists, hz_tv_playlist_items — account / login / favorites / history / playlists (populated on first Smart TV login)

Manual install (fallback — v3.4.3+)

If a table fails to create automatically (MySQL user missing CREATE permission, connection string pointing at the wrong database, etc.), you'll see a red error in the server console right after [hz_television] SQL compat: ... with the exact table name + error. In that case, run the bundled install.sql manually:

mysql -u <user> -p <database> < resources/[standalone]/hz_television/install.sql

…or open hz_television/install.sql in phpMyAdmin / HeidiSQL / DBeaver and execute it against your server's database. Then restart hz_television. The script only contains CREATE TABLE IF NOT EXISTS statements, so running it twice is safe.

Step 6 — server.cfg

Add the resources to your server.cfg in this order:

# Dependencies (must start BEFORE hz_lib)
ensure oxmysql                # or `ensure mysql-async` — HZ-Television supports both
ensure ox_lib                 # or qb-menu + qb-input
ensure ox_target              # or qb-target (optional)

# Framework (if applicable)
ensure qbx_core               # or ensure qb-core, or ensure es_extended
# ensure qb-core
# ensure es_extended

# HZ-Scripts — order matters
ensure hz_lib              # handles auto-detection
ensure hz_televisionprops        # streams the 12 dashscreen prop variants (separate Keymaster download)
ensure hz_television          # the TV logic resource

Step 7 — Configuration

Open hz_television/config.lua and adapt the settings. See Configuration for every option in detail.

• Config.Locale — 'en' / 'fr' / 'es' / 'de'
• Config.Permissions — who can use /tvcfg, place TVs, use TVs
• Config.Placer.Persistence — true to enable DB saving
• Config.Placer.BlockOnRoad — true if you want to block road placement
• Config.Placer.MaxPerPlayer + Config.Placer.AutoCleanupDays — abandon protection
• Config.BillboardUseSmartTV — which billboard/cinema models should run the full Smart TV UI (default: the 3 curved cinema props + 2 vanilla huge billboards)

Step 8 — Verification

1. Start the server
2. Console should show (in order):

1. Connect in-game
2. Approach any TV prop (wall TV, curved cinema screen, or use the hz_dashscreen item in a vehicle)
3. Select Power On → Smart TV → paste a video URL

Quick Troubleshooting

[hz_television] SQL compat: detected oxmysql, MySQL.Async shim installed
[hz_television] SQL compat: detected existing MySQL.Async (mysql-async or compatible)
[hz_television] ERROR: no SQL resource detected (oxmysql or mysql-async)

[hz_television] CREATE TABLE hz_tv_sessions FAILED: <error>
[hz_television] Import hz_television/install.sql manually to create the missing tables.

mysql -u <user> -p <database> < resources/[standalone]/hz_television/install.sql