FJX Studios Dokumentation
Shop Discord

Installation

FJX TÜV-System einrichten — Framework, Datenbank, Abhängigkeiten und erster Test.

Zuletzt aktualisiert: 21. August 2026

Anforderungen

Komponente Pflicht Hinweis
FiveM-Server ja —
ESX Legacy oder QBCore ja wird automatisch erkannt
MySQL-Datenbank ja oxmysql oder mysql-async
ox_lib nein beste UI-Erfahrung
ox_target / qb-target nein Target-System
esx_billing / qb-billing nein Rechnungssystem

Das Skript benötigt zwingend ein Framework — ESX oder QBCore. Standalone läuft es nicht.

Installationsschritte

Download

Lade die FJX TÜV-System-Ressource über deine Kaufbestätigung herunter.

Dateien extrahieren

Entpacke die ZIP-Datei in den resources/-Ordner deines Servers.

Ordner umbenennen

Benenne den entpackten Ordner in fjx_tuev um (oder einen Namen deiner Wahl).

Datenbank importieren

Importiere tuev_system.sql in deine MySQL-Datenbank — z. B. über phpMyAdmin oder HeidiSQL.

Alternativ erstellt das Skript die Tabellen beim ersten Start automatisch, falls sie noch nicht existieren.

Konfiguration anpassen

Öffne die config.lua und setze die wichtigsten Werte:

config.lua
lua
-- Framework wird automatisch erkannt
Config.Locale = 'de'                -- Sprache: 'de' oder 'en'

-- TÜV-Einstellungen
Config.TuevGueltigTage = 30         -- Gültigkeit in Tagen
Config.Price = 750                  -- TÜV-Preis

-- Zahlungssystem
Config.PaymentTarget = 'society'    -- 'society' oder 'player'
Config.SocietyName = 'mechanic'     -- Society für Zahlungen

-- Jobs die TÜV durchführen dürfen
Config.MechanicJobs = {
    'mechanic',
    'tuner',
    'bennys'
}

TÜV-Plaketten (optional)

Die Plaketten-Bilder (60+ Stück) liegen bereits im Paket unter html/img/.

Für eigene Plaketten:

  1. PNG-Bilder im Format MM_YY.png erstellen, z. B. 01_26.png für Januar 2026
  2. Größe 160 × 160 Pixel
  3. In den Ordner html/img/ legen

Das Skript zeigt automatisch das passende Bild anhand des Ablaufdatums.

server.cfg konfigurieren

Trage die Resource ein — nach deinem Framework:

cfg
ensure es_extended
ensure esx_billing          # optional, für Rechnungen
ensure esx_addonaccount     # wichtig für Society-Payments!

ensure fjx_tuev
cfg
ensure qb-core
ensure qb-billing           # optional, für Rechnungen
ensure qb-management        # wichtig für Society-Payments!

ensure fjx_tuev

Starten oder neu starten

Starte den Server neu — oder über die Konsole:

cfg
refresh
ensure fjx_tuev

Überprüfung

1. Serverkonsole prüfen

text
[TÜV] Datenbank-Tabellen erfolgreich initialisiert!
[TÜV Server] System loaded - Framework: esx

Bei QBCore steht dort entsprechend Framework: qb.

2. Im Spiel testen

  1. TÜV-Station besuchen — zu einer der vorkonfigurierten Stationen fahren
  2. Blip prüfen — ein gelber Werkstatt-Marker sollte auf der Karte erscheinen
  3. Fahrzeug prüfen — an einem Fahrzeug E drücken (oder die konfigurierte Taste)
  4. TÜV-Plakette — sollte unten rechts erscheinen

3. Als Mechaniker testen

  1. Mit einem Mechaniker-Account einloggen
  2. Bei einem Fahrzeug H für die Diagnose drücken
  3. Das Minigame sollte starten, falls aktiviert
  4. Nach erfolgreicher Diagnose C für die TÜV-Erneuerung drücken
  5. Das Rechnungssystem sollte funktionieren

Framework-Erkennung

Das Skript erkennt automatisch, welches Framework installiert ist.

Zuerst wird ESX über die moderne Export-Methode gesucht:

lua
ESX = exports['es_extended']:getSharedObject()

Wird ESX nicht gefunden, sucht das Skript nach QBCore:

lua
QBCore = exports['qb-core']:GetCoreObject()

Wird keines der Frameworks erkannt, erscheint:

text
[TÜV Server] System loaded - Framework: none

Das Skript benötigt zwingend ein Framework.

Ladereihenfolge

Alle Abhängigkeiten müssen vor FJX TÜV starten.

server.cfg
cfg
# Framework & Basis-Scripts
ensure es_extended
ensure oxmysql              # oder mysql-async
ensure esx_addonaccount     # für Society-Accounts
ensure esx_billing          # für Rechnungen (optional)

# UI-Systeme (optional, empfohlen)
ensure ox_lib               # beste UI-Erfahrung
ensure ox_target            # Target-System

# TÜV-System
ensure fjx_tuev
server.cfg
cfg
# Framework & Basis-Scripts
ensure qb-core
ensure oxmysql              # oder mysql-async
ensure qb-management        # für Society-Management
ensure qb-billing           # für Rechnungen (optional)

# UI-Systeme (optional, empfohlen)
ensure ox_lib               # beste UI-Erfahrung
ensure ox_target            # Target-System

# TÜV-System
ensure fjx_tuev

Optionale Abhängigkeiten

UI-Systeme

Für beste Ergebnisse ensure ox_lib installieren. Ohne zusätzliche Abhängigkeiten geht auch Native-UI:

config.lua
lua
Config.NotifyType = 'native'
Config.ProgressType = 'none'
Config.MenuType = 'native'

Target-Systeme

ensure ox_target (empfohlen) oder ensure qb-target für QBCore. Ohne Target-System geht 3D-Text:

config.lua
lua
Config.Target = 'none'
Config.Use3DText = true

Billing-Systeme

Framework Rechnungen Society-Payments
ESX esx_billing esx_addonaccount
QBCore qb-billing qb-management

Escrow-Schutz

Dieses Skript ist Escrow-geschützt:

  • Die config.lua ist vollständig bearbeitbar
  • Alle Anpassungen erfolgen über Konfigurationsoptionen
  • Updates laufen automatisch über das Escrow-System
  • Die Kern-Skriptdateien lassen sich nicht verändern, der Quellcode ist geschützt

Nächste Schritte

Konfiguration — alle Einstellungsmöglichkeiten→
FAQ & Fehlerbehebung→