FiveM için fxmanifest.lua Kurulumu

Hızlı cevap: 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.

Son güncelleme: 25 Haziran 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 __kaynak.lua manifests are deprecated. Use fx_version 'gök mavisi' 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'
}

Kullanmak 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 dosyalar. 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 aktarım 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.

Yaygın hatalar

• Kullanarak __kaynak.lua in a new resource.
• Putting sunucu.lua altında istemci_komut_belgeleri.
• Forgetting NUI files under dosyalar.
• Putting secrets inside shared_scripts.
• Misspelling folders, especially müşteri, sunucu, Ve aktarım.

Validation checklist

1. Resource folder has fxmanifest.lua at the top level.
2. oyun '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 dosyalar.
5. sunucu.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