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.

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: Installatie & Kopieer-Plak Voorbeelden

Snel antwoord: elke FiveM-resource heeft een fxmanifest.lua bestand nodig in de resourcefolder. Het vertelt FXServer welke game de resource ondersteunt, welke scripts geladen moeten worden en welke bestanden naar clients gaan. Hieronder staan kopieer-en-plakvoorbeelden voor een standaard scriptresource, gedeelde/client/server-scripts, NUI-resources (ui_page + files), en maps (this_is_a_map 'yes' met ymap-streams), plus fixes voor veelvoorkomende manifestfouten.

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.

Compleet voorbeeld met 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 velden zijn metadata: ze veranderen niet hoe scripts draaien, maar FXServer geeft een consolewaarschuwing zoals “versie is vereist. specificeer een versie in je fxmanifest.lua.” wanneer version ontbreekt. Voeg een version '1.0.0' regel toe om het op te lossen. De optionele lua54 'yes' regel activeert Lua 5.4 voor de resource en is vereist door veel huidige frameworks en bibliotheken.

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 lagen voor metadata, scripts, afhankelijkheden en bestanden — Een resource-manifest declareert metadata, uitvoerbare scripts, afhankelijkheden en verpakte bestanden.

Lees een fxmanifest in vier lagen

Metadata: declareer de FX-versie, ondersteunde game en nuttige auteur-, beschrijvings- en versiegegevens.
Scripts: scheid client-, server- en gedeelde uitvoering bewust; stel geen server-only logica bloot aan clients.
Afhankelijkheden: vermeld bronnen of runtime-beperkingen die moeten bestaan voordat deze bron kan worden uitgevoerd.
Bestanden: neem NUI en data-assets op die clients nodig hebben. Cfx.re merkt op dat een lokale ui_page en de afhankelijkheden ervan moeten worden vermeld in files.

Het manifest is semi-declaratief Lua wordt apart van de bronscripts uitgevoerd. Houd het expliciet, verwijder verouderde vermeldingen en verifieer elk genoemd pad op een hoofdlettergevoelig productiesysteem.

Cfx.re resource-manifest referentie

Redactionele beoordeling en bronbeleid

De manifestvoorbeelden zijn behouden omdat ze overeenkomen met het huidige Cfx.re bron-manifestmodel. De officiële manifestreferentie is de autoriteit voor richtlijnen, en verouderde __resource.lua voorbeelden mogen niet worden geïntroduceerd.