> For the complete documentation index, see [llms.txt](https://fjx.gitbook.io/fjx-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fjx.gitbook.io/fjx-docs/flipreaction/installation.md).

# Installation

## Installation

### Anforderungen

* ESX oder QBCore Framework
* FiveM Server

### Installationsschritte

#### Schritt 1: Download

Lade die FLIPREACTION Auto-Detect-Ressource von dem [Cfx.re Portal](https://portal.cfx.re/assets/granted-assets) herunter.

#### Schritt 2: Dateien extrahieren

Extrahiere die heruntergeladene ZIP-Datei in den Resources-Ordner deines Servers.

#### Schritt 3: Ordner umbenennen

Benenne den extrahierten Ordner in `fjx_flipreaction` um (oder einen Namen deiner Wahl).

#### Schritt 4: server.cfg konfigurieren

Füge die folgende Zeile zu deiner server.cfg-Datei hinzu:

```
ensure fjx_flipreaction
```

#### Schritt 5: Starten oder Neustarten

Starte entweder deinen Server neu oder verwende die Konsole, um die Ressource zu starten:

```
refresh
ensure fjx_flipreaction
```

### Überprüfung

Um zu überprüfen, ob das Skript korrekt läuft:

1. Überprüfe die Serverkonsole auf die Startmeldung: "FlipReaction with auto framework detection started successfully"
2. Suche nach der Framework-Erkennungsmeldung: "Framework \[ESX/QBCore] detected and loaded"
3. Teste die Funktionalität, indem du ein Fahrzeug im Spiel überschlägst - du solltest Benachrichtigungen und alle konfigurierten Effekte sehen

### Framework-Automatische Erkennung

FLIPREACTION erkennt automatisch, welches Framework auf deinem Server installiert ist:

#### ESX-Erkennung

Das Skript versucht zuerst, ESX mit zwei Methoden zu erkennen:

1. Die moderne Export-Methode: `exports['es_extended']:getSharedObject()`
2. Die Legacy-Event-Methode: `TriggerEvent('esx:getSharedObject')`

#### QBCore-Erkennung

Wenn ESX nicht gefunden wird, versucht das Skript QBCore zu erkennen:

* Unter Verwendung des Standardexports: `exports['qb-core']:GetCoreObject()`

#### Framework nicht gefunden

Wenn keines der Frameworks erkannt wird, wird eine Konsolenmeldung angezeigt:

```
No supported framework detected. This script requires ESX or QBCore.
```

### Wichtige Ladereihenfolge

Für optimale Leistung stelle sicher, dass dein Framework (ESX oder QBCore) vor FLIPREACTION in deiner server.cfg gestartet wird:

```
# Für ESX
ensure es_extended
ensure fjx_flipreaction

# Für QBCore
ensure qb-core
ensure fjx_flipreaction
```

Dies stellt sicher, dass das Framework vollständig geladen ist, bevor FLIPREACTION versucht, es zu erkennen und sich damit zu verbinden.

### Wichtiger Hinweis zum Escrow-Schutz

Dieses Skript ist Escrow-geschützt, was bedeutet:

* Du kannst die Kern-Skriptdateien nicht modifizieren
* Nur die `config.lua`-Datei ist bearbeitbar
* Alle Anpassungen müssen über die Konfigurationsoptionen erfolgen

Der Escrow-Schutz gewährleistet die Integrität des Skripts, während du sein Verhalten weiterhin über die Konfigurationsdatei anpassen kannst.

### Häufige Installationsprobleme

#### Kein Framework erkannt

Wenn du die Meldung "No supported framework detected" siehst:

1. Überprüfe, ob dein Framework korrekt installiert ist
2. Überprüfe, ob dein Framework-Ressourcenname standard ist (`es_extended` oder `qb-core`)
3. Stelle sicher, dass dein Framework vor FLIPREACTION startet

#### Mehrere Frameworks

Wenn du sowohl ESX als auch QBCore installiert hast:

1. Das Skript priorisiert standardmäßig ESX
2. Wenn du QBCore bevorzugst, stelle sicher, dass ESX nicht geladen ist