Setting Up fxmanifest.lua for FiveM (Copy-Paste Examples)

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

Son güncelleme: 25 Haziran 2026

Minimal fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

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

Cfx.re'nin resmi kaynak manifesti belgeleri tanımlar fxmanifest.lua mevcut manifest dosyasını ve eski notları __resource.lua manifestler kullanım dışıdır. Kullanın fx_version 'cerulean' modern FiveM kaynakları için, kaynak yazarı farklı bir gereksinim belgelemediği sürece.

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'

The author, description, Ve 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.

İstemci, sunucu ve paylaşılan betikler

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 yalnızca her iki tarafta da güvenli olan dosyalar için. Sunucu sırlarını, lisans anahtarlarını, veritabanı parolalarını veya webhook URL'lerini paylaşılan dosyalara koymayın.

NUI kaynak örneği

fx_version 'cerulean'
game 'gta5'

ui_page 'web/index.html'

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

client_script 'client.lua'

Oyunda UI boşsa, her HTML, CSS, JavaScript, yazı tipi ve resim dosyasının altında listelendiğinden emin olun files. Eksik dosyalar, bozuk NUI ekranlarının yaygın bir nedenidir.

Harita veya MLO kaynak örneği

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

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

Haritalar ve iç mekanlar için, akışa alınan dosyaları bir stream klasörünüze ekleyin ve kaynağın konsol uyarıları olmadan başladığını doğrulayın. Bir harita yüklenmezse, ilgisiz kaynakları düzenlemeden önce FiveM konsolunu ve txAdmin günlüklerini kullanın.

Yaygın hatalar

• Kullanarak __resource.lua yeni bir kaynakta.
• Koyma server.lua altında client_scripts.
• NUI dosyalarını altında unutmak files.
• Gizlileri içine koymak shared_scripts.
• Klasörlerin yanlış yazılması, özellikle client, server, Ve stream.

Doğrulama kontrol listesi

1. Kaynak klasöründe fxmanifest.lua en üst düzeyde.
2. game 'gta5' FiveM için mevcuttur.
3. İstemci dosyaları istemcide, sunucu dosyaları sunucuda yüklenir.
4. Her NUI/statik dosya altında listelenir files.
5. server.cfg içerir ensure resource-name.

İlgili kılavuzlar

• FiveM için Lua betik oluşturmaya giriş
• Yapay zeka kullanarak FiveM betikleri nasıl yazılır
• txAdmin günlükleri nasıl kontrol edilir

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

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

Read an fxmanifest in four layers

• Metadata: declare the FX version, supported game and useful author, description and version details.
• Komut dosyaları: separate client, server and shared execution deliberately; do not expose server-only logic to clients.
• Bağımlılıklar: state resources or runtime constraints that must exist before this resource can run.
• Dosyalar: 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.