Installation

Schritt 1 — Download

Nach Ihrem Kauf auf hzscripts.com/shop erhaelt Ihr FiveM Keymaster-Konto zwei separate Assets:

1. Melden Sie sich auf keymaster.fivem.net an (oder portal.cfx.re/assets)
2. Gehen Sie zu Granted Assets
3. Laden Sie beide herunter:

Schritt 2 — Abhaengigkeiten

Erforderlich

1. hz_lib — kostenloses Asset von hzscripts.com/shop. Uebernimmt die Framework- / Inventar- / Target- / Menue- / Benachrichtigungserkennung. Verwenden Sie immer die neueste Version — jede HZ-Television-Version wird mit dem neuesten Bridge-Build getestet. Muss vor HZ-Television starten. Siehe hz_lib Installation.
2. HZ-TelevisionProps — separat von Keymaster neben HZ-Television heruntergeladen (siehe Schritt 1). Streamt die 12 DashScreen-Prop-Varianten (hz_dashscreen + hz_dashscreen_1..11) + deren Kalibrierungs-JSON. Muss vor HZ-Television starten.
3. Ein Menuesystem — mindestens eines der folgenden:

1. Ein SQL-Treiber (erforderlich fuer Persistenz, Konten, Playlists, Verlassens-Cleanup). HZ-Television erkennt beide automatisch beim Start:

Optional

• ox\_target oder qb-target — fuer Fadenkreuz-Interaktion (ansonsten TextUI / DrawText3D-Fallback)
• lb-phone — erforderlich fuer die Begleit-Telefon-App lb-hztelevision

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

Schritt 3 — Dateien

1. Entpacken Sie beide Archive (hz_television.zip und hz_televisionprops.zip), die Sie in Schritt 1 von Keymaster heruntergeladen haben
2. Platzieren Sie beide resultierenden Ordner in Ihrem resources/-Verzeichnis — ein gemeinsamer Kategorieordner wie [hz-scripts]/ haelt alles ordentlich

server/
├── resources/
│   ├── ox_lib/
│   ├── oxmysql/                    ← oder mysql-async (beide werden unterstuetzt)
│   ├── [hz-scripts]/
│   │   ├── hz_lib/
│   │   ├── hz_televisionprops/        ← 2. Keymaster-Download (12 DashScreen-Props + calibration.json)
│   │   ├── hz_television/          ← 1. Keymaster-Download (das Haupt-Skript)
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── html/
│   │   │   ├── config.lua
│   │   │   ├── fxmanifest.lua
│   │   │   └── ...

Schritt 4 — Inventar-Items

HZ-Television wird mit 10 platzierbaren Items geliefert. Vorkonfigurierte Item-Definitionen fuer jedes unterstuetzte Inventar befinden sich in hz_television/items/.

Mitgelieferte Items

Fuer ox\_inventory

Oeffnen Sie ox_inventory/data/items.lua und fuegen Sie den Inhalt von hz_television/items/ox_inventory.txt hinzu (10 Eintraege einschliesslich hz_dashscreen).

Beispieleintrag:

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

Fuer qb-inventory / qs-inventory / ps-inventory

Kopieren Sie den Inhalt der entsprechenden hz_television/items/<inventory>.txt-Datei in die Item-Datei Ihres Inventars.

Schritt 5 — Datenbank (empfohlen)

Aktivieren Sie in config.lua:

Config.Placer = {
    Persistence        = true,   -- platzierte TVs + DashScreens ueberleben Neustarts
    MaxPerPlayer       = 0,      -- 0 = unbegrenzt, N = Limit pro Besitzer-Identifikator
    AutoCleanupDays    = 0,      -- 0 = deaktiviert, N = automatische Loeschung nach N Tagen Inaktivitaet
    AutoCleanupInterval = 6,     -- Stunden zwischen Cleanup-Zyklen (0 = nur beim Start)
    BlockOnRoad        = false,  -- true = blockiert Prop-Platzierung auf Strassen (DashScreen ausgenommen)
    CleanupAdminPermission = 'admin',  -- ACE-Berechtigung fuer /tvclean
}

