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

# Pepper Trucking

<figure><img src="https://content.gitbook.com/content/Irecym4R4dkBNbFKaJiy/blobs/ojHEuy2AR0l2piYfUyvJ/.gitbook/assets/trucking-cover.png" alt="Pepper Trucking"><figcaption></figcaption></figure>

LKW-Fahren als echter Beruf: Mit **Pepper Trucking** bietet dir die Frachtbörse Aufträge passend zu deinem LKW und deinen Skills – vom Paket im Kastenwagen bis zum Transformator auf dem Schwerlast-Anhänger. Anhänger ankuppeln, Fracht schonen, pünktlich liefern, sauber einparken. Mit jedem Aufstieg kaufst du eigene LKW, rüstest sie in der Werkstatt auf, fährst im Konvoi und baust eine Spedition mit Depots und KI-Fahrern auf, die sogar Geld verdienen, während du offline bist.

{% hint style="info" %}
🧪 **Getestet auf unserem Dev-Server:** Wir testen alle Skripte selbstverständlich permanent auf unserem eigenen Dev-Server „Pepper Scripts“.
{% endhint %}

{% hint style="success" %}
**Pepper Trucking holen:** [pepper-scripts.tebex.store](https://pepper-scripts.tebex.store/)
{% endhint %}

### Funktionen

* **Frachtbörse** mit 24 Frachtarten – Gefahrgut, Kühlware, Schwertransporte, Eilaufträge und Mehrstopp-Touren
* **Echte Anhänger** – ankuppeln, abstellen und mit Einparkhilfe und Bonus präzise einparken
* **Skill-Baum** mit 8 Skills – Gefahrgut, Langstrecke, zerbrechliche Fracht, Schwertransport, Eco-Fahren und mehr
* **Eigene LKW** mit Garage, Verschleiß und Werkstatt – Tuning, Lackierungen, Reparaturen, Wiederverkauf
* Frachtschaden, Kühlkette und Lieferfristen – vorsichtiges, pünktliches Fahren zahlt sich aus
* Wiegestationen mit Sondergenehmigungen und Tanken an Tankstellen (oder mit deinem Tank-Script)
* **Konvois** für bis zu 4 Fahrer mit geteilten Aufträgen und Konvoi-Bonus
* **Spedition** mit Personal, Fuhrpark, Depots und **KI-Fahrern**, die passiv Aufträge fahren
* Karriere mit 50 Leveln, Reputation, Bewertung mit 1–5 Sternen, täglichen und wöchentlichen Challenges
* **Frachtort-Editor** im Spiel und Adminpanel mit Offline-Bearbeitung und Audit-Log
* Serverseitige Auszahlungen, Schutz vor doppelten Auszahlungen, Teleports und unplausiblen Fahrten
* Deutsch & Englisch, Config und Locales offen

### Auf einen Blick

|                        |                                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Version**            | 1.0.0                                                                                                         |
| **Framework**          | ESX Legacy 1.9+                                                                                               |
| **OneSync**            | erforderlich                                                                                                  |
| **Abhängigkeiten**     | [es\_extended](https://github.com/esx-framework/esx_core), [oxmysql](https://github.com/overextended/oxmysql) |
| **Optional**           | LegacyFuel, ox\_fuel oder cdn-fuel                                                                            |
| **Nicht erforderlich** | ox\_lib, ox\_target, ox\_inventory                                                                            |
| **Performance**        | ca. 0,02 ms im Leerlauf / 0,15 ms im Dienst (Richtwert)                                                       |
| **Auslieferung**       | Cfx.re Asset Escrow (`config/`, `locales/`, `sql/` offen)                                                     |

### Installation

#### Voraussetzungen

| Voraussetzung      | Version                                                   |
| ------------------ | --------------------------------------------------------- |
| FiveM-Server-Build | 7290+ mit **OneSync**                                     |
| Framework          | ESX Legacy 1.9+ (`es_extended`)                           |
| Datenbank          | [oxmysql](https://github.com/overextended/oxmysql)        |
| Optional           | LegacyFuel, ox\_fuel oder cdn-fuel (`Config.Fuel.System`) |

ox\_lib, ox\_target und ox\_inventory werden **nicht** benötigt. Ein ESX-Job ist nicht nötig – jeder Spieler darf fahren.

#### Schritte

{% stepper %}
{% step %}
**Download**

Lade `pepper_trucking` im [Cfx.re-Portal → Granted Assets](https://portal.cfx.re/assets/granted-assets) herunter.
{% endstep %}

{% step %}
**Kopieren**

Entpacke die Ressource nach `resources/[pepper]/pepper_trucking`.
{% endstep %}

{% step %}
**Datenbank**

Lass `Config.Database.AutoInstall = true` (Standard) – fehlende Tabellen werden beim ersten Start angelegt. Alternativ importierst du `sql/install.sql` manuell. Beim ersten Start werden **33 Standard-Frachtorte** angelegt (`Config.Database.SeedDefaultLocations`).
{% endstep %}

{% step %}
**server.cfg**

Trage die Ressource nach ihren Abhängigkeiten ein:

```cfg
ensure oxmysql
ensure es_extended
ensure pepper_trucking
```

{% endstep %}

{% step %}
**Admin-Rechte**

Vergib Admin-Zugriff (siehe unten).
{% endstep %}

{% step %}
**Frachtorte prüfen**

Fahre die Standard-Frachtorte einmal ab und korrigiere sie bei Bedarf im Frachtort-Editor.
{% endstep %}

{% step %}
**Start**

Fahre zum Speditionshof (LKW-Symbol am Hafen) und drücke `E`.
{% endstep %}
{% endstepper %}

#### Admin-Rechte

ESX-Gruppe aus `Config.Admin.Groups` (Standard: `admin`, `superadmin`) **oder** ACE-Berechtigung:

```cfg
add_ace group.admin pepper_trucking.admin allow
```

{% hint style="info" %}
Frachtorte liegen in der Datenbank – `config/locations.lua` wird nur beim ersten Start übernommen. Updates der Ressource überschreiben deine Orte nie.
{% endhint %}

#### Tank-Script

Standardmäßig nutzt Pepper Trucking eine eigene Tankanzeige und eigene LKW-Tankstellen. Wenn du bereits ein Tank-Script verwendest, stelle `Config.Fuel.System` entsprechend ein – siehe **Konfiguration**.

### Konfiguration

Alle Einstellungen liegen offen in `config/`. Starte die Ressource nach Änderungen neu.

#### Dateien

| Datei                   | Inhalt                                                                                                                                                      |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config/config.lua`     | Depots, Frachtbörse, Andocken/Einparken, Kraftstoff, Wiegestationen, Vergütung, Schäden, Bewertung, Reputation, Garage, Konvoi, Spedition, KI-Fahrer, Admin |
| `config/trucks.lua`     | LKW (Klasse, Typ, Nutzlast, Tank, Verbrauch, Preis, Miete, Voraussetzungen), Tuning-Stufen, Lackfarben                                                      |
| `config/cargo.lua`      | Frachtarten (Warengruppe, Anhänger, Gewicht, Wert, Zerbrechlichkeit, Gefahrgut, Kühlung, Skills)                                                            |
| `config/skills.lua`     | Skill-Baum (Stufen, Mindestlevel, Wirkung)                                                                                                                  |
| `config/levels.lua`     | 50 Level, Titel, XP je Auftrag, Levelprämien                                                                                                                |
| `config/locations.lua`  | Standard-Frachtorte (nur beim ersten Start)                                                                                                                 |
| `config/stations.lua`   | Tankstellen und Wiegestationen                                                                                                                              |
| `config/challenges.lua` | Tägliche und wöchentliche Challenges                                                                                                                        |
| `config/server.lua`     | Nur serverseitig: optionaler Discord-Webhook für Logs                                                                                                       |

#### Allgemein

| Option                                 | Standard | Beschreibung                                                   |
| -------------------------------------- | -------- | -------------------------------------------------------------- |
| `Config.Locale`                        | `'de'`   | Sprache: `'de'` oder `'en'`                                    |
| `Config.Debug`                         | `false`  | Ausführliche Konsolen-Logs                                     |
| `Config.Currency`                      | `'$'`    | Währungssymbol                                                 |
| `Config.TimeSource`                    | `'game'` | Tageszeit für Nacht- und Eilaufträge: `'game'` oder `'server'` |
| `Config.Database.AutoInstall`          | `true`   | Fehlende Tabellen beim Start anlegen                           |
| `Config.Database.SeedDefaultLocations` | `true`   | Standard-Frachtorte anlegen, falls keine vorhanden sind        |

#### Depots (`Config.Depots`)

| Depot                       | Preis   | KI-Plätze | Fuhrpark-Plätze | Schichtstart |
| --------------------------- | ------- | --------- | --------------- | ------------ |
| Hafen Los Santos (Haupthof) | –       | 3         | 6               | ja           |
| Truckstop Route 68          | 450.000 | 3         | 5               | aus          |
| Depot Sandy Shores          | 600.000 | 4         | 6               | aus          |
| Depot Paleto Bay            | 750.000 | 4         | 6               | aus          |

{% hint style="warning" %}
**Nebendepots:** `route68`, `sandy` und `paleto` haben Näherungskoordinaten und `AllowShiftStart = false`. Sie zählen für die Spedition (KI-Plätze, Stellplätze). Schichten lassen sich dort starten, sobald du die Koordinaten im Spiel geprüft und `AllowShiftStart = true` gesetzt hast.
{% endhint %}

#### Tablet & Frachtbörse

| Option                                 | Standard | Beschreibung                                                    |
| -------------------------------------- | -------- | --------------------------------------------------------------- |
| `Config.Tablet.DefaultKey`             | `'F9'`   | Taste für das Tablet (Spieler können sie ändern)                |
| `Config.Freight.BoardSize`             | `8`      | Angebote pro Fahrer                                             |
| `Config.Freight.RefreshMinutes`        | `12`     | Die Börse aktualisiert sich automatisch                         |
| `Config.Freight.ManualRefreshCooldown` | `45`     | Sekunden zwischen manuellen Aktualisierungen                    |
| `Config.Freight.MinDistance`           | `700.0`  | Mindestentfernung Beladen → Entladen (m)                        |
| `Config.Freight.TourChance`            | `0.25`   | Anteil der Mehrstopp-Touren                                     |
| `Config.Freight.MaxDrops`              | `3`      | Maximale Entladestellen pro Tour                                |
| `Config.Freight.UrgentChance`          | `0.18`   | Anteil der Eilaufträge (Skill erforderlich)                     |
| `Config.Freight.NightFactor`           | `1.10`   | Nachtzuschlag (22–5 Uhr Spielzeit)                              |
| `Config.Freight.MaxLate`               | `1800`   | Sekunden nach Ablauf der Lieferfrist, bis der Auftrag scheitert |
| `Config.Freight.ConvoyPayBonus`        | `0.25`   | Konvoi-Aufträge zahlen +25 %                                    |

#### Beladen & Einparken

| Option                       | Standard    | Beschreibung                                      |
| ---------------------------- | ----------- | ------------------------------------------------- |
| `Config.Docking.LoadTime`    | `18`        | Sekunden Ladezeit (Solo-LKW)                      |
| `Config.Docking.UnloadTime`  | `15`        | Sekunden Entladezeit pro Entladestelle            |
| `Config.Docking.LostTimeout` | `900`       | Sekunden ohne Anhänger, bis der Auftrag scheitert |
| `Config.Parking.Perfect`     | 1,6 m / 8°  | +10 % und 60 XP                                   |
| `Config.Parking.Good`        | 3,2 m / 18° | +5 % und 30 XP                                    |

#### Kraftstoff (`Config.Fuel`)

| Option            | Standard     | Beschreibung                                                          |
| ----------------- | ------------ | --------------------------------------------------------------------- |
| `System`          | `'internal'` | `'internal'`, `'legacyfuel'`, `'ox_fuel'`, `'cdn-fuel'` oder `'none'` |
| `PricePerLiter`   | `2`          | Kraftstoffpreis                                                       |
| `PaymentAccount`  | `'bank'`     | Konto für das Tanken                                                  |
| `PerTonFactor`    | `0.012`      | +1,2 % Verbrauch pro Tonne Fracht                                     |
| `RentalStartFill` | `0.6`        | Mietfahrzeuge starten mit 60 % Tankfüllung                            |

Mit `'internal'` werden die eingebaute Tankanzeige und die LKW-Tankstellen genutzt. Mit einem externen Tank-Script übernimmt dieses Verbrauch und Tanken – Pepper Trucking setzt dann nur den Startwert beim Ausparken eines LKW.

#### Wiegestationen (`Config.Weigh`)

| Option                        | Standard        | Beschreibung                                                       |
| ----------------------------- | --------------- | ------------------------------------------------------------------ |
| `Enabled`                     | `true`          | Wiegestationen an/aus                                              |
| `LegalLimit`                  | `40`            | Tonnen – darüber ist eine Sondergenehmigung nötig                  |
| `CycleMinutes`                | `20`            | Stationen öffnen/schließen in diesem Takt                          |
| `SkipFineChance`              | `0.5`           | Kontrollwahrscheinlichkeit beim Auslassen einer geöffneten Station |
| `SkipFine` / `OverweightFine` | `1500` / `5000` | Bußgelder                                                          |
| `PermitCostPerTon`            | `60`            | Sondergenehmigung pro Tonne Fracht                                 |

#### Vergütung (`Config.Economy`)

| Option                                    | Standard        | Beschreibung                                 |
| ----------------------------------------- | --------------- | -------------------------------------------- |
| `PayAccount`                              | `'bank'`        | `'bank'` oder `'money'`                      |
| `GlobalMultiplier`                        | `1.0`           | Multipliziert alle Auszahlungen              |
| `BasePerKm`                               | `90`            | Pro Straßenkilometer                         |
| `PerTonKm`                                | `4.0`           | Pro Tonne und Kilometer                      |
| `MinPay`                                  | `300`           | Mindestauszahlung                            |
| `UrgentBonus` / `OnTimeBonus`             | `0.30` / `0.08` | Bonus für Eilaufträge / pünktliche Lieferung |
| `MaxLatePenalty`                          | `0.5`           | Verspätungsabzug max. −50 %                  |
| `RentalFee`                               | `0.15`          | Mietfahrzeug: 15 % der Auszahlung als Miete  |
| `CancelFee`                               | `250`           | Strafe für den Abbruch eines Auftrags        |
| `ConvoyBonusPerMember` / `ConvoyBonusMax` | `0.08` / `0.24` | Konvoi-Bonus pro Mitglied / Maximum          |

#### Garage, Konvoi & Spedition

| Option                                       | Standard    | Beschreibung                                                                     |
| -------------------------------------------- | ----------- | -------------------------------------------------------------------------------- |
| `Config.Garage.MaxTrucks`                    | `5`         | Eigene LKW pro Spieler                                                           |
| `Config.Garage.SellFactor`                   | `0.65`      | Faktor für den Wiederverkaufswert (× Zustand)                                    |
| `Config.Garage.TowFee`                       | `750`       | Abschleppen zum Haupthof, wenn du eine Schicht weit weg von einem Depot beendest |
| `Config.Convoy.MaxMembers`                   | `4`         | Fahrer pro Konvoi                                                                |
| `Config.Company.PurchasePrice`               | `1500000`   | Preis der Spedition                                                              |
| `Config.Company.RepairPaidBy` / `FuelPaidBy` | `'company'` | Wer bei Firmenfahrten zahlt                                                      |
| `Config.Company.DefaultRanks`                | 5 Ränge     | Gehalt, Anteil und Rechte pro Rang                                               |

#### KI-Fahrer (`Config.AI`)

| Option           | Standard | Beschreibung                                                           |
| ---------------- | -------- | ---------------------------------------------------------------------- |
| `Enabled`        | `true`   | KI-Fahrer an/aus                                                       |
| `JobMinutes`     | `30`     | Echtzeit-Minuten pro Tour                                              |
| `HireFee`        | `5000`   | Einstellungsgebühr                                                     |
| `BaseRevenue`    | `1100`   | Umsatz pro Tour (vor Faktoren)                                         |
| `FailChance`     | `0.05`   | Wahrscheinlichkeit, dass eine Tour scheitert                           |
| `MinCondition`   | `25`     | Unter diesem LKW-Zustand wartet der Fahrer auf die Werkstatt           |
| `MaxCatchUpJobs` | `16`     | Verpasste Touren, die pro Fahrer nach einem Neustart nachgeholt werden |

#### Admin

| Option                       | Standard                  | Beschreibung                           |
| ---------------------------- | ------------------------- | -------------------------------------- |
| `Config.Admin.Groups`        | `superadmin`, `admin`     | ESX-Gruppen mit Admin-Zugriff          |
| `Config.Admin.Ace`           | `'pepper_trucking.admin'` | ACE-Berechtigung als Alternative       |
| `Config.Admin.RequireReason` | `true`                    | Begründung für Änderungen erforderlich |
| `Config.Admin.EditorCommand` | `'truckloc'`              | Befehl für den Frachtort-Editor        |
| `Config.Admin.MaxLocations`  | `150`                     | Maximale Anzahl an Frachtorten         |

### Spielablauf

#### Ein Auftrag Schritt für Schritt

{% stepper %}
{% step %}
**Schicht starten**

Am Terminal des Speditionshofs (LKW-Symbol am Hafen, `E` drücken): Nimm ein Mietfahrzeug, deinen eigenen LKW oder – als Angestellter – einen Firmen-LKW. Mietfahrzeuge kosten 15 % jeder Auszahlung als Miete.
{% endstep %}

{% step %}
**Frachtbörse**

Öffne das Tablet (`F9`) und wähle einen Auftrag. Die Börse zeigt dir 8 persönliche Angebote passend zu Level, Skills und LKW. Überladene Frachten bieten eine Sondergenehmigung an; Konvoi-Leiter können Aufträge teilen.
{% endstep %}

{% step %}
**Beladen**

Halte einen Solo-LKW in der Laderampe an – eine Sattelzugmaschine setzt du rückwärts an den markierten Anhänger, sie kuppelt automatisch an.
{% endstep %}

{% step %}
**Fahren**

Behalte die Lieferfrist im Blick, schone die Fracht, fahre geöffnete Wiegestationen an und tanke rechtzeitig.
{% endstep %}

{% step %}
**Abliefern**

Stelle den Anhänger in der Zone ab (Pfeil = Ausrichtung). An der letzten Entladestelle zählt deine Einparkgenauigkeit – das HUD zeigt eine Einparkhilfe.
{% endstep %}

{% step %}
**Auszahlung**

Sterne, Vergütung mit allen Boni und Abzügen, XP und Reputation – danach Skillpunkte verteilen und den nächsten LKW anpeilen.
{% endstep %}
{% endstepper %}

#### Fracht

24 Frachtarten in 12 Warengruppen – z. B. Pakete, Möbel, Elektronik, Tiefkühlware, Kraftstoff, Chemikalien, Sprengstoff, Holz, Container, Neuwagen, Baumaschinen, Transformatoren und Kunst.

| Spezialfracht       | Worauf du achten musst                                 |
| ------------------- | ------------------------------------------------------ |
| **Zerbrechlich**    | Empfindlicher bei Stößen und harten Manövern           |
| **Gefahrgut**       | Erfordert den Skill – kann zerstört werden             |
| **Kühlware**        | Verspätungen und Schäden unterbrechen die Kühlkette    |
| **Schwertransport** | Übergewicht – Sondergenehmigung an Wiegestationen      |
| **Eilaufträge**     | Knappe Lieferfrist, höherer Bonus (Skill erforderlich) |
| **Touren**          | Bis zu 3 Entladestellen pro Auftrag                    |

#### Skill-Baum

Ein Skillpunkt pro Level. 8 Skills: **Gefahrgut (ADR)**, **Langstrecke**, **Zerbrechliche Fracht**, **Schwertransport**, **Eilaufträge**, **Eco-Fahren**, **Wertfracht** und **Schrauber**. Skills lassen sich gegen eine Gebühr zurücksetzen.

#### Eigene LKW & Werkstatt

* 7 LKW vom **Mule** bis zum **Phantom Custom** – Solo-LKW, Sattelzugmaschinen und Schwerlast-Zugmaschinen
* Garage mit 5 Stellplätzen, Kilometerstand, Zustand und Verschleiß – Schäden bleiben am LKW
* **Werkstatt:** Tuning (Motor, Getriebe, Bremsen, Turbo, Zusatztank), Lackierung, Wartung und Reparatur, eigener Name, Verkauf zum Restwert

#### Wiegestationen & Kraftstoff

* 5 Wiegestationen mit wechselnden Öffnungszeiten. Überladene Frachten brauchen eine Sondergenehmigung; wer eine geöffnete Station auslässt, riskiert eine Kontrolle.
* Der Verbrauch hängt von Strecke, Gewicht und dem Eco-Skill ab. Tanken kannst du an 25 LKW-Tankstellen – oder du nutzt dein eigenes Tank-Script.

#### Konvoi

Bis zu 4 Fahrer fahren gemeinsam: geteilte Aufträge (jeder mit eigenem Anhänger), Konvoi-Bonus, Konvoi-Aufträge mit +25 % und Kartenmarkierungen aller Mitglieder. Einladungen nimmst du mit `Y` an und lehnst sie mit `N` ab.

#### Spedition

* Selbstständige fahren immer auf eigene Rechnung.
* Eine Spedition in Spielerhand hat Personal, Ränge, Gehälter, Provision und ein Firmenkonto.
* **Fuhrpark & Depots:** Firmen-LKW kaufen, warten und aufrüsten; Depots kaufen für mehr KI-Plätze, Stellplätze und +5 % KI-Umsatz.
* **KI-Fahrer:** Bewerber einstellen und ihnen Firmen-LKW zuweisen – sie fahren passiv Touren, selbst wenn niemand online ist, und sammeln Erfahrung. Verpasste Touren werden nach einem Neustart nachgeholt. Ist das Firmenkonto leer, streiken die KI-Fahrer.

#### Frachtort-Editor (Admins)

Tablet (`F9`) → **Admin → Frachtorte**: Belade- und Entladestellen anlegen oder korrigieren. Position und Ausrichtung kommen direkt vom angekuppelten Anhänger (Button oder `/truckloc`), dazu Warengruppen, Zufahrt, Radius, Kartenvorschau und Teleport.

#### Adminpanel

Spieler suchen (auch offline), XP, Level, Reputation, Skills, Statistiken und Challenges bearbeiten, Mietfahrzeuge freischalten, LKW verschenken, die Spedition verwalten, aktive Fahrer live ansehen – jede Änderung landet im Audit-Log.

### Befehle & Exports

#### Befehle & Tasten

| Befehl / Taste        | Funktion                                                                                             |
| --------------------- | ---------------------------------------------------------------------------------------------------- |
| `F9` (`/trucktablet`) | Fahrer-Tablet – am Speditions-Terminal, im Dienst überall                                            |
| `E`                   | Terminal am Depot benutzen                                                                           |
| `Y` / `N`             | Konvoi-Einladung annehmen / ablehnen                                                                 |
| `/truckloc`           | Nur Admins: aktuelle Position (im LKW: Anhängerposition) in den offenen Frachtort-Entwurf übernehmen |

{% hint style="info" %}
Spieler können die Tasten in den GTA-Einstellungen → Tastenbelegung → FiveM ändern.
{% endhint %}

#### Exports (Server, nur lesend)

| Export                                | Beschreibung                            |
| ------------------------------------- | --------------------------------------- |
| `GetTruckerData(src)`                 | Karriere und Statistiken eines Spielers |
| `IsTruckerOnDuty(src)`                | Ist der Spieler im Dienst?              |
| `GetTruckerStatus(src)`               | Aktueller Status des Spielers           |
| `GetTruckerJob(src)`                  | Aktueller Auftrag des Spielers          |
| `GetOnDutyTruckers()`                 | Liste der LKW-Fahrer im Dienst          |
| `GetPlayerTrucks(identifier)`         | Eigene LKW eines Spielers               |
| `GetTruckingCompany()`                | Infos zur Spedition                     |
| `IsTruckingEmployee(srcOrIdentifier)` | Prüfung auf Angestellte                 |
| `GetFreightLocations()`               | Alle Frachtorte                         |

Beispiel:

```lua
local onDuty = exports.pepper_trucking:IsTruckerOnDuty(source)
```

{% hint style="info" %}
Es gibt bewusst **keinen** Export, mit dem andere Ressourcen Geld, XP oder Reputation erzeugen können.
{% endhint %}

### FAQ

<details>

<summary>Brauchen Spieler einen ESX-Job?</summary>

Nein. Jeder darf eine Schicht starten; die Spedition (Personal, Ränge, Gehälter) läuft in der Ressource selbst.

</details>

<details>

<summary>Kollidiert F9 mit Pepper Taxi oder Pepper Bus?</summary>

Nein – Taxi nutzt F6 und Bus F7. Jeder Spieler kann die Taste außerdem in den GTA-Tastenbelegungen ändern.

</details>

<details>

<summary>Ein Frachtort ist schlecht platziert oder liegt in einer Wand.</summary>

Fahre die Standard-Frachtorte einmal ab und erfasse sie im Frachtort-Editor neu – mit angekuppeltem Anhänger in Parkposition (Button oder `/truckloc`).

</details>

<details>

<summary>Ich nutze bereits ein Tank-Script.</summary>

Setze `Config.Fuel.System` auf `'legacyfuel'`, `'ox_fuel'` oder `'cdn-fuel'`.

</details>

<details>

<summary>Verdienen KI-Fahrer Geld, während niemand online ist?</summary>

Ja. Verpasste Fahrten werden nach einem Neustart nachgeholt. Ist das Firmenkonto leer, streiken die KI-Fahrer.

</details>

<details>

<summary>Kann ich Schichten an den Nebendepots starten?</summary>

Ja, nachdem du ihre Koordinaten im Spiel geprüft hast: Setze für das Depot in `Config.Depots` `AllowShiftStart = true`.

</details>

<details>

<summary>Kann eine andere Ressource über Pepper Trucking Geld oder XP auszahlen?</summary>

Nein, die Exports sind nur lesend. Auszahlungen erfolgen ausschließlich serverseitig.

</details>

#### Fehlerbehebung

| Problem                                     | Lösung                                                                                                                                               |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tabellen fehlen                             | `sql/install.sql` importieren oder `Config.Database.AutoInstall = true` setzen.                                                                      |
| Admin-Bereich fehlt                         | ESX-Gruppe in `Config.Admin.Groups` oder ACE `pepper_trucking.admin`.                                                                                |
| Anhänger wird nicht als angekuppelt erkannt | Setze die Sattelzugmaschine an der Rampe rückwärts an den markierten Anhänger, bis er ankuppelt, und zieh ihn dann ein paar Meter von der Rampe weg. |
| Auftrag gescheitert                         | Die Lieferfrist wurde deutlich überschritten, der Anhänger ging verloren oder die Fracht wurde zerstört.                                             |

### Changelog

#### 1.0.0 – 2026-09-27

**Erste Version**

* LKW-Karriere mit 50 Leveln, Reputation, Bewertung und Skill-Baum (8 Skills, 1 Punkt pro Level)
* Frachtbörse mit persönlichen Angeboten: 24 Frachtarten, Gefahrgut, Kühlware, Schwertransporte, Eilaufträge, Mehrstopp-Touren
* Echte Anhänger: Ankuppeln an der Rampe, Abstellen in der Entladezone, Einpark-Bewertung mit Einparkhilfe
* Frachtschaden, Kühlkette, Lieferfristen, Wiegestationen mit Sondergenehmigungen, Tanken an Tankstellen (oder mit externem Tank-Script)
* Eigene LKW mit Händler, Garage, Verschleiß, Werkstatt (Tuning, Lackierung, Reparatur) und Wiederverkauf
* Konvois für bis zu 4 Fahrer mit geteilten Aufträgen und Konvoi-Bonus
* Spedition mit Personal, Rängen, Firmenkonto, Fuhrpark, Depots und passiven KI-Fahrern
* Frachtort-Editor im Spiel (inkl. `/truckloc`), Adminpanel (auch offline), Tablet und HUD im Pepper-Design, Deutsch und Englisch
