# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fjx.gitbook.io/fjx-docs/flipreaction/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.