{"id":162266,"date":"2024-10-11T19:42:29","date_gmt":"2024-10-11T17:42:29","guid":{"rendered":"https:\/\/hifivem.com\/?p=162266"},"modified":"2026-07-20T12:36:25","modified_gmt":"2026-07-20T10:36:25","slug":"einrichten-von-fxmanifest-lua-fivem","status":"publish","type":"post","link":"https:\/\/fivemx.com\/de\/einrichten-von-fxmanifest-lua-fivem\/","title":{"rendered":"Einrichten von fxmanifest.lua f\u00fcr FiveM (Kopieren-Einf\u00fcgen-Beispiele)"},"content":{"rendered":"<p><strong>Kurze Antwort:<\/strong> jeder FiveM-Ressourcen ben\u00f6tigt eine <code>fxmanifest.lua<\/code> Datei im Ressourcenordner. Sie teilt FXServer mit, f\u00fcr 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\u00fcr eine Standard-Skript-Ressource, Shared\/Client\/Server-Skripte, NUI-Ressourcen (<code>ui_page<\/code> + <code>Dateien<\/code>), und Karten (<code>das_ist_eine_Karte &#039;ja&#039;<\/code> mit ymap-Streams), sowie L\u00f6sungen f\u00fcr h\u00e4ufige Manifest-Fehler.<\/p>\n<p><em>Letzte Aktualisierung: 25. Juni 2026<\/em><\/p>\n<h2>Minimales fxmanifest.lua<\/h2>\n<pre><code>fx_version &#039;cerulean&#039; game &#039;gta5&#039; client_script &#039;client.lua&#039; server_script &#039;server.lua&#039;'<\/code><\/pre>\n<p>Die offizielle Ressourcenmanifest-Dokumentation von Cfx.re identifiziert <code>fxmanifest.lua<\/code> als die aktuelle Manifestdatei und vermerkt, dass alte <code>__resource.lua<\/code> Manifests sind veraltet. Verwende <code>fx_version &#039;himmelblau&#039;<\/code> f\u00fcr moderne FiveM-Ressourcen, es sei denn, der Autor der Ressource dokumentiert eine andere Anforderung.<\/p>\n<h2>Vollst\u00e4ndiges Beispiel mit Metadaten<\/h2>\n<pre><code>fx_version 'cerulean'\ngame 'gta5'\n\nauthor 'Dein Name'\ndescription 'Beispiel FiveM-Ressource'\nversion '1.0.0'\n\nlua54 'yes'\n\nshared_script 'config.lua'\nclient_script 'client.lua'\nserver_script 'server.lua'<\/code><\/pre>\n<p>Der <code>Autor<\/code>, <code>Beschreibung<\/code>, Und <code>Version<\/code> Felder sind Metadaten: Sie \u00e4ndern nicht, wie Skripte ausgef\u00fchrt werden, aber FXServer gibt eine Konsolenwarnung wie \u201cversion ist erforderlich. Bitte gib eine Version in deinem fxmanifest.lua an.\u201d aus, wenn <code>Version<\/code> fehlt. F\u00fcge eine <code>Version &#039;1.0.0&#039;<\/code> Zeile hinzu, um dies zu beheben. Die optionale <code>lua54 &#039;ja&#039;<\/code> Zeile aktiviert Lua 5.4 f\u00fcr die Ressource und ist f\u00fcr viele aktuelle Frameworks und Bibliotheken erforderlich.<\/p>\n<h2>Client-, Server- und gemeinsam genutzte Skripte<\/h2>\n<pre><code>fx_version 'cerulean'\ngame 'gta5'\n\nshared_scripts {\n 'config.lua',\n '@ox_lib\\\/init.lua'\n}\n\nclient_scripts {\n 'client\\\/*.lua'\n}\n\nserver_scripts {\n '@oxmysql\\\/lib\\\/MySQL.lua',\n 'server\\\/*.lua'\n}<\/code><\/pre>\n<p>Verwenden <code>gemeinsam genutzte Skripte<\/code> Nur f\u00fcr Dateien, die auf beiden Seiten sicher sind. Setze keine Server-Geheimnisse, Lizenzen, Datenbank-Passw\u00f6rter oder Webhook-URLs in gemeinsame Dateien.<\/p>\n<h2>NUI-Ressourcenbeispiel<\/h2>\n<pre><code>fx_version 'cerulean'\ngame 'gta5'\n\nui_page 'web\\\/index.html'\n\nfiles {\n 'web\\\/index.html',\n 'web\\\/style.css',\n 'web\\\/app.js'\n}\n\nclient_script 'client.lua'<\/code><\/pre>\n<p>Wenn ein UI im Spiel leer ist, \u00fcberpr\u00fcfe, ob jede HTML-, CSS-, JavaScript-, Schriftart- und Bilddatei unter <code>Dateien<\/code>. Fehlende Dateien sind eine h\u00e4ufige Ursache f\u00fcr fehlerhafte NUI-Bildschirme.<\/p>\n<h2>Karten- oder MLO-Ressourcenbeispiel<\/h2>\n<pre><code>fx_version 'cerulean'\ngame 'gta5'\n\nthis_is_a_map 'yes'\n\nfiles {\n 'stream\\\/*.ymap',\n 'stream\\\/*.ytyp'\n}<\/code><\/pre>\n<p>F\u00fcr Karten und Innenr\u00e4ume sollten gestreamte Dateien in einem <code>Strom<\/code> 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.<\/p>\n<h2>H\u00e4ufige Fehler<\/h2>\n<ul>\n<li>Verwenden von <code>__resource.lua<\/code> in einer neuen Ressource.<\/li>\n<li>Putten <code>server.lua<\/code> unter <code>Client-Skripte<\/code>.<\/li>\n<li>Vergessen von NUI-Dateien unter <code>Dateien<\/code>.<\/li>\n<li>Geheimnisse darin aufbewahren <code>gemeinsam genutzte Skripte<\/code>.<\/li>\n<li>Ordner mit Rechtschreibfehlern, insbesondere <code>Kunde<\/code>, <code>Server<\/code>, Und <code>Strom<\/code>.<\/li>\n<\/ul>\n<h2>Validierungscheckliste<\/h2>\n<ol>\n<li>Der Ressourcenordner enth\u00e4lt <code>fxmanifest.lua<\/code> auf h\u00f6chster Ebene.<\/li>\n<li><code>Spiel &#039;gta5&#039;<\/code> ist f\u00fcr FiveM vorhanden.<\/li>\n<li>Clientdateien werden auf dem Client geladen, Serverdateien auf dem Server.<\/li>\n<li>Jede NUI\/statische Datei ist aufgelistet unter <code>Dateien<\/code>.<\/li>\n<li><code>server.cfg<\/code> beinhaltet <code>Ressourcennamen sicherstellen<\/code>.<\/li>\n<\/ol>\n<h2>Verwandte Leitf\u00e4den<\/h2>\n<ul>\n<li><a href=\"https:\/\/fivemx.com\/de\/einfuhrung-in-lua-scripting\/\">Einf\u00fchrung in die Lua-Skripterstellung f\u00fcr FiveM<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/de\/fivem-skripte-mit-ki-schreiben\/\">Wie man FiveM-Skripte mithilfe von KI schreibt<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/de\/so-uberprufen-sie-die-txadmin-protokolle-auf-fehler\/\">Wie man txAdmin-Protokolle \u00fcberpr\u00fcft<\/a><\/li>\n<\/ul>\n<section data-fivemx-rework-extra=\"2026-06-25\">\n<h2>Abh\u00e4ngigkeitsreihenfolge in server.cfg<\/h2>\n<p>Das Manifest teilt FiveM mit, welche Dateien zu einer Ressource geh\u00f6ren, aber <code>server.cfg<\/code> Die Startreihenfolge wird weiterhin gesteuert. Gemeinsam genutzte Bibliotheken und Framework-Abh\u00e4ngigkeiten werden vor den Ressourcen gestartet, die diese verwenden.<\/p>\n<pre><code>ensure oxmysql ensure ox_lib ensure qb-core ensure my-script<\/code><\/pre>\n<p>Wenn eine Ressource beim Startup Export-Fehler ausl\u00f6st, \u00fcberpr\u00fcfe, ob die Abh\u00e4ngigkeit installiert ist, korrekt benannt ist und vor dem Skript, das sie aufruft, gesichert ist.<\/p>\n<h2>Frameworkspezifische Hinweise<\/h2>\n<p>ESX-, QBCore- und Qbox-Ressourcen ben\u00f6tigen h\u00e4ufig Framework-Importe, Datenbankbibliotheken und Konfigurationsdateien. Die Framework-Konfiguration sollte in dokumentierten Dateien gespeichert werden. Wichtige Einstellungen d\u00fcrfen nicht in beliebigen Clientdateien versteckt werden. Ein \u00fcbersichtliches Manifest erleichtert den Support, da die Mitarbeiter alle geladenen Dateien einsehen k\u00f6nnen.<\/p>\n<h2>Checkliste vor der Ver\u00f6ffentlichung eines Drehbuchs pr\u00fcfen<\/h2>\n<ul>\n<li>In freigegebenen oder Kundendateien werden keine Geheimnisse gespeichert.<\/li>\n<li>Im Manifest sind keine ungenutzten Testdateien aufgef\u00fchrt.<\/li>\n<li>Alle NUI-Anlagen, die unter <code>Dateien<\/code>.<\/li>\n<li>Abh\u00e4ngigkeiten sind in der README-Datei oder der Produktbeschreibung dokumentiert.<\/li>\n<li>Die Ressource startet nach einem vollst\u00e4ndigen Serverneustart einwandfrei.<\/li>\n<\/ul>\n<\/section>\n<section data-fivemx-quality-wave=\"2026-07-01:162266\">\n<h2>Die Reihenfolge der Abh\u00e4ngigkeiten ist weiterhin wichtig<\/h2>\n<p>Das Manifest teilt FXServer mit, welche Dateien zu einer Ressource geh\u00f6ren, aber <code>server.cfg<\/code> steuert immer noch die Startreihenfolge. Starte Shared-Bibliotheken, Frameworks und Datenbankabh\u00e4ngigkeiten vor Skripten, die sie aufrufen. Wenn eine Ressource beim Booten Export-Fehler ausl\u00f6st, \u00fcberpr\u00fcfe den Abh\u00e4ngigkeitsnamen und die Reihenfolge, bevor du das Skript selbst bearbeitest.<\/p>\n<pre><code>ensure oxmysql ensure ox_lib ensure qb-core ensure my-script<\/code><\/pre>\n<h2>\u00dcberpr\u00fcfung vor dem Ausliefern einer Ressource<\/h2>\n<p>\u00dcberpr\u00fcfe, dass Client-Dateien keine Geheimnisse enthalten, Server-Dateien nicht an den Client gesendet werden, NUI-Assets unter <code>Dateien<\/code>, und Abh\u00e4ngigkeiten genau so benannt sind, wie sie installiert sind. Ein funktionierendes Manifest sollte die Ressource f\u00fcr einen anderen Entwickler verst\u00e4ndlich machen, ohne jede Lua-Datei \u00f6ffnen zu m\u00fcssen.<\/p>\n<p>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\u00e4ngigkeiten oder eine falsche Startreihenfolge, nicht durch die Manifest-Syntax selbst.<\/p>\n<p>Nach der Bearbeitung des Manifests starte den gesamten Server einmal neu. Hot Reloads k\u00f6nnen fehlende Dateien oder Reihenfolgeprobleme verbergen, die erst bei einem sauberen Neustart auftreten.<\/p>\n<p>Wenn der saubere Neustart fehlschl\u00e4gt, lies den ersten Fehler, nicht die letzte Kaskade von Fehlern, nachdem die Abh\u00e4ngigkeiten bereits besch\u00e4digt sind.<\/p>\n<\/section>\n<section data-fivemx-layout-content-perfection=\"2026-07-11\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/fivemx.com\/wp-content\/uploads\/2026\/07\/162266-fxmanifest-anatomy.webp\" alt=\"fxmanifest.lua Schichten f\u00fcr Metadaten, Skripte, Abh\u00e4ngigkeiten und Dateien\" width=\"1600\" height=\"900\"><figcaption>Eine Ressourcenmanifest erkl\u00e4rt Metadaten, ausf\u00fchrbare Skripte, Abh\u00e4ngigkeiten und gepackte Dateien.<\/figcaption><\/figure>\n<h2>Lies ein fxmanifest in vier Schichten<\/h2>\n<ul>\n<li><strong>Metadaten:<\/strong> Erkl\u00e4re die FX-Version, das unterst\u00fctzte Spiel und n\u00fctzliche Autor-, Beschreibungs- und Versionsdetails.<\/li>\n<li><strong>Skripte:<\/strong> Trenne die Ausf\u00fchrung von Client, Server und Shared bewusst; setze keine serverseitige Logik den Clients aus.<\/li>\n<li><strong>Abh\u00e4ngigkeiten:<\/strong> Ressourcen oder Laufzeitbeschr\u00e4nkungen, die vorhanden sein m\u00fcssen, bevor diese Ressource ausgef\u00fchrt werden kann.<\/li>\n<li><strong>Dateien:<\/strong> beinhalten NUI und Datenressourcen, die Kunden ben\u00f6tigen. Cfx.re vermerkt, dass lokal <code>ui_page<\/code> und seine Abh\u00e4ngigkeiten referenziert werden m\u00fcssen in <code>Dateien<\/code>.<\/li>\n<\/ul>\n<p>Die Manifestdatei ist semi-deklaratives Lua, das separat von den Ressourcenskripten ausgef\u00fchrt wird. Halte es explizit, entferne veraltete Eintr\u00e4ge und \u00fcberpr\u00fcfe jeden referenzierten Pfad auf einem case-sensitiven Produktionsdateisystem.<\/p>\n<p><a href=\"https:\/\/docs.fivem.net\/docs\/scripting-reference\/resource-manifest\/\" rel=\"nofollow noopener\" target=\"_blank\">Cfx.re Ressourcen-Manifest Referenz<\/a><\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Fast answer: every FiveM resource needs an fxmanifest.lua file in the resource folder. It tells FXServer which game the resource supports, which scripts to load, and which files go to clients. Below are copy-paste examples for a standard script resource, shared\/client\/server scripts, NUI resources (ui_page + files), and maps (this_is_a_map &#8216;yes&#8217; with ymap streams), plus [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":162267,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2340,1899],"tags":[3001],"class_list":["post-162266","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-lua-scripting","category-tutorials","tag-fivem-script"],"_links":{"self":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/162266","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/comments?post=162266"}],"version-history":[{"count":6,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/162266\/revisions"}],"predecessor-version":[{"id":213809,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/162266\/revisions\/213809"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/media\/162267"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/media?parent=162266"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/categories?post=162266"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/tags?post=162266"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}