fxmanifest.lua Rehberi: FiveM Resource Manifest'inde Uzmanlaşın

fxmanifest.lua nedir?

Her FiveM resource'u, sunucuya resource'un ne içerdiğini ve nasıl yükleneceğini bildiren bir manifest dosyası gerektirir. Bu fxmanifest.lua dosyası, daha eski olan şu dosyanın yerini alır: __resource.lua formatındadır ve resource meta verilerinizi tanımlamak için temiz, bildirimsel bir yol sunar. Bu dosya: Hangi script'lerin client tarafında, hangilerinin server tarafında çalışacağını, hangi NUI dosyalarının dahil edileceğini, resource bağımlılıklarını ve ek meta verileri belirtir. Manifest dosyanızı doğru yapılandırmak çok önemlidir, çünkü buradaki hatalar tüm resource'unuzun yüklenmesini engelleyebilir.

Zorunlu Alanlar

Her manifest iki zorunlu alanla başlamalıdır: fx_version ve games. İlgili fx_version manifest formatı sürümünü belirtir, 'cerulean' tüm modern özellikleri destekleyen güncel standarttır. games alanı, resource'un hangi oyunu desteklediğini tanımlar, tipik olarak {'gta5'} FiveM için geçerlidir. Bu alanlardan herhangi birinin atlanması, resource'un tamamen yüklenememesine neden olur, bu nedenle bunları her zaman manifest'inizin ilk iki satırı olarak ekleyin.

Script Bildirimleri

Kullanın client_scripts, server_scripts, ve shared_scripts Lua dosyalarınızı bildirmek için. Client script'leri oyuncunun oyun istemcisinde çalışır ve render, girdi ile yerel oyun etkileşimlerini yönetir. Server script'leri sunucuda çalışır ve yetkili mantığı, veritabanı işlemlerini ve oyuncu yönetimini yürütür. Shared script'ler her iki tarafta da çalışır ve yapılandırma dosyaları, yardımcı işlevler ve ortak sabitler için kullanışlıdır. Şu tür glob modelleri kullanabilirsiniz: 'client/*.lua' bir dizindeki tüm dosyaları dahil etmek için, ancak açıkça belirtilen dosya listeleri yükleme sırası üzerinde kontrol sahibi olmanızı sağlar.

NUI ve Dosya Bildirimleri

Kaynağınız bir kullanıcı arayüzü içeriyorsa, giriş HTML dosyasını şununla bildirin: ui_page 'html/index.html'. Ardından arayüzünüzün ihtiyaç duyduğu tüm web varlıklarını şurada listeleyin: files HTML, CSS, JavaScript, resimler ve yazı tipleri dahil tablo. Yalnızca burada listelenen dosyalar NUI tarayıcısı tarafından erişilebilir olacaktır. Şunun gibi glob kalıpları kullanın: 'html/**/*' tüm dizinleri dahil etmek için. NUI dosyalarının resource yüklenmesi sırasında istemciye gönderildiğini unutmayın, bu nedenle indirme sürelerini ve bant genişliği kullanımını azaltmak için web varlıklarınızı optimize edin.

Bağımlılıklar ve Yükleme Sırası

Resource bağımlılıklarını şununla bildirin: dependencies gerekli resource'ların sizinkinden önce başlatılmasını sağlayan alan. Yaygın bağımlılıklar arasında şu framework resource'ları yer alır: qb-core veya es_extended, şu gibi veritabanı kaynakları: oxmysql, ve paylaşılan kütüphaneler. Bir bağımlılık başlatılmazsa kaynağınız yüklenemez ve bir uyarı günlüğe kaydeder. Şunu kullanın: provide resource'unuzun bir başkasının yerine geçtiğini belirtmek için, bu da framework köprüleri veya yaygın script'lerin alternatif uygulamalarını oluştururken kullanışlıdır.

Gelişmiş Manifest Özellikleri

Manifest, özel kullanım durumları için birkaç ek direktifi destekler. Şunu kullanın: data_file silah meta'ları, handling dosyaları veya araç model verileri gibi GTA veri dosyalarını yüklemek için. Bu export ve server_export alanları, diğer resource'ların çağırabileceği fonksiyonları bildirir. Şununla meta veri ekleyin: description, author, ve version belgelendirme amaçlı alanlar. lua54 yönergesi, şu şekilde ayarlandığında Lua 5.4 özelliklerini etkinleştirir: 'yes', karmaşık script'leri basitleştirebilecek tamsayı bölme, bit düzeyinde işleçler ve diğer dil iyileştirmelerine erişmenizi sağlar.