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-Bridge — 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-Bridge Installation.
2. HZ-PropsCarplay — downloaded separately from Keymaster alongside HZ-Television (see Step 1). Streams the 12 CarPlay prop variants (hz_carplay + hz_carplay_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-PropsCarplay.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-Bridge/
│   │   ├── HZ-PropsCarplay/        ← 2nd Keymaster download (12 carplay 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_carplay).

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_carplay'] = {
    label = 'CarPlay 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/.txt file into your inventory's items file.

Step 5 — Database (recommended)

Enable in config.lua:

Config.Placer = {
    Persistence        = true,   -- placed TVs + CarPlays 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 (CarPlay 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_carplay_placed — CarPlay 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-Bridge)
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-Bridge              # handles auto-detection
ensure HZ-PropsCarplay        # streams the 12 carplay 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_carplay item in a vehicle)
3. Select Power On → Smart TV → paste a YouTube 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