Instalación

Paso 1 — Descarga

Tras su compra en hzscripts.com/shop, su cuenta FiveM Keymaster recibe dos assets separados:

1. Inicie sesión en keymaster.fivem.net (o portal.cfx.re/assets)
2. Vaya a Granted Assets
3. Descargue ambos:

Paso 2 — Dependencias

Requeridas

1. hz_lib — asset gratuito desde hzscripts.com/shop. Gestiona la detección de framework / inventario / target / menú / notificación. Utilice siempre la última versión — cada release de HZ-Television se prueba con la última versión del Bridge. Debe iniciarse antes de HZ-Television. Vea Instalación hz_lib.
2. HZ-TelevisionProps — descargado por separado desde Keymaster junto con HZ-Television (vea Paso 1). Transmite las 12 variantes de props DashScreen (hz_dashscreen + hz_dashscreen_1..11) + su JSON de calibración. Debe iniciarse antes de HZ-Television.
3. Un sistema de menú — al menos uno de los siguientes:

1. Un driver SQL (requerido para la persistencia, cuentas, playlists, limpieza de abandono). HZ-Television detecta automáticamente ambos al inicio:

Opcionales

• ox\_target o qb-target — para la interacción por mira (de lo contrario fallback TextUI / DrawText3D)
• lb-phone — requerido para la aplicación compañera de teléfono lb-hztelevision

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

Paso 3 — Archivos

1. Extraiga ambos archivos (hz_television.zip y hz_televisionprops.zip) descargados desde Keymaster en el Paso 1
2. Coloque ambas carpetas resultantes en su directorio resources/ — agruparlas en una carpeta de categoría común como [hz-scripts]/ permite mantener todo ordenado

server/
├── resources/
│   ├── ox_lib/
│   ├── oxmysql/                    ← o mysql-async (ambos estan soportados)
│   ├── [hz-scripts]/
│   │   ├── hz_lib/
│   │   ├── hz_televisionprops/        ← 2da descarga Keymaster (12 props DashScreen + calibration.json)
│   │   ├── hz_television/          ← 1ra descarga Keymaster (el script principal)
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── html/
│   │   │   ├── config.lua
│   │   │   ├── fxmanifest.lua
│   │   │   └── ...

Paso 4 — Items de inventario

HZ-Television viene con 10 items colocables listos para usar. Definiciones de items pre-configuradas para cada inventario soportado se encuentran en hz_television/items/.

Items incluidos

Para ox\_inventory

Abra ox_inventory/data/items.lua y agregue el contenido de hz_television/items/ox_inventory.txt (10 entradas incluyendo hz_dashscreen).

Ejemplo de entrada:

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

Para qb-inventory / qs-inventory / ps-inventory

Copie el contenido del archivo hz_television/items/<inventory>.txt correspondiente en el archivo de items de su inventario.

Paso 5 — Base de datos (recomendado)

Active en config.lua:

Config.Placer = {
    Persistence        = true,   -- las TV + DashScreens colocados sobreviven al reinicio
    MaxPerPlayer       = 0,      -- 0 = ilimitado, N = limite por identificador de propietario
    AutoCleanupDays    = 0,      -- 0 = desactivado, N = eliminacion automatica despues de N dias de inactividad
    AutoCleanupInterval = 6,     -- horas entre los ciclos de limpieza (0 = solo al inicio)
    BlockOnRoad        = false,  -- true = bloquea la colocacion de props en carreteras (DashScreen exento)
    CleanupAdminPermission = 'admin',  -- permiso ACE para /tvclean
}

Las siguientes tablas se crean automáticamente en el primer inicio (todas utilizan CREATE TABLE IF NOT EXISTS + migraciones aditivas ALTER TABLE ADD COLUMN IF NOT EXISTS):

• hz_television_placed — TV estáticas colocadas (murales, con soporte, curvas, vallas)
• hz_dashscreen_placed — colocaciones DashScreen indexadas por placa de vehículo
• hz_tv_users, hz_tv_sessions, hz_tv_favorites, hz_tv_history, hz_tv_playlists, hz_tv_playlist_items — cuenta / inicio de sesión / favoritos / historial / playlists (poblados en el primer inicio de sesión Smart TV)

Instalación manual (fallback — v3.4.3+)

Si una tabla no puede crearse automáticamente (usuario MySQL sin permiso CREATE, cadena de conexión apuntando a la base incorrecta, etc.), verá un error rojo en la consola del servidor justo después de [hz_television] SQL compat: ... con el nombre exacto de la tabla + el error. En ese caso, ejecute el archivo install.sql proporcionado manualmente:

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

...o abra hz_television/install.sql en phpMyAdmin / HeidiSQL / DBeaver y ejecútelo en la base de datos de su servidor. Luego reinicie hz_television. El script solo contiene instrucciones CREATE TABLE IF NOT EXISTS, por lo que ejecutarlo dos veces es seguro.

Paso 6 — server.cfg

Agregue los recursos a su server.cfg en este orden:

# Dependencias (deben iniciarse ANTES de hz_lib)
ensure oxmysql                # o `ensure mysql-async` — HZ-Television soporta ambos
ensure ox_lib                 # o qb-menu + qb-input
ensure ox_target              # o qb-target (opcional)

# Framework (si corresponde)
ensure qbx_core               # o ensure qb-core, o ensure es_extended
# ensure qb-core
# ensure es_extended

# HZ-Scripts — el orden importa
ensure hz_lib              # gestiona la deteccion automatica
ensure hz_televisionprops        # transmite las 12 variantes de props DashScreen (descarga Keymaster separada)
ensure hz_television          # el recurso logico TV

Paso 7 — Configuración

Abra hz_television/config.lua y adapte los parámetros. Vea Configuración para cada opción en detalle.

• Config.Locale — 'en' / 'fr' / 'es' / 'de'
• Config.Permissions — quien puede usar /tvcfg, colocar TV, usar las TV
• Config.Placer.Persistence — true para activar el guardado en base de datos
• Config.Placer.BlockOnRoad — true si quiere bloquear la colocación en carreteras
• Config.Placer.MaxPerPlayer + Config.Placer.AutoCleanupDays — protección de abandono
• Config.BillboardUseSmartTV — que modelos de vallas/cine deben usar la interfaz Smart TV completa (por defecto: los 3 props de cine curvo + 2 grandes vallas vanilla)

Paso 8 — Verificación

1. Inicie el servidor
2. La consola debería mostrar (en orden):

1. Conectese al juego
2. Acérquese a un prop TV (TV mural, pantalla de cine curva, o utilice el item hz_dashscreen en un vehículo)
3. Seleccione Power On → Smart TV → pegue una URL de vídeo

Solución rápida de problemas

[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