Spare 20 % mit WELCOMEAngebote ansehen
Einrichten von fxmanifest.lua (FiveM)

Einrichten von fxmanifest.lua für FiveM (Kopieren-Einfügen-Beispiele)

Kurze Antwort: jeder FiveM-Ressourcen benötigt eine fxmanifest.lua Datei im Ressourcenordner. Sie teilt FXServer mit, für welches Spiel die Ressource geeignet ist, welche Skripte geladen werden sollen und welche Dateien an die Clients gehen. Unten findest du Copy-Paste-Beispiele für eine Standard-Skript-Ressource, Shared/Client/Server-Skripte, NUI-Ressourcen (ui_page + Dateien), und Karten (das_ist_eine_Karte 'ja' mit ymap-Streams), sowie Lösungen für häufige Manifest-Fehler.

Letzte Aktualisierung: 25. Juni 2026

Minimales fxmanifest.lua

fx_version 'cerulean' game 'gta5' client_script 'client.lua' server_script 'server.lua''

Die offizielle Ressourcenmanifest-Dokumentation von Cfx.re identifiziert fxmanifest.lua als die aktuelle Manifestdatei und vermerkt, dass alte __resource.lua Manifests sind veraltet. Verwende fx_version 'himmelblau' für moderne FiveM-Ressourcen, es sei denn, der Autor der Ressource dokumentiert eine andere Anforderung.

Vollständiges Beispiel mit Metadaten

fx_version 'cerulean'
game 'gta5'

author 'Dein Name'
description 'Beispiel FiveM-Ressource'
version '1.0.0'

lua54 'yes'

shared_script 'config.lua'
client_script 'client.lua'
server_script 'server.lua'

Der Autor, Beschreibung, Und Version Felder sind Metadaten: Sie ändern nicht, wie Skripte ausgeführt werden, aber FXServer gibt eine Konsolenwarnung wie “version ist erforderlich. Bitte gib eine Version in deinem fxmanifest.lua an.” aus, wenn Version fehlt. Füge eine Version '1.0.0' Zeile hinzu, um dies zu beheben. Die optionale lua54 'ja' Zeile aktiviert Lua 5.4 für die Ressource und ist für viele aktuelle Frameworks und Bibliotheken erforderlich.

Client-, Server- und gemeinsam genutzte Skripte

fx_version 'cerulean'
game 'gta5'

shared_scripts {
 'config.lua',
 '@ox_lib\/init.lua'
}

client_scripts {
 'client\/*.lua'
}

server_scripts {
 '@oxmysql\/lib\/MySQL.lua',
 'server\/*.lua'
}

Verwenden gemeinsam genutzte Skripte Nur für Dateien, die auf beiden Seiten sicher sind. Setze keine Server-Geheimnisse, Lizenzen, Datenbank-Passwörter oder Webhook-URLs in gemeinsame Dateien.

NUI-Ressourcenbeispiel

fx_version 'cerulean'
game 'gta5'

ui_page 'web\/index.html'

files {
 'web\/index.html',
 'web\/style.css',
 'web\/app.js'
}

client_script 'client.lua'

Wenn ein UI im Spiel leer ist, überprüfe, ob jede HTML-, CSS-, JavaScript-, Schriftart- und Bilddatei unter Dateien. Fehlende Dateien sind eine häufige Ursache für fehlerhafte NUI-Bildschirme.

Karten- oder MLO-Ressourcenbeispiel

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
 'stream\/*.ymap',
 'stream\/*.ytyp'
}

Für Karten und Innenräume sollten gestreamte Dateien in einem Strom Ordner aufgelistet ist und stelle sicher, dass die Ressource ohne Konsolenwarnungen startet. Wenn eine Karte nicht geladen wird, verwende die FiveM-Konsole und txAdmin-Protokolle, bevor du nicht verwandte Ressourcen bearbeitest.

Häufige Fehler

  • Verwenden von __resource.lua in einer neuen Ressource.
  • Putten server.lua unter Client-Skripte.
  • Vergessen von NUI-Dateien unter Dateien.
  • Geheimnisse darin aufbewahren gemeinsam genutzte Skripte.
  • Ordner mit Rechtschreibfehlern, insbesondere Kunde, Server, Und Strom.

Validierungscheckliste

  1. Der Ressourcenordner enthält fxmanifest.lua auf höchster Ebene.
  2. Spiel 'gta5' ist für FiveM vorhanden.
  3. Clientdateien werden auf dem Client geladen, Serverdateien auf dem Server.
  4. Jede NUI/statische Datei ist aufgelistet unter Dateien.
  5. server.cfg beinhaltet Ressourcennamen sicherstellen.

Verwandte Leitfäden

