Setting Up fxmanifest.lua for FiveM

Risposta rapida: every modern FiveM resource should include an fxmanifest.lua file in the resource folder. It tells FXServer which game the resource supports, which scripts to load, and which files must be sent to clients.

Ultimo aggiornamento: 25 giugno 2026

Minimal fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

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

Cfx.re’s official resource manifest documentation identifies fxmanifest.lua as the current manifest file and notes that old __resource.lua manifests are deprecated. Use fx_version 'ceruleo' for modern FiveM resources unless a resource author documents a different requirement.

Client, server, and shared 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'
}

Utilizzo shared_scripts only for files that are safe on both sides. Do not put server secrets, license keys, database passwords, or webhook URLs into shared files.

NUI resource example

fx_version 'cerulean'
game 'gta5'

ui_page 'web/index.html'

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

client_script 'client.lua'

If a UI is blank in game, check that every HTML, CSS, JavaScript, font, and image file is listed under file. Missing files are a common cause of broken NUI screens.

Map or MLO resource example

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

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

For maps and interiors, keep streamed files in a flusso folder and verify the resource starts without console warnings. If a map does not load, use the FiveM console and txAdmin logs before editing unrelated resources.

Errori comuni

• Utilizzo __resource.lua in a new resource.
• Putting server.lua Sotto script_client.
• Forgetting NUI files under file.
• Putting secrets inside shared_scripts.
• Misspelling folders, especially cliente, server, E flusso.

Validation checklist

1. Resource folder has fxmanifest.lua at the top level.
2. gioco 'gta5' is present for FiveM.
3. Client files load on the client, server files load on the server.
4. Every NUI/static file is listed under file.
5. server.cfg includes ensure resource-name.

Related guides

• Introduction to Lua scripting for FiveM
• How to write FiveM scripts using AI
• How to check txAdmin logs

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