Installation

Étape 1 — Téléchargement

Après votre achat sur hzscripts.com/shop, votre compte FiveM Keymaster reçoit deux assets séparés :

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

Étape 2 — Dépendances

Requises

1. hz_lib — asset gratuit depuis hzscripts.com/shop. Gère la détection framework / inventaire / target / menu / notification. Utilisez toujours la dernière version — chaque release de HZ-Television est testée avec la dernière version du Bridge. Doit démarrer avant HZ-Television. Voir Installation hz_lib.
2. HZ-TelevisionProps — téléchargé séparément depuis Keymaster aux cotes de HZ-Television (voir Étape 1). Streame les 12 variantes de props DashScreen (hz_dashscreen + hz_dashscreen_1..11) + leur JSON de calibration. Doit démarrer avant HZ-Television.
3. Un système 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 détecté automatiquement les deux au démarrage :

Optionnelles

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

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

Étape 3 — Fichiers

1. Extrayez les deux archives (hz_television.zip et hz_televisionprops.zip) téléchargées depuis Keymaster à l'Étape 1
2. Placez les deux dossiers résultants dans votre répertoire resources/ — les regrouper dans un dossier de catégorie commun comme [hz-scripts]/ permet de garder les choses ordonnées

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

Étape 4 — Items d'inventaire

HZ-Television est livré avec 10 items placables prêts à l'emploi. Des définitions 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 entrées incluant hz_dashscreen).

Exemple d'entrée :

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

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

Copiez le contenu du fichier hz_television/items/<inventory>.txt correspondant dans le fichier d'items de votre inventaire.

Étape 5 — Base de données (recommandé)

Activez dans config.lua :

Config.Placer = {
    Persistence        = true,   -- les TV + DashScreens 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 (DashScreen exempt)
    CleanupAdminPermission = 'admin',  -- permission ACE pour /tvclean
}

Les tables suivantes sont créées automatiquement au premier démarrage (toutes utilisent CREATE TABLE IF NOT EXISTS + migrations additives ALTER TABLE ADD COLUMN IF NOT EXISTS) :

• hz_television_placed — TV statiques placées (murales, sur pied, courbées, panneaux)
• hz_dashscreen_placed — placements DashScreen indexes par plaque de véhicule
• 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 première connexion Smart TV)

Installation manuelle (fallback — v3.4.3+)

Si une table ne peut pas être créée automatiquement (utilisateur MySQL sans permission CREATE, chaîne de connexion pointant vers la mauvaise base, etc.), vous verrez une erreur rouge dans la console serveur juste après [hz_television] SQL compat: ... avec le nom exact de la table + l'erreur. Dans ce cas, exécutez 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 données de votre serveur. Puis redémarrez hz_television. Le script ne contient que des instructions CREATE TABLE IF NOT EXISTS, donc l'exécuter deux fois est sans risque.

Étape 6 — server.cfg

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

# Dependances (doivent demarrer AVANT hz_lib)
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_lib              # gere la detection automatique
ensure hz_televisionprops        # streame les 12 variantes de props DashScreen (telechargement Keymaster separe)
ensure hz_television          # la ressource logique TV

Étape 7 — Configuration

Ouvrez hz_television/config.lua et adaptez les paramètres. Voir Configuration pour chaque option en détail.

• 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 modèles de panneaux/cinema doivent utiliser l'interface Smart TV complète (par défaut : les 3 props cinéma courbes + 2 grands panneaux vanilla)

Étape 8 — Vérification

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

1. Connectez-vous en jeu
2. Approchez-vous d'un prop TV (TV murale, écran cinéma courbe, ou utilisez l'item hz_dashscreen dans un véhicule)
3. Sélectionnez Power On → Smart TV → collez une URL vidéo

Dépannage 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