HZ-Television
Apresentacao
HZ-Television transforma cada tela interativa do seu servidor FiveM em uma Smart TV totalmente funcional — incluindo TVs de parede, telas de cinema curvas, grandes paineis publicitarios vanilla do GTA V, e o painel de qualquer veiculo via a funcionalidade DashScreen. Telas simultaneas ilimitadas, video direto, fluxos HLS e imagens, conta persistente com favoritos e historico, sincronizacao multijogador em tempo real, e um modo de interacao por cursor livre em raycast.Funcionalidades principais
- Multi-TV ilimitada — sem mais limite de 5 telas (removido na v2.3 com o motor de renderizacao DrawSpritePoly). Cada TV proxima pode transmitir seu proprio conteudo
- 9 props 3D originais transmitidos com o recurso — 3 TVs de parede + 3 TVs com suporte + 3 telas de cinema curvas. Nenhum pacote externo necessario
- DashScreen (v3.2) — monte uma Smart TV no painel de qualquer veiculo via o item
hz_dashscreen+ gizmo de teclado no veiculo. 12 variantes com textura isolada para que cada carro tenha seu proprio conteudo independente - Oclusao de audio de cabine (v3.3) — pipeline Web Audio no DUI simulando a filtragem sonora nativa RAGE do veiculo (lowpass + bass shelf + estado por porta)
- Raycast cilindrico do cursor (v3.3) — calculo matematico real raio ↔ cilindro para cliques com precisao de pixel nas telas de cinema curvas. Preview em tempo real durante
/tvcfg - SmartTV em paineis publicitarios e cinema (v3.3) — cada tipo de tela usa a mesma interface Smart TV; a deteccao automatica do render target corrige os grandes paineis vanilla do GTA V
- Protecao de estrada (v3.4) — preview com contorno vermelho opcional que bloqueia a colocacao de props nas estradas. A colocacao de DashScreen em veiculo e isenta
- Protecao de abandono (v3.4) —
MaxPerPlayer+AutoCleanupDays+ comando admin/tvcleanimpedem que servidores de longa duracao fiquem cheios de TVs deixadas por jogadores inativos - Compativel com routing bucket — TVs e paineis publicitarios sao totalmente isolados por instancia (prisoes, apartamentos, empregos, eventos)
- Sincronizacao de video em tempo real — todos os jogadores perto da mesma TV veem a mesma imagem (heartbeat 5 s, tolerancia de desvio 1.5 s, precisao 0.1 s, seek/play/pause instantaneo)
- Sistema de contas + playlist pessoal — faca login em qualquer TV, salve favoritos / historico / configuracoes por usuario, construa uma fila em loop com duracao por elemento
- Aplicativo companheiro LB Phone (
lb-hztelevision) — controle qualquer TV proxima pelo seu celular, modo silencioso mudo, navegador de midias locais - Calibrador
/tvcfgao vivo — localizado em en/fr/es/de (v3.3), distancia de interacao de 25 m para grandes paineis publicitarios
Fontes suportadas
- Video direto (MP4 / WebM / OGG / MOV), fluxos HLS / M3U8, imagens (PNG / JPG / GIF), ficheiros locais, conteudo web
Multi-Framework — Deteccao automatica
Toda a deteccao de framework / target / menu / notificacao / inventario e centralizada no hz_lib. Configure uma unica vez la, cada Hz-Script herda.
| Sistema | Opcoes suportadas |
|---|---|
| Framework | QBCore, QBox, ESX, Standalone |
| Target | ox\_target, qb-target, modo TextUI |
| Menu | ox\_lib, qb-menu + qb-input |
| Notificacoes | ox\_lib, QBCore, ESX, native |
| Inventario | ox\_inventory, qb-inventory, qs-inventory, ps-inventory, codem-inventory, origen\_inventory, core\_inventory, tgiann-inventory |
| Banco de dados | oxmysql (opcional — necessario para conta, playlist, persistencia de TV, limpeza de abandono) |
Desempenho
| Metrica | Valor |
|---|---|
| Cliente em repouso | \~0.01 ms |
| Cliente — 6 TVs na tela | \~0.03 ms (DrawSpritePoly em cache) |
| Servidor | \~0.00 ms |
| TVs simultaneas | Ilimitado (sem mais limite de motor desde v2.3) |
| DashScreens simultaneos / cliente | 12 mais proximos renderizados (colocacao ilimitada) |
Pre-requisitos
- Servidor FiveM (artifacts mais recentes recomendados)
- hz_lib — versao mais recente necessaria — gerencia toda a deteccao de framework / inventario / target / menu / notificacao. Versoes antigas nao possuem os exports dos quais o HZ-Television v3.4 depende, portanto sempre atualize o hz_lib quando atualizar o HZ-Television
- HZ-TelevisionProps — baixado como um asset Keymaster separado ao lado do HZ-Television, fornece as 12 variantes de props DashScreen (separado na v3.4 para que atualizacoes de props DashScreen nao afetem mais o recurso logico)
ox_lib(recomendado) ouqb-menu+qb-inputoxmysqloumysql-async— necessario para persistencia, contas, playlist,AutoCleanupDays. HZ-Television detecta automaticamente qual esta em execucao (v3.4.1+) e funciona com ambosox_targetouqb-target— opcional (fallback TextUI disponivel)lb-phone— opcional (necessario para o aplicativo companheiro de celularlb-hztelevision)
Sempre atualize o hz_lib para a versao mais recente junto com o HZ-Television. O hz_lib e uma dependencia compartilhada gratuita e cada release Hz-Script e testada com a build mais recente do Bridge. Versoes incompativeis causarao erros "export not found" ou deteccao ausente na inicializacao.
Precisa de ajuda? Entre no nosso Discord e abra um ticket em #support.
Navegacao rapida
Content responsibility. Os proprietarios de servidor sao os unicos responsaveis pelo conteudo que escolhem exibir e por deter os direitos ou licencas necessarios para o difundir. O HZ-Television e fornecido sem qualquer media, sem lista de fontes e sem destinos preconfigurados. Todos os nomes, marcas e logotipos de terceiros permanecem propriedade dos respetivos titulares. A HZ-Scripts desenvolve software independente para a plataforma FiveM e nao e afiliada, aprovada nem patrocinada pela Rockstar Games, Take-Two Interactive ou Cfx.re.