HZ Scripts

HZ-Television

{% embed url="https://www.youtube.com/watch?v=8FtW4lCHC2E" %}

Presentation

HZ-Television transforme chaque ecran interactif de votre serveur FiveM en une Smart TV entierement fonctionnelle — y compris les TV murales, les ecrans cinema courbes, les grands panneaux d'affichage vanilla GTA V, et le tableau de bord de n'importe quel vehicule via la fonctionnalite CarPlay. Ecrans simultanees illimites, 14 plateformes video, compte persistant avec favoris et historique, synchronisation multi-joueur en temps reel, et un mode d'interaction par curseur libre en raycast.

Fonctionnalites principales

  • Multi-TV illimite — plus de limite a 5 ecrans (supprimee en v2.3 avec le moteur de rendu DrawSpritePoly). Chaque TV a proximite peut diffuser son propre contenu
  • 9 props 3D originaux streames avec la ressource — 3 TV murales + 3 TV sur pied + 3 ecrans cinema courbes. Aucun pack externe requis
  • CarPlay (v3.2) — montez une Smart TV sur le tableau de bord de n'importe quel vehicule via l'item hz_carplay + gizmo clavier en vehicule. 12 variantes a texture isolee pour que chaque voiture ait son propre contenu independant
  • Occlusion audio cabine (v3.3) — pipeline Web Audio dans le DUI simulant le filtrage sonore natif RAGE du vehicule (lowpass + bass shelf + etat par portiere)
  • Raycast cylindrique du curseur (v3.3) — calcul mathematique reel rayon ↔ cylindre pour des clics au pixel pres sur les ecrans cinema courbes. Apercu en temps reel pendant /tvcfg
  • SmartTV sur panneaux d'affichage et cinema (v3.3) — chaque type d'ecran utilise la meme interface Smart TV ; la detection automatique du render target corrige les grands panneaux vanilla GTA V
  • Protection route (v3.4) — apercu avec contour rouge optionnel qui bloque le placement de props sur les routes. Le placement CarPlay en vehicule est exempt
  • Protection abandon (v3.4)MaxPerPlayer + AutoCleanupDays + commande admin /tvclean empechent les serveurs longue duree de se remplir de TV laissees par des joueurs inactifs
  • Compatible routing bucket — les TV et panneaux d'affichage sont entierement isoles par instance (prisons, appartements, jobs, evenements)
  • Synchronisation video temps reel — tous les joueurs pres de la meme TV voient la meme image (heartbeat 5 s, tolerance de derive 1.5 s, precision 0.1 s, seek/play/pause instantane)
  • Systeme de comptes + playlist personnelle — connectez-vous depuis n'importe quelle TV, sauvegardez favoris / historique / parametres par utilisateur, construisez une file d'attente en boucle avec duree par element
  • Application compagnon LB Phone (lb-hztelevision) — controlez n'importe quelle TV a proximite depuis votre telephone, mode streamer muet, navigateur de medias locaux
  • Calibrateur /tvcfg en direct — localise en en/fr/es/de (v3.3), distance d'interaction 25 m pour les grands panneaux d'affichage

Plateformes supportees (14)

  • YouTube (videos + livestreams) · Twitch (SDK natif) · Kick · Bilibili · Rumble · Odysee · Streamable · Facebook Video · Youku
  • Video directe — MP4, WebM, OGG, MOV · Flux M3U8 / HLS · Images (PNG / JPG / GIF)
  • Mode navigateur (n'importe quelle URL) · fallback automatique : URL inconnue → video native → iframe navigateur
Twitch : le volume, le mute, la pause et la lecture sont controles via l'API native Twitch Player.

Multi-Framework — Detection automatique

Toute la detection framework / target / menu / notification / inventaire est centralisee dans HZ-Bridge. Configurez une seule fois la-bas, chaque Hz-Script en herite.

SystemeOptions supportees
FrameworkQBCore, QBox, ESX, Standalone
Targetox\_target, qb-target, mode TextUI
Menuox\_lib, qb-menu + qb-input
Notificationsox\_lib, QBCore, ESX, native
Inventaireox\_inventory, qb-inventory, qs-inventory, ps-inventory, codem-inventory, origen\_inventory, core\_inventory, tgiann-inventory
Base de donneesoxmysql (optionnel — requis pour le compte, la playlist, la persistance TV, le nettoyage abandon)

Performance

MetriqueValeur
Client au repos\~0.01 ms
Client — 6 TV a l'ecran\~0.03 ms (DrawSpritePoly en cache)
Serveur\~0.00 ms
TV simultaneesIllimite (plus de limite moteur depuis v2.3)
CarPlays simultanees / client12 plus proches rendus (placement illimite)

Prerequis

  • Serveur FiveM (derniers artifacts recommandes)
  • HZ-Bridgederniere version requise — gere toute la detection framework / inventaire / target / menu / notification. Les anciennes versions ne disposent pas des exports dont HZ-Television v3.4 depend, mettez donc toujours a jour HZ-Bridge quand vous mettez a jour HZ-Television
  • HZ-PropsCarplaytelecharge comme un asset Keymaster separe aux cotes de HZ-Television, fournit les 12 variantes de props CarPlay (separe en v3.4 pour que les mises a jour des props CarPlay ne touchent plus la ressource logique)
  • ox_lib (recommande) ou qb-menu + qb-input
  • oxmysql ou mysql-async — requis pour la persistance, les comptes, la playlist, AutoCleanupDays. HZ-Television detecte automatiquement lequel est en cours d'execution (v3.4.1+) et fonctionne avec les deux
  • ox_target ou qb-target — optionnel (fallback TextUI disponible)
  • lb-phone — optionnel (requis pour l'application compagnon telephone lb-hztelevision)
Mettez toujours a jour HZ-Bridge vers la derniere version en meme temps que HZ-Television. HZ-Bridge est une dependance partagee gratuite et chaque release Hz-Script est testee avec la derniere build du Bridge. Des versions incompatibles provoqueront des erreurs "export not found" ou une detection manquante au demarrage.

Besoin d'aide ? Rejoignez notre Discord et ouvrez un ticket dans #support.