Instalacao

Etapa 1 — Download

Apos sua compra em hzscripts.com/shop, sua conta FiveM Keymaster recebe dois assets separados:

1. Faca login em keymaster.fivem.net (ou portal.cfx.re/assets)
2. Va em Granted Assets
3. Baixe os dois:

Etapa 2 — Dependencias

Obrigatorias

1. hz_lib — asset gratuito em hzscripts.com/shop. Gerencia a deteccao de framework / inventario / target / menu / notificacao. Use sempre a versao mais recente — cada release do HZ-Television e testada com a versao mais recente do Bridge. Deve iniciar antes do HZ-Television. Veja Instalacao hz_lib.
2. HZ-TelevisionProps — baixado separadamente do Keymaster ao lado do HZ-Television (veja Etapa 1). Transmite as 12 variantes de props DashScreen (hz_dashscreen + hz_dashscreen_1..11) + seu JSON de calibracao. Deve iniciar antes do HZ-Television.
3. Um sistema de menu — pelo menos um dos seguintes:

1. Um driver SQL (necessario para persistencia, contas, playlists, limpeza de abandono). HZ-Television detecta automaticamente os dois na inicializacao:

Opcionais

• ox\_target ou qb-target — para interacao por mira (caso contrario fallback TextUI / DrawText3D)
• lb-phone — necessario para o aplicativo companheiro de celular lb-hztelevision

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

Etapa 3 — Arquivos

1. Extraia os dois arquivos (hz_television.zip e hz_televisionprops.zip) baixados do Keymaster na Etapa 1
2. Coloque as duas pastas resultantes no seu diretorio resources/ — agrupa-las em uma pasta de categoria comum como [hz-scripts]/ ajuda a manter tudo organizado

server/
├── resources/
│   ├── ox_lib/
│   ├── oxmysql/                    ← ou mysql-async (ambos sao suportados)
│   ├── [hz-scripts]/
│   │   ├── hz_lib/
│   │   ├── hz_televisionprops/        ← 2o download do Keymaster (12 props DashScreen + calibration.json)
│   │   ├── hz_television/          ← 1o download do Keymaster (o script principal)
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── html/
│   │   │   ├── config.lua
│   │   │   ├── fxmanifest.lua
│   │   │   └── ...

Etapa 4 — Itens de inventario

O HZ-Television vem com 10 itens colocaveis prontos para uso. Definicoes de itens pre-configuradas para cada inventario suportado estao em hz_television/items/.

Itens inclusos

Para ox\_inventory

Abra ox_inventory/data/items.lua e adicione o conteudo de hz_television/items/ox_inventory.txt (10 entradas incluindo hz_dashscreen).

Exemplo 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 o conteudo do arquivo hz_television/items/<inventory>.txt correspondente para o arquivo de itens do seu inventario.

Etapa 5 — Banco de dados (recomendado)

Ative no config.lua:

Config.Placer = {
    Persistence        = true,   -- TVs + DashScreens colocados sobrevivem ao reinicio
    MaxPerPlayer       = 0,      -- 0 = ilimitado, N = limite por identificador do proprietario
    AutoCleanupDays    = 0,      -- 0 = desativado, N = remocao automatica apos N dias de inatividade
    AutoCleanupInterval = 6,     -- horas entre os ciclos de limpeza (0 = apenas na inicializacao)
    BlockOnRoad        = false,  -- true = bloqueia colocacao de props nas estradas (DashScreen isento)
    CleanupAdminPermission = 'admin',  -- permissao ACE para /tvclean
}

As seguintes tabelas sao criadas automaticamente na primeira inicializacao (todas usam CREATE TABLE IF NOT EXISTS + migracoes aditivas ALTER TABLE ADD COLUMN IF NOT EXISTS):

• hz_television_placed — TVs estaticas colocadas (parede, suporte, curvas, paineis)
• hz_dashscreen_placed — colocacoes DashScreen indexadas por placa do veiculo
• hz_tv_users, hz_tv_sessions, hz_tv_favorites, hz_tv_history, hz_tv_playlists, hz_tv_playlist_items — conta / login / favoritos / historico / playlists (alimentados no primeiro login Smart TV)

Instalacao manual (fallback — v3.4.3+)

Se uma tabela nao puder ser criada automaticamente (usuario MySQL sem permissao CREATE, string de conexao apontando para o banco errado, etc.), voce vera um erro vermelho no console do servidor logo apos [hz_television] SQL compat: ... com o nome exato da tabela + o erro. Nesse caso, execute o arquivo install.sql fornecido manualmente:

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

...ou abra hz_television/install.sql no phpMyAdmin / HeidiSQL / DBeaver e execute-o no banco de dados do seu servidor. Depois reinicie hz_television. O script contem apenas instrucoes CREATE TABLE IF NOT EXISTS, entao executa-lo duas vezes e seguro.

Etapa 6 — server.cfg

Adicione os recursos ao seu server.cfg nesta ordem:

# Dependencias (devem iniciar ANTES do hz_lib)
ensure oxmysql                # ou `ensure mysql-async` — HZ-Television suporta ambos
ensure ox_lib                 # ou qb-menu + qb-input
ensure ox_target              # ou qb-target (opcional)

# Framework (se aplicavel)
ensure qbx_core               # ou ensure qb-core, ou ensure es_extended
# ensure qb-core
# ensure es_extended

# HZ-Scripts — a ordem importa
ensure hz_lib              # gerencia a deteccao automatica
ensure hz_televisionprops        # transmite as 12 variantes de props DashScreen (download Keymaster separado)
ensure hz_television          # o recurso logico de TV

Etapa 7 — Configuracao

Abra hz_television/config.lua e adapte os parametros. Veja Configuracao para cada opcao em detalhe.

• Config.Locale — 'en' / 'fr' / 'es' / 'de'
• Config.Permissions — quem pode usar /tvcfg, colocar TVs, usar as TVs
• Config.Placer.Persistence — true para ativar a persistencia no banco
• Config.Placer.BlockOnRoad — true se voce quiser bloquear colocacao nas estradas
• Config.Placer.MaxPerPlayer + Config.Placer.AutoCleanupDays — protecao de abandono
• Config.BillboardUseSmartTV — quais modelos de paineis/cinema devem usar a interface Smart TV completa (padrao: os 3 props de cinema curvos + 2 grandes paineis vanilla)

Etapa 8 — Verificacao

1. Inicie o servidor
2. O console deve exibir (nesta ordem):

1. Conecte-se ao jogo
2. Aproxime-se de um prop de TV (TV de parede, tela de cinema curva, ou use o item hz_dashscreen em um veiculo)
3. Selecione Power On → Smart TV → cole uma URL de video

Solucao rapida 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