Wat moet fxmanifest.lua bevatten?

fx_version, game, je client/server/gedeelde scripts, en bestanden die je streamt.

Wat is client vs server vs shared?

Client draait op spelers, server draait op de host, gedeelde belasting op beide.

Hoe declareer ik afhankelijkheden?

Gebruik dependency 'name' of dependencies {'a','b'} en zorg voor de volgorde in server.cfg.

Hoe stream ik assets?

Plaats assets in /stream en vermeld de bestanden zoals vereist door het brontype.

Waarom lua54 'yes' toevoegen?

Het maakt Lua 5.4-functies en prestatieverbeteringen mogelijk.

Veelvoorkomende manifestfouten?

Verkeerde paden of namen, ontbrekende komma's, ongeldige fx_version, of onjuiste mapnaam.

Hoe functies exporteren/importeren?

Gebruik exports/server_exports in het manifest en roep aan via exports['resourcename']:function().

Hoe zit het met maps/MLOs?

Gebruik this_is_a_map 'yes' en declareer data_file entries voor YTYPs indien nodig.

fxmanifest.lua in FiveM: Setup & Copy-Paste Examples

Snel antwoord: 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 'yes' with ymap streams), plus fixes for common manifest errors.

Laatst bijgewerkt: 25 juni 2026

Minimale fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

De officiële documentatie van de resource manifesten van Cfx.re identificeert fxmanifest.lua als het huidige manifestbestand en merkt op dat oude __resource.lua manifests zijn verouderd. Gebruik fx_version 'cerulean' voor moderne FiveM resources, tenzij een resource-auteur een andere vereiste documenteert.

Complete example with metadata

fx_version 'cerulean'
game 'gta5'

author 'Your Name'
description 'Example FiveM resource'
version '1.0.0'

lua54 'yes'

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

De author, description, en version fields are metadata: they do not change how scripts run, but FXServer prints a console warning such as “version is required. please specify a version in your fxmanifest.lua.” when version is missing. Add a version '1.0.0' line to clear it. The optional lua54 'yes' line enables Lua 5.4 for the resource and is required by many current frameworks and libraries.

Client-, server- en gedeelde scripts

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'
}

Gebruik shared_scripts alleen voor bestanden die aan beide kanten veilig zijn. Plaats geen servergeheimen, licentiesleutels, databasewachtwoorden of webhook-URL's in gedeelde bestanden.

NUI bronnenvoorbeeld

fx_version 'cerulean'
game 'gta5'

ui_page 'web/index.html'

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

client_script 'client.lua'

Als een UI leeg is in het spel, controleer dan of elk HTML, CSS, JavaScript, lettertype en afbeeldingsbestand is vermeld onder files. Ontbrekende bestanden zijn een veelvoorkomende oorzaak van kapotte NUI schermen.

Voorbeeld van een Map of MLO resource

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

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

Houd voor kaarten en interieurs gestreamde bestanden in een stream map en verifieer dat de bron zonder consolewaarschuwingen start. Als een kaart niet laadt, gebruik dan de FiveM console en txAdmin logs voordat u ongerelateerde bronnen bewerkt.

Veelgemaakte fouten

Gebruik van __resource.lua in een nieuwe resource.
Plaatsen server.lua onder client_scripts.
NUI bestanden vergeten onder files.
Geheimen in de broncode plaatsen shared_scripts.
Vooral mappen verkeerd spellen client, server, en stream.

Validatiechecklist

Resourcemap heeft fxmanifest.lua op het hoogste niveau.
game 'gta5' is aanwezig voor FiveM.
Clientbestanden laden op de client, serverbestanden laden op de server.
Elk NUI/static-bestand staat vermeld onder files.
server.cfg bevat ensure resource-name.

Gerelateerde handleidingen

Afhankelijkheidsvolgorde in server.cfg

Het manifest vertelt FiveM welke bestanden bij een resource horen, maar server.cfg bepaalt nog steeds de startvolgorde. Start gedeelde bibliotheken en framework-afhankelijkheden vóór resources die ze gebruiken.

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

Als een resource exportfouten geeft bij het opstarten, controleer dan of de afhankelijkheid is geïnstalleerd, correct is benoemd en is ingeschakeld vóór het script dat deze aanroept.

Frameworkspecifieke opmerkingen

ESX-, QBCore- en Qbox-resources hebben vaak framework-imports, databasebibliotheken en configuratiebestanden nodig. Houd framework-instellingen in gedocumenteerde bestanden. Verberg geen belangrijke instellingen in willekeurige clientbestanden. Een schoon manifest maakt ondersteuning eenvoudiger omdat medewerkers elk bestand kunnen zien dat wordt geladen.

Controleer de checklist voordat je een script publiceert

Geen geheimen in gedeelde of clientbestanden.
Geen ongebruikte testbestanden vermeld in het manifest.
Alle NUI-assets vermeld onder files.
Afhankelijkheden gedocumenteerd in de README of productbeschrijving.
Resource start schoon na een volledige serverherstart.

Volgorde van afhankelijkheden is nog steeds belangrijk

Het manifest vertelt FXServer welke bestanden bij een resource horen, maar server.cfg bepaalt nog steeds de startvolgorde. Start gedeelde bibliotheken, frameworks en databaseafhankelijkheden vóór scripts die ernaar verwijzen. Als een resource exportfouten genereert bij het opstarten, controleer dan de afhankelijkheidsnaam en -volgorde voordat u het script zelf bewerkt.

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

Beoordeel voordat u een bron verzendt

Controleer of clientbestanden geen geheimen bevatten, serverbestanden niet naar de client worden verzonden, NUI-assets worden vermeld onder files, en afhankelijkheden exact zo worden benoemd als ze zijn geïnstalleerd. Een werkend manifest moet de resource begrijpelijk maken voor een andere ontwikkelaar zonder elk Lua-bestand te openen.

Als een script framework-exports, databasebibliotheken of gedeelde configuratie gebruikt, documenteer dit dan in de README of productnotities. De meeste installatieproblemen komen voort uit ontbrekende afhankelijkheden of een onjuiste startvolgorde, niet uit de manifestsyntaxis zelf.

Na het bewerken van het manifest, herstart de volledige server eenmaal. Hot reloads kunnen ontbrekende bestanden of volgorde problemen verbergen die alleen verschijnen bij een schone opstart.

Als de schone opstart mislukt, lees dan de eerste fout, niet de laatste reeks fouten nadat de afhankelijkheden al verbroken zijn.

fxmanifest.lua layers for metadata, scripts, dependencies and files — A resource manifest declares metadata, executable scripts, dependencies and packaged files.

Read an fxmanifest in four layers

Metadata: declare the FX version, supported game and useful author, description and version details.
Scripts: separate client, server and shared execution deliberately; do not expose server-only logic to clients.
Afhankelijkheden: state resources or runtime constraints that must exist before this resource can run.
Bestanden: include NUI and data assets that clients need. Cfx.re notes that a local ui_page and its dependencies must be referenced in files.

The manifest is semi-declarative Lua executed separately from the resource scripts. Keep it explicit, remove obsolete entries, and verify every referenced path on a case-sensitive production filesystem.

Cfx.re resource-manifest reference

Editorial review and source policy

The manifest examples were retained because they match the current Cfx.re resource-manifest model. The official manifest reference is the authority for directives, and deprecated __resource.lua examples must not be introduced.