HZ-Television

Overview

HZ-Television turns every interactive screen on your FiveM server into a fully functional Smart TV — including wall-mounted TVs, curved cinema screens, vanilla GTA V huge billboards, and the dashboard of any vehicle via the DashScreen feature. Unlimited simultaneous screens, direct video, HLS streams and images, persistent account with favorites & history, real-time multi-player sync, and a free-cursor raycast interaction mode.

Key Features

  • Unlimited Multi-TV — no more 5-screen cap (removed in v2.3 with the DrawSpritePoly rendering engine). Every nearby TV can play its own content
  • 9 original 3D props streamed with the resource — 3 wall TVs + 3 stand TVs + 3 curved cinema screens. No external packs required
  • DashScreen (v3.2) — mount a Smart TV on any vehicle dashboard via the hz_dashscreen item + in-vehicle keyboard gizmo. 12 texture-isolated variants so every car gets its own independent content
  • Cabin audio occlusion (v3.3) — Web Audio pipeline inside the DUI simulates RAGE's native vehicle sound filtering (lowpass + bass shelf + per-door state)
  • Cylindrical cursor raycast (v3.3) — true ray ↔ cylinder math for pixel-perfect clicks on curved cinema screens. Live preview overlay during /tvcfg
  • SmartTV on billboards & cinema (v3.3) — every screen type runs the same Smart TV UI; render-target auto-detection fixes vanilla GTA V huge billboards
  • Road-placement guard (v3.4) — opt-in red-outline preview blocks placing props on roads. DashScreen in-vehicle placement is exempt
  • Abandon protection (v3.4) — MaxPerPlayer + AutoCleanupDays + /tvclean admin command stop long-running servers from filling up with TVs owned by inactive players
  • Routing bucket aware — TVs and billboards are fully isolated per instance (jails, apartments, jobs, events)
  • Real-time video sync — all players near the same TV see the same frame (5 s heartbeat, 1.5 s drift tolerance, 0.1 s precision, instant seek/play/pause)
  • Account system + personal playlist — login from any TV, save favorites / history / per-user settings, build a looping queue with per-item duration
  • LB Phone companion app (lb-hztelevision) — remote any nearby TV from your phone, silent-mode mute, local-media browser
  • Live /tvcfg calibrator — localized in en/fr/es/de (v3.3), reach distance 25 m for huge billboards

Supported Sources

  • Direct video (MP4 / WebM / OGG / MOV), HLS / M3U8 streams, images (PNG / JPG / GIF), local files, web content

Multi-Framework — Auto Detection

All framework / target / menu / notification / inventory detection is centralized in hz_lib. Configure once there, every Hz-Script inherits.

SystemSupported Options
FrameworkQBCore, QBox, ESX, Standalone
Targetox\_target, qb-target, TextUI mode
Menuox\_lib, qb-menu + qb-input
Notificationsox\_lib, QBCore, ESX, native
Inventoryox\_inventory, qb-inventory, qs-inventory, ps-inventory, codem-inventory, origen\_inventory, core\_inventory, tgiann-inventory
Databaseoxmysql (optional — required for account, playlist, TV persistence, abandon-cleanup)

Performance

MetricValue
Client idle\~0.01 ms
Client — 6 TVs on screen\~0.03 ms (cached DrawSpritePoly)
Server\~0.00 ms
Simultaneous TVsUnlimited (no engine cap since v2.3)
Simultaneous DashScreens / client12 nearest rendered (unlimited placed)

Requirements

  • FiveM server (latest artifacts recommended)
  • hz_lib — latest version required — handles all framework / inventory / target / menu / notification detection. Older versions are missing exports HZ-Television v3.4 depends on, so always update hz_lib when you update HZ-Television
  • HZ-TelevisionProps — downloaded as a separate Keymaster asset alongside HZ-Television, ships the 12 DashScreen prop variants (split in v3.4 so DashScreen asset updates no longer touch the logic resource)
  • ox_lib (recommended) or qb-menu + qb-input
  • oxmysql or mysql-async — required for persistence, accounts, playlist, AutoCleanupDays. HZ-Television auto-detects which one is running (v3.4.1+) and works with both
  • ox_target or qb-target — optional (TextUI fallback available)
  • lb-phone — optional (required for the phone remote app lb-hztelevision)
Always update hz_lib to the latest version alongside HZ-Television. hz_lib is a free shared dependency and every Hz-Script release is tested against the latest Bridge build. Mismatched versions will surface as "export not found" or missing detection at boot.

Need help? Join our Discord and open a ticket in #support.

Quick Navigation

Content responsibility. Server owners are solely responsible for the content they choose to display and for holding the rights or licences required to broadcast it. HZ-Television ships with no media, no source list and no pre-configured destinations. All third-party names, trademarks and logos remain the property of their respective owners. HZ-Scripts develops independent software for the FiveM platform and is not affiliated with, endorsed by or sponsored by Rockstar Games, Take-Two Interactive or Cfx.re.