FiveM Installation
FiveM Scripts installieren: sichere Schritt-fuer-Schritt Anleitung
Diese deutsche Anleitung zeigt, wie du FiveM Scripts sauber installierst, Abhaengigkeiten erkennst, server.cfg korrekt sortierst und Fehler vor dem Livegang abfaengst.
Geprueft von der FiveMX Redaktion fuer Serverbetreiber, die FiveM Ressourcen nicht nur starten, sondern kontrolliert in eine produktive Umgebung uebernehmen wollen.
Aktualisiert am 18.05.2026 von FiveMX Editorial.
Schnellueberblick
| Bereich | Pruefung | Warum wichtig |
|---|---|---|
| Ordner | fxmanifest.lua liegt im richtigen Ressourcenordner | Sonst startet FiveM die Ressource nicht. |
| Abhaengigkeiten | Framework, ox_lib, oxmysql und Inventar starten vorher | Exports fehlen sonst beim Laden. |
| Datenbank | SQL auf Staging getestet | Schuetzt Spieler- und Fahrzeugdaten. |
| Permissions | Admin und Spielerrolle getestet | Verhindert Features, die nur fuer Staff funktionieren. |
Kurzfazit
Ein FiveM Script ist nicht fertig installiert, nur weil der Ressourcenordner im Server liegt. Eine saubere Installation besteht aus vier Schritten: Quelle pruefen, Abhaengigkeiten vorbereiten, Datenbank und Konfiguration anpassen und danach in einer Testsession verifizieren. Viele Serverprobleme entstehen nicht durch schlechte Scripts, sondern durch falsche Ordnerstruktur, doppelte Ressourcennamen, fehlende SQL-Tabellen oder eine server.cfg, in der Ressourcen vor ihren Abhaengigkeiten starten.
Arbeite deshalb nie direkt auf dem Live-Server, wenn ein Script Inventar, Jobs, Geld, Fahrzeuge, Whitelist, Discord-Rollen oder Charakterdaten beruehrt. Nutze eine Staging-Instanz oder mindestens ein Wartungsfenster mit Datenbank-Backup. Wenn du nach der Installation Fehler siehst, notiere zuerst den exakten Konsolenfehler und rolle nicht blind mehrere Aenderungen gleichzeitig zurueck.
Ressource vor dem Upload pruefen
Entpacke das Archiv lokal und suche nach der Datei fxmanifest.lua. Diese Datei muss im eigentlichen Ressourcenordner liegen. Ein haeufiger Fehler ist eine Struktur wie resource-main/resource/fxmanifest.lua; in diesem Fall wird der falsche Ordner hochgeladen und FiveM erkennt die Ressource nicht. Benenne den Ordner eindeutig, vermeide Leerzeichen und Sonderzeichen und pruefe, ob die Dokumentation bestimmte Ressourcennamen erwartet.
Danach liest du die Config-Dateien. Wichtige Felder sind Framework-Auswahl, Datenbanktreiber, Itemnamen, Jobnamen, Discord Webhook URLs, Sprache, Permissions und optionale Integrationen. Wenn ein Script sowohl ESX als auch QBCore unterstuetzt, darf nur der passende Modus aktiv sein. Mische keine alten esx:getSharedObject Muster mit neuen Export-Konfigurationen, ohne die Dokumentation zu pruefen.
server.cfg sinnvoll sortieren
Die Startreihenfolge entscheidet, ob Exports und Events verfuegbar sind. Starte zuerst systemnahe Ressourcen, danach Datenbank und Libraries, danach Framework und Inventar, danach Jobs, Shops, UI, Fahrzeuge und zuletzt optionale Komfortfunktionen. Bei QBCore gehoeren qb-core, qb-target, qb-menu und Inventar vor job- oder police-bezogene Ressourcen. Bei ESX stehen es_extended, oxmysql und Basisjobs vor Addons.
Nutze pro Ressource eine eigene ensure-Zeile. Kommentiere groessere Bloecke, aber halte die Kommentare knapp. Wenn du ein Script testest, fuege direkt darunter einen Hinweis ein, wann es hinzugefuegt wurde und welche Abhaengigkeiten es erwartet. So findet dein Team spaeter schneller heraus, warum eine Ressource an dieser Stelle startet.
SQL, Items und Jobs abstimmen
Viele Premium-Scripts liefern SQL-Dateien mit. Importiere diese nie unbesehen in Produktion. Oeffne die Datei, pruefe CREATE TABLE, ALTER TABLE und INSERT-Befehle und achte darauf, ob vorhandene Tabellen wie users, owned_vehicles, jobs, items oder inventories geaendert werden. Ein falscher Import kann bestehende Daten ueberschreiben oder doppelte Items erzeugen.
Nach dem SQL-Import muessen Config und Datenbank zusammenpassen. Wenn in der Config ein Item police_badge erwartet wird, muss dieses Item im Inventar existieren. Wenn ein Job mechanic heisst, muss derselbe Name in Jobs, Society, Bossmenu und Kleidungssystem verwendet werden. Viele scheinbare Scriptfehler sind in Wahrheit unterschiedliche Schreibweisen.
Live-Test und Rollback
Teste mit mindestens zwei Accounts, wenn das Script Interaktionen zwischen Spielern erzeugt. Ein Police-MDT, ein Job-System oder ein Shop kann fuer den Admin funktionieren, aber fuer normale Spieler an Permissions scheitern. Beobachte waehrenddessen txAdmin, Server-Konsole, Client-F8-Konsole und resmon. Notiere Warnungen, die wiederholt auftreten, auch wenn die Funktion auf den ersten Blick laeuft.
Ein guter Rollback besteht aus drei Teilen: Ressource in server.cfg deaktivieren, Datenbank-Backup zurueckspielen oder Migration rueckgaengig machen und Cache/Clientdaten pruefen. Wenn du mehrere Scripts gleichzeitig installiert hast, rolle einzeln zurueck. Sonst weisst du nicht, welche Ressource den Fehler wirklich verursacht hat.
Launch-Checkliste
- Ressource entpacken und pruefen, ob eine fxmanifest.lua im obersten Ressourcenordner liegt.
- Abhaengigkeiten wie ox_lib, oxmysql, ESX, QBCore oder QBox vor dem eigentlichen Script starten.
- SQL-Dateien zuerst auf einer Kopie der Datenbank testen und danach in der richtigen Reihenfolge importieren.
- server.cfg mit ensure-Zeilen versionieren, damit Rollbacks nachvollziehbar bleiben.
- Nach dem Start Client-Konsole, Server-Konsole, txAdmin-Logs und resmon mindestens eine Testsession beobachten.
Passende FiveMX Ressourcen
FAQ
Muss ich den ganzen FiveM Server nach jeder Installation neu starten?
Nein. Du kannst ein Script auch in laufender Umgebung laden, aber ein geplanter Restart ist sicherer, wenn Datenbanktabellen, Jobs, Items oder Framework-Exports beteiligt sind.
Welche Reihenfolge ist in der server.cfg richtig?
Starte immer Framework, Datenbank, Libraries und Inventar vor dem Feature-Script. Wenn ein Script Exports aus ox_lib, qb-core oder es_extended nutzt, muss diese Ressource vorher laufen.
Was mache ich, wenn das Script startet, aber ingame nichts passiert?
Dann fehlt meistens eine Abhaengigkeit, ein Config-Wert ist falsch geschrieben oder die Ressource liegt in einem doppelt verschachtelten Ordner. Pruefe zuerst den genauen Fehler in der Server-Konsole.