Die folgenden Tabellen werden beim ersten Start automatisch erstellt (alle verwenden CREATE TABLE IF NOT EXISTS + additive ALTER TABLE ADD COLUMN IF NOT EXISTS-Migrationen):

• hz_television_placed — statisch platzierte TVs (Wand, Standfuss, gebogen, Werbetafeln)
• hz_dashscreen_placed — DashScreen-Platzierungen, indiziert nach Fahrzeugkennzeichen
• hz_tv_users, hz_tv_sessions, hz_tv_favorites, hz_tv_history, hz_tv_playlists, hz_tv_playlist_items — Konto / Login / Favoriten / Verlauf / Playlists (befuellt bei der ersten Smart-TV-Anmeldung)

Manuelle Installation (Fallback — v3.4.3+)

Falls eine Tabelle nicht automatisch erstellt werden kann (MySQL-Benutzer ohne CREATE-Berechtigung, Verbindungsstring zeigt auf falsche Datenbank usw.), sehen Sie direkt nach [hz_television] SQL compat: ... eine rote Fehlermeldung in der Serverkonsole mit dem genauen Tabellennamen + Fehler. Fuehren Sie in diesem Fall die mitgelieferte install.sql manuell aus:

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

...oder oeffnen Sie hz_television/install.sql in phpMyAdmin / HeidiSQL / DBeaver und fuehren Sie es auf der Datenbank Ihres Servers aus. Starten Sie dann hz_television neu. Das Skript enthaelt nur CREATE TABLE IF NOT EXISTS-Anweisungen, daher ist eine doppelte Ausfuehrung sicher.

Schritt 6 — server.cfg

Fuegen Sie die Ressourcen in Ihre server.cfg in dieser Reihenfolge ein:

# Abhaengigkeiten (muessen VOR hz_lib starten)
ensure oxmysql                # oder `ensure mysql-async` — HZ-Television unterstuetzt beide
ensure ox_lib                 # oder qb-menu + qb-input
ensure ox_target              # oder qb-target (optional)

# Framework (falls zutreffend)
ensure qbx_core               # oder ensure qb-core, oder ensure es_extended
# ensure qb-core
# ensure es_extended

# HZ-Scripts — Reihenfolge ist wichtig
ensure hz_lib              # uebernimmt automatische Erkennung
ensure hz_televisionprops        # streamt die 12 DashScreen-Prop-Varianten (separater Keymaster-Download)
ensure hz_television          # die TV-Logik-Ressource

Schritt 7 — Konfiguration

Oeffnen Sie hz_television/config.lua und passen Sie die Einstellungen an. Siehe Konfiguration fuer Details zu jeder Option.

• Config.Locale — 'en' / 'fr' / 'es' / 'de'
• Config.Permissions — wer /tvcfg verwenden, TVs platzieren und TVs nutzen darf
• Config.Placer.Persistence — true fuer Datenbank-Speicherung
• Config.Placer.BlockOnRoad — true falls Platzierung auf Strassen blockiert werden soll
• Config.Placer.MaxPerPlayer + Config.Placer.AutoCleanupDays — Verlassensschutz
• Config.BillboardUseSmartTV — welche Werbetafel-/Kinomodelle die vollstaendige Smart-TV-Oberflaeche verwenden sollen (Standard: die 3 gebogenen Kino-Props + 2 grosse Vanilla-Werbetafeln)

Schritt 8 — Ueberpruefung

1. Starten Sie den Server
2. Die Konsole sollte (in dieser Reihenfolge) anzeigen:

1. Verbinden Sie sich im Spiel
2. Gehen Sie zu einem TV-Prop (Wandfernseher, gebogene Kinoleinwand, oder verwenden Sie das Item hz_dashscreen in einem Fahrzeug)
3. Waehlen Sie Power On -> Smart TV -> fuegen Sie eine Video-URL ein

Schnelle Fehlerbehebung

[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