Installation

Etape 1 — Telechargement

Apres votre achat sur hzscripts.com/shop, votre compte FiveM Keymaster recoit deux assets separes :

1. Connectez-vous sur keymaster.fivem.net (ou portal.cfx.re/assets)
2. Allez dans Granted Assets
3. Telechargez les deux :

Etape 2 — Dependances

Requises

1. HZ-Bridge — asset gratuit depuis hzscripts.com/shop. Gere la detection framework / inventaire / target / menu / notification. Utilisez toujours la derniere version — chaque release de HZ-Television est testee avec la derniere version du Bridge. Doit demarrer avant HZ-Television. Voir Installation HZ-Bridge.
2. HZ-PropsCarplay — telecharge separement depuis Keymaster aux cotes de HZ-Television (voir Etape 1). Streame les 12 variantes de props CarPlay (hz_carplay + hz_carplay_1..11) + leur JSON de calibration. Doit demarrer avant HZ-Television.
3. Un systeme de menu — au moins l'un des suivants :

1. Un driver SQL (requis pour la persistance, les comptes, les playlists, le nettoyage abandon). HZ-Television detecte automatiquement les deux au demarrage :

Optionnelles

• ox\_target ou qb-target — pour l'interaction par viseur (sinon fallback TextUI / DrawText3D)
• lb-phone — requis pour l'application compagnon telephone lb-hztelevision

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

Etape 3 — Fichiers

1. Extrayez les deux archives (HZ-Television.zip et HZ-PropsCarplay.zip) telechargees depuis Keymaster a l'Etape 1
2. Placez les deux dossiers resultants dans votre repertoire resources/ — les regrouper dans un dossier de categorie commun comme [hz-scripts]/ permet de garder les choses ordonnees

server/
├── resources/
│   ├── ox_lib/
│   ├── oxmysql/                    ← ou mysql-async (les deux sont supportes)
│   ├── [hz-scripts]/
│   │   ├── HZ-Bridge/
│   │   ├── HZ-PropsCarplay/        ← 2eme telechargement Keymaster (12 props CarPlay + calibration.json)
│   │   ├── HZ-Television/          ← 1er telechargement Keymaster (le script principal)
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── html/
│   │   │   ├── config.lua
│   │   │   ├── fxmanifest.lua
│   │   │   └── ...

Etape 4 — Items d'inventaire

HZ-Television est livre avec 10 items placables prets a l'emploi. Des definitions d'items pre-configurees pour chaque inventaire supporte se trouvent dans HZ-Television/items/.

Items fournis

Pour ox\_inventory

Ouvrez ox_inventory/data/items.lua et ajoutez le contenu de HZ-Television/items/ox_inventory.txt (10 entrees incluant hz_carplay).

Exemple d'entree :

['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'
    }
},

Pour qb-inventory / qs-inventory / ps-inventory

Copiez le contenu du fichier HZ-Television/items/.txt correspondant dans le fichier d'items de votre inventaire.

Etape 5 — Base de donnees (recommande)

Activez dans config.lua :

Config.Placer = {
    Persistence        = true,   -- les TV + CarPlays places survivent au redemarrage
    MaxPerPlayer       = 0,      -- 0 = illimite, N = limite par identifiant proprietaire
    AutoCleanupDays    = 0,      -- 0 = desactive, N = suppression auto apres N jours d'inactivite
    AutoCleanupInterval = 6,     -- heures entre les cycles de nettoyage (0 = au demarrage uniquement)
    BlockOnRoad        = false,  -- true = bloque le placement de props sur les routes (CarPlay exempt)
    CleanupAdminPermission = 'admin',  -- permission ACE pour /tvclean
}

Les tables suivantes sont creees automatiquement au premier demarrage (toutes utilisent CREATE TABLE IF NOT EXISTS + migrations additives ALTER TABLE ADD COLUMN IF NOT EXISTS) :

• hz_television_placed — TV statiques placees (murales, sur pied, courbees, panneaux)
• hz_carplay_placed — placements CarPlay indexes par plaque de vehicule
• hz_tv_users, hz_tv_sessions, hz_tv_favorites, hz_tv_history, hz_tv_playlists, hz_tv_playlist_items — compte / connexion / favoris / historique / playlists (alimentes lors de la premiere connexion Smart TV)

Installation manuelle (fallback — v3.4.3+)

Si une table ne peut pas etre creee automatiquement (utilisateur MySQL sans permission CREATE, chaine de connexion pointant vers la mauvaise base, etc.), vous verrez une erreur rouge dans la console serveur juste apres [HZ-Television] SQL compat: ... avec le nom exact de la table + l'erreur. Dans ce cas, executez le fichier install.sql fourni manuellement :

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

...ou ouvrez HZ-Television/install.sql dans phpMyAdmin / HeidiSQL / DBeaver et executez-le sur la base de donnees de votre serveur. Puis redemarrez HZ-Television. Le script ne contient que des instructions CREATE TABLE IF NOT EXISTS, donc l'executer deux fois est sans risque.

Etape 6 — server.cfg

Ajoutez les ressources a votre server.cfg dans cet ordre :

# Dependances (doivent demarrer AVANT HZ-Bridge)
ensure oxmysql                # ou ensure mysql-async — HZ-Television supporte les deux
ensure ox_lib                 # ou qb-menu + qb-input
ensure ox_target              # ou qb-target (optionnel)

Framework (si applicable)
ensure qbx_core               # ou ensure qb-core, ou ensure es_extended
ensure qb-core
ensure es_extended

HZ-Scripts — l'ordre compte
ensure HZ-Bridge              # gere la detection automatique
ensure HZ-PropsCarplay        # streame les 12 variantes de props CarPlay (telechargement Keymaster separe)
ensure HZ-Television          # la ressource logique TV

Etape 7 — Configuration

Ouvrez HZ-Television/config.lua et adaptez les parametres. Voir Configuration pour chaque option en detail.

• Config.Locale — 'en' / 'fr' / 'es' / 'de'
• Config.Permissions — qui peut utiliser /tvcfg, placer des TV, utiliser les TV
• Config.Placer.Persistence — true pour activer la sauvegarde en base
• Config.Placer.BlockOnRoad — true si vous voulez bloquer le placement sur les routes
• Config.Placer.MaxPerPlayer + Config.Placer.AutoCleanupDays — protection abandon
• Config.BillboardUseSmartTV — quels modeles de panneaux/cinema doivent utiliser l'interface Smart TV complete (par defaut : les 3 props cinema courbes + 2 grands panneaux vanilla)

Etape 8 — Verification

1. Demarrez le serveur
2. La console devrait afficher (dans l'ordre) :

1. Connectez-vous en jeu
2. Approchez-vous d'un prop TV (TV murale, ecran cinema courbe, ou utilisez l'item hz_carplay dans un vehicule)
3. Selectionnez Power On → Smart TV → collez une URL YouTube

Depannage rapide

[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