Abhängigkeitsreihenfolge in server.cfg

Das Manifest teilt FiveM mit, welche Dateien zu einer Ressource gehören, aber server.cfg Die Startreihenfolge wird weiterhin gesteuert. Gemeinsam genutzte Bibliotheken und Framework-Abhängigkeiten werden vor den Ressourcen gestartet, die diese verwenden.

ensure oxmysql ensure ox_lib ensure qb-core ensure my-script

Wenn eine Ressource beim Startup Export-Fehler auslöst, überprüfe, ob die Abhängigkeit installiert ist, korrekt benannt ist und vor dem Skript, das sie aufruft, gesichert ist.

Frameworkspezifische Hinweise

ESX-, QBCore- und Qbox-Ressourcen benötigen häufig Framework-Importe, Datenbankbibliotheken und Konfigurationsdateien. Die Framework-Konfiguration sollte in dokumentierten Dateien gespeichert werden. Wichtige Einstellungen dürfen nicht in beliebigen Clientdateien versteckt werden. Ein übersichtliches Manifest erleichtert den Support, da die Mitarbeiter alle geladenen Dateien einsehen können.

Checkliste vor der Veröffentlichung eines Drehbuchs prüfen

  • In freigegebenen oder Kundendateien werden keine Geheimnisse gespeichert.
  • Im Manifest sind keine ungenutzten Testdateien aufgeführt.
  • Alle NUI-Anlagen, die unter Dateien.
  • Abhängigkeiten sind in der README-Datei oder der Produktbeschreibung dokumentiert.
  • Die Ressource startet nach einem vollständigen Serverneustart einwandfrei.

Die Reihenfolge der Abhängigkeiten ist weiterhin wichtig

Das Manifest teilt FXServer mit, welche Dateien zu einer Ressource gehören, aber server.cfg steuert immer noch die Startreihenfolge. Starte Shared-Bibliotheken, Frameworks und Datenbankabhängigkeiten vor Skripten, die sie aufrufen. Wenn eine Ressource beim Booten Export-Fehler auslöst, überprüfe den Abhängigkeitsnamen und die Reihenfolge, bevor du das Skript selbst bearbeitest.

ensure oxmysql ensure ox_lib ensure qb-core ensure my-script

Überprüfung vor dem Ausliefern einer Ressource

Überprüfe, dass Client-Dateien keine Geheimnisse enthalten, Server-Dateien nicht an den Client gesendet werden, NUI-Assets unter Dateien, und Abhängigkeiten genau so benannt sind, wie sie installiert sind. Ein funktionierendes Manifest sollte die Ressource für einen anderen Entwickler verständlich machen, ohne jede Lua-Datei öffnen zu müssen.

Wenn ein Skript Framework-Exporte, Datenbankbibliotheken oder gemeinsame Konfigurationen verwendet, dokumentiere dies in der README oder den Produktnotizen. Die meisten Installationsprobleme entstehen durch fehlende Abhängigkeiten oder eine falsche Startreihenfolge, nicht durch die Manifest-Syntax selbst.

Nach der Bearbeitung des Manifests starte den gesamten Server einmal neu. Hot Reloads können fehlende Dateien oder Reihenfolgeprobleme verbergen, die erst bei einem sauberen Neustart auftreten.

Wenn der saubere Neustart fehlschlägt, lies den ersten Fehler, nicht die letzte Kaskade von Fehlern, nachdem die Abhängigkeiten bereits beschädigt sind.

fxmanifest.lua Schichten für Metadaten, Skripte, Abhängigkeiten und Dateien
Eine Ressourcenmanifest erklärt Metadaten, ausführbare Skripte, Abhängigkeiten und gepackte Dateien.

Lies ein fxmanifest in vier Schichten

  • Metadaten: Erkläre die FX-Version, das unterstützte Spiel und nützliche Autor-, Beschreibungs- und Versionsdetails.
  • Skripte: Trenne die Ausführung von Client, Server und Shared bewusst; setze keine serverseitige Logik den Clients aus.
  • Abhängigkeiten: Ressourcen oder Laufzeitbeschränkungen, die vorhanden sein müssen, bevor diese Ressource ausgeführt werden kann.
  • Dateien: beinhalten NUI und Datenressourcen, die Kunden benötigen. Cfx.re vermerkt, dass lokal ui_page und seine Abhängigkeiten referenziert werden müssen in Dateien.

Die Manifestdatei ist semi-deklaratives Lua, das separat von den Ressourcenskripten ausgeführt wird. Halte es explizit, entferne veraltete Einträge und überprüfe jeden referenzierten Pfad auf einem case-sensitiven Produktionsdateisystem.

Cfx.re Ressourcen-Manifest Referenz

Schreibe einen Kommentar