FiveM Scripts installieren: Download, Asset Escrow, Abhängigkeiten, server.cfg und Fehlersuche

FiveM•Von Web-Services Team••9 Min. Lesezeit

Um FiveM Scripts zu installieren, lädst du die Resource aus deinem Keymaster-Konto im CFX Portal herunter, entpackst sie in den resources-Ordner, startest zuerst alle Abhängigkeiten und danach das Script per ensure in der server.cfg. Bringt das Script eine SQL-Datei mit, importierst du sie vor dem ersten Start in deine Datenbank, passt die config an und prüfst die Ausgabe in der Server-Konsole. Fast alle Startfehler entstehen an drei Stellen: falscher Lizenzschlüssel, fehlende Abhängigkeit oder falsche Reihenfolge.

Dieser Beitrag geht den Ablauf so durch, wie er auf einem laufenden ESX-, QBCore- oder Qbox-Server tatsächlich passiert, und zeigt, wie du typische Fehlermeldungen in der Konsole einordnest.

Was du vor dem Installieren von FiveM Scripts prüfen solltest

Bevor du eine neue Resource auf den Server legst, lohnt ein kurzer Abgleich. Die meisten Probleme, die später wie ein Script-Fehler aussehen, sind eigentlich Umgebungsfehler.

  • Framework und Version: Steht auf der Produktseite ESX, QBCore oder Standalone? Wird eine Mindestversion genannt, etwa eine bestimmte es_extended-Version?
  • Lizenzschlüssel: Der sv_licenseKey in deiner server.cfg muss zu dem Cfx.re-Konto gehören, auf dem das Script freigeschaltet ist.
  • Server-Artefakte: Geschützte Resources brauchen aktuelle Server-Builds. Ein Server auf einem sehr alten Artefakt kann Escrow-Dateien nicht laden.
  • Sicherung: Vor jedem SQL-Import eine aktuelle Datenbanksicherung, damit du einen fehlerhaften Import zurückdrehen kannst.

Teste neue Scripts möglichst zuerst auf einem Testserver mit eigener Datenbank. Auf dem Live-Server installierst du erst, wenn das Script dort ohne Fehlermeldung startet.

FiveM Scripts installieren: die Schritte im Überblick

  1. Script im CFX Portal unter deinem Keymaster-Konto herunterladen.
  2. Archiv entpacken und prüfen, dass die fxmanifest.lua direkt im Resource-Ordner liegt.
  3. Ordner in den resources-Ordner des Servers hochladen, bei FTP im Binärmodus.
  4. Abhängigkeiten aus Produktseite, Readme und fxmanifest ermitteln und installieren.
  5. SQL-Datei, falls vorhanden, in die Server-Datenbank importieren.
  6. config-Datei anpassen: Framework-Einstellungen, Positionen, Preise, Webhooks.
  7. ensure-Zeile in der server.cfg hinter allen Abhängigkeiten eintragen.
  8. Server starten oder per Konsole refresh und ensure ausführen und die Ausgabe lesen.
  9. Im Spiel testen, erst dann auf den Live-Server übernehmen.

Download aus dem CFX Portal und Asset Escrow

Erworbene Scripts landen nicht als Datei in deinem Postfach, sondern als freigeschaltete Resource in deinem Keymaster-Konto bei Cfx.re. Im Portal findest du sie unter den dir zugewiesenen Assets und lädst sie dort als Archiv herunter.

Viele Scripts sind mit Asset Escrow geschützt. Das heißt: Ein Teil der Dateien ist verschlüsselt und läuft nur auf einem Server, dessen Lizenzschlüssel zum berechtigten Konto gehört. Offen bleiben in der Regel die Konfigurationsdateien und oft auch die Oberfläche, etwa eine style.css. Alles, was du anpassen sollst, liegt dort.

Drei Regeln ersparen dir bei geschützten Resources viel Fehlersuche:

  • Verschlüsselte Dateien niemals öffnen und speichern. Schon ein Editor, der Zeilenenden umwandelt, macht die Datei unbrauchbar.
  • Beim Hochladen per FTP den Binärmodus verwenden. Im ASCII-Modus werden die Dateien verändert und der Server kann sie nicht mehr verifizieren.
  • Den Ordnernamen nicht umbenennen. Andere Scripts sprechen Exports und Events über den Resource-Namen an.

Betreibt dein Hoster den Server mit einem eigenen Lizenzschlüssel, musst du entweder deinen Schlüssel eintragen oder das Asset auf das Konto übertragen, dem der Schlüssel gehört. Sonst startet das Script nicht.

Abhängigkeiten erkennen: Framework-, Basis- und Menü-Scripts

Kaum ein Script läuft allein. Typische Abhängigkeiten sind das Framework selbst (es_extended, qb-core, qbx_core), die Datenbankanbindung über oxmysql und bei manchen Anbietern ein eigenes Basis-Script oder ein Menü-Script, das Oberflächen für mehrere Resources bereitstellt.

Du findest sie an drei Stellen:

  • auf der Produktseite oder in der mitgelieferten Readme,
  • in der fxmanifest.lua unter dependencies oder dependency,
  • in der Konsole, wenn beim Start ein Export oder eine Resource fehlt.

Ein Blick in die fxmanifest sieht etwa so aus:

fx_version 'cerulean'
game 'gta5'

dependencies {
    'oxmysql',
    'es_extended',
    'basis_script'
}

Was hier steht, muss vor dem Script laufen. Fehlt eine Abhängigkeit ganz, bricht der Server den Start der Resource mit einer Meldung ab. Wie du oxmysql selbst sauber anbindest, steht im Beitrag zu oxmysql mit Connection-String und server.cfg einrichten.

Die richtige Startreihenfolge in der server.cfg

Die Startreihenfolge entscheidet darüber, ob ein Script beim Start seine Abhängigkeiten findet. FiveM startet Resources in der Reihenfolge der ensure-Zeilen. Eine bewährte Gliederung:

# Lizenz und Grundeinstellungen
sv_licenseKey dein_schluessel

# 1. Datenbank
ensure oxmysql

# 2. Framework
ensure es_extended

# 3. Basis- und Menü-Scripts
ensure basis_script
ensure menu_script

# 4. Gameplay-Scripts
ensure garage_script
ensure banking_script

# 5. Maps und Streams
ensure [maps]

Ein häufiger Fehler ist ensure [scripts] für einen ganzen Kategorie-Ordner. Das startet alle Resources darin, aber du steuerst nicht, in welcher Reihenfolge. Für Maps ohne Abhängigkeiten ist das in Ordnung. Basis- und Framework-Scripts trägst du dagegen immer einzeln und weiter oben ein.

Achte außerdem darauf, dass ein Script nicht doppelt gestartet wird, einmal einzeln und einmal über den Kategorie-Ordner. Das erzeugt doppelte Event-Handler und schwer nachvollziehbare Fehler.

SQL-Dateien importieren

Liegt eine .sql-Datei bei, legt sie Tabellen, Spalten oder Items an. Importiere sie vor dem ersten Start in genau die Datenbank, die oxmysql nutzt. Über die Kommandozeile geht das so:

mysql -u benutzer -p datenbankname < install.sql

Alternativ öffnest du die Datei in HeidiSQL oder phpMyAdmin und führst sie dort aus. Danach prüfst du, ob die neuen Tabellen tatsächlich angelegt wurden.

Zwei Punkte, die oft übersehen werden:

  • Bei QBCore und Qbox werden Items meist nicht per SQL, sondern in einer Item-Datei des Frameworks oder Inventars eingetragen. Was das Script erwartet, steht in der Readme.
  • Ein zweiter Import derselben Datei kann mit Meldungen wie Duplicate column name abbrechen. Das ist meist harmlos, zeigt aber, dass der erste Import schon gelaufen ist. Bei Updates importierst du nur die Update-SQL, nicht die komplette Installationsdatei.

Konfiguration anpassen

Die config ist der Teil, den du bewusst bearbeitest. Geh sie einmal vollständig durch, statt nur die Positionen zu ändern. Typische Einstellungen:

  • Framework-Anbindung, etwa Event-Prefix oder der Name des Shared Objects bei ESX, wenn dein Server davon abweicht,
  • Sprache und Texte,
  • Koordinaten für Marker, Blips und NPCs,
  • Preise, Limits und Belohnungen,
  • Webhook-Adressen für Logs.

Nach einer Änderung an der config reicht oft restart ressourcenname in der Konsole. Wenn sich Items, Jobs oder Datenbankstrukturen geändert haben, ist ein vollständiger Serverneustart die sicherere Wahl, weil das Framework diese Daten beim Start lädt.

Passt du die Optik an, ändere sie in der offenen style.css und halte deine Änderungen getrennt fest. So überträgst du sie bei einem Update in Minuten, statt neu zu suchen.

Fehler in der Konsole lesen

Die Server-Konsole sagt dir fast immer genau, welche Resource woran scheitert, wenn du sie direkt nach dem Start einer einzelnen Resource liest statt im Gesamtlog des Serverstarts. Starte neue Scripts deshalb gezielt mit refresh und anschließend ensure ressourcenname und beobachte nur diese Ausgabe.

Die häufigsten Meldungen und ihre Bedeutung:

  • Couldn't find resource xyz: Der Name in der server.cfg passt nicht zum Ordnernamen, oder das Archiv wurde doppelt verschachtelt entpackt, sodass die fxmanifest eine Ebene zu tief liegt.
  • You lack the required entitlement: Der Lizenzschlüssel gehört nicht zu dem Konto, auf dem das Script freigeschaltet ist.
  • Failed to verify protected resource: Escrow-Dateien wurden verändert, meist durch FTP im ASCII-Modus oder ein Speichern im Editor. Neu herunterladen und erneut hochladen.
  • No such export: Eine Abhängigkeit fehlt oder startet erst nach dem Script.
  • attempt to index a nil value mit Bezug auf das Framework-Objekt: Das Framework wurde nicht gefunden, oft wegen falscher Einstellung in der config oder falscher Reihenfolge.
  • Table ... doesn't exist oder Unknown column: Die SQL-Datei wurde nicht oder in die falsche Datenbank importiert.

Fehler, die mit SCRIPT ERROR beginnen, nennen Datei und Zeile. Bei einer geschützten Datei kannst du die Zeile nicht ansehen, die Meldung samt Kontext ist aber genau das, was der Support des Anbieters braucht. Kopiere sie vollständig, nicht als Screenshot eines Ausschnitts.

Checkliste nach der Installation

  • Script startet ohne Fehlermeldung und ohne Warnungen zu fehlenden Abhängigkeiten.
  • Neue Tabellen und Items sind in der Datenbank beziehungsweise im Framework vorhanden.
  • Funktionen wurden im Spiel mit einem normalen Spieler-Account getestet, nicht nur als Admin.
  • Webhook-Logs kommen im vorgesehenen Channel an.
  • Kein Script wird doppelt gestartet.
  • Änderungen an config und style.css sind dokumentiert.

Ersetzt das neue Script ein bestehendes, etwa ein HUD oder eine Garage, gilt zusätzlich: Das alte Script vorher aus der server.cfg nehmen und prüfen, ob andere Resources noch dessen Exports aufrufen. Wie so ein Wechsel ohne Ausfall abläuft, zeigt der Beitrag zum sauberen Wechsel des HUDs auf Roleplay-Servern.

Scripts von Web-Services installieren

Bei Web-Services läuft der Ablauf genau wie oben beschrieben. Wer dort FiveM Scripts kaufen möchte, erhält sie über das Cfx-Keymaster-Konto zum Download. Die Scripts sind mit Asset Escrow geschützt, die Einstellungen liegen in config-Dateien und die Oberflächen lassen sich meist über die style.css anpassen. Welche Frameworks ein Script unterstützt, steht jeweils auf der Produktseite.

Unter den kostenlosen FiveM Scripts finden sich unter anderem das Basis-Script ws_base und ws_menu als Ersatz für esx_menu_default. Ob ein bestimmtes Script eines davon voraussetzt, prüfst du auf der jeweiligen Produktseite. Discord-Bots werden nicht über Keymaster, sondern über control-panel.ws mit der Tebex-ID eingelöst. Hilfe bei der Einrichtung gibt es auf dem Discord von Web-Services.

FAQ

Warum startet ein Script nicht, obwohl es im resources-Ordner liegt?

Meist fehlt die ensure-Zeile, der Name weicht vom Ordnernamen ab oder die fxmanifest liegt durch doppeltes Entpacken eine Ebene zu tief. Führe refresh und ensure ressourcenname in der Konsole aus und lies die erste Meldung.

Kann ich Scripts mit Asset Escrow bearbeiten?

Nur die offenen Dateien, also in der Regel config und Oberflächen-Dateien wie die style.css. Verschlüsselte Dateien darfst du nicht öffnen und speichern, sonst schlägt die Verifizierung beim Start fehl.

Muss ich den Server nach der Installation neu starten?

Für einen ersten Test reichen refresh und ensure. Wenn das Script Items, Jobs oder Datenbankstrukturen anlegt, ist ein vollständiger Neustart sicherer, weil das Framework diese Daten nur beim Start einliest.

Läuft ein ESX-Script auch auf QBCore oder Qbox?

Nicht automatisch. Ein Script läuft nur auf den Frameworks, die der Anbieter ausdrücklich unterstützt. Steht auf der Produktseite nur ESX, solltest du es nicht ohne Anpassung auf QBCore oder Qbox einsetzen.

Anmelden

FAQ

Du bekommst Hilfe bei Fragen oder der Einrichtung unserer Produkte auf unserem Discord (discord.gg/webservices).

Du kannst das gekaufte Skript direkt im CFX Portal (portal.cfx.re) herunterladen und dann auf deinem Server verwenden.

Leider ist eine Rückerstattung nicht möglich.

Du kannst unser Control Panel über den folgenden Link erreichen: control-panel.ws

Alle Rechte vorbehalten. 2021-2026 © WS Shop
Kostenlose ScriptsYouTube
Nutzungsbedingungen
Datenschutz
Impressum
Gestaltet von: Mattiwe Design