FiveM scriptlerini kurmak için kaynağı resources/ klasörüne koyarsın, server.cfg içinde ensure ile başlatırsın ve ESX, QBCore ya da veritabanı sürücüleri gibi bağımlılıkları önceden yüklersin. Önemli olan temiz bir klasör yapısı, doğru başlatma sırası, kontrol edilmiş bir SQL içe aktarma işlemi ve yeniden başlatmadan sonra sunucu konsoluna bakmaktır.
Gereksinimler
Sunucu dosyalarına, server.cfg dosyasına, sunucu konsoluna ve script veritabanı tabloları kullanıyorsa MySQL ya da MariaDB veritabanına erişimin olmalı. Kiralık bir FiveM Server'da bunlara genellikle bir dosya yöneticisi, FTP/SFTP ve phpMyAdmin ya da Adminer gibi bir veritabanı aracı dahildir. Sunucunun tamamını henüz planlıyorsan, dahili rehber FiveM Server Kiralama ve Kurulum temel yapı konusunda yardımcı olur.
FiveM, scriptlere teknik olarak kaynak (resource) der. Resmi Cfx.re dokümantasyonuna göre fxmanifest.lua, bir kaynağa hangi dosyaların, scriptlerin ve meta verilerin ait olduğunu tanımlar. Bu yüzden önce çıkarılan klasörde geçerli bir manifest dosyası olup olmadığını kontrol et. Manifest olmadan sunucu kaynağı doğru şekilde yükleyemez.
Script Yapısını Kontrol Etme
Tipik bir FiveM kaynağı şöyle görünür:
mein_script/
├── fxmanifest.lua # Manifest-Datei
├── client.lua # Client-Code
├── server.lua # Server-Code
├── config.lua # Konfiguration
└── html/ # NUI (Web-Interface)
Yanlışlıkla fazladan bir paketleme klasörü yüklememeye dikkat et. Kaynak aslında doğrudan resources/mein_script/fxmanifest.lua altında olmalıyken resources/mein_script-main/mein_script/fxmanifest.lua yanlış olur. Çıkardıktan sonra klasörü aç ve fxmanifest.lua dosyasının bulunduğu seviyeyi kontrol et.
Script Kurulumu
- Scripti indir
resources/klasörüne çıkarserver.cfgdosyasına ekle:
ensure mein_script
- Sunucuyu yeniden başlat
Kaynak adı olarak tam olarak klasör adını ya da README'nin belirttiği adı kullan. Birçok hata farklı yazımlardan, klasör adındaki boşluklardan veya özel karakterlerden kaynaklanır. Küçük harfli, tire veya alt çizgi içeren kısa adlar önerilir.
ESX Scriptlerini Kurma
ESX scriptleri, ESX tabanının ve gerekli ek kaynakların önceden başlatılmasına bağlıdır. Kesin sıra ESX sürümüne ve scripte göre değişebilir, bu yüzden şunu yap: scriptin README'sini kontrol et ve mevcut framework dokümantasyonuna dikkat et.
# Basis ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Jobs
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob
# Features
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property
Bir meslek scripti kendi veritabanı tablolarını veya eşyalarını bekliyorsa, birlikte gelen SQL dosyasını ilk canlı başlatmadan önce içe aktar. Öncesinde veritabanının yedeğini al. Mevcut roleplay sunucularında SQL dosyaları, kurulumuna uyarlanmamışsa sütunların, eşyaların veya mesleklerin üzerine yazabilir.
QBCore Scriptlerini Kurma
QBCore kaynakları, bağımlılıklarına framework'ten ya da ilgili scriptten önce ihtiyaç duyar. Aşağıdaki örnek, bu sürümlerin oxmysql kullandığını varsayar; README'deki ek bağımlılıkları uygun yere eklersin:
ensure oxmysql
ensure qb-core
ensure qb-inventory
ensure qb-garages
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-phone
Özellikle config.lua, shared/config.lua gibi yapılandırma dosyalarını veya framework'e özgü eşya dosyalarını kontrol et. Bazı QBCore scriptleri Items, Jobs, Gangs veya Permissions içinde kayıt bekler. Yalnızca scriptin belgelediği değerleri gir. Kaynakları, txAdmin'i ve sunucu işletimini daha geniş bir bağlamda planlamak istiyorsan FiveM Server Kiralama: GTA RP Kurulumu, Kaynaklar ve txAdmin 2025 rehberini de oku.
Başlatma Sırasına Dikkat Etme
Başlatma sırası, gerçekten belgelenmiş bağımlılıkları izler:
- Veritabanı sürücüleri ve ortak kütüphaneler, örneğin gerekiyorsa
oxmysql - Framework, ESX veya QBCore gibi
- Temel kaynaklar, örneğin envanter veya garajlar
- Meslekler ve bu tabanı kullanan diğer işlevler
- Kozmetik kaynaklar, kendi bağımlılıkları zaten çalışıyorsa
Manifest'teki bir dependency girdisi bir ön koşulu tanımlar. Cfx.re manifest referansına göre ilgili kaynak, bağımlı kaynaktan önce yüklenmelidir. Kesin sıraya kurulu sürümün README'si karar verir.
Ortak kullanılan bağımlılıkları mümkünse merkezi olarak ve tüm bağımlı kaynaklardan önce ayarla. Birden fazla script aynı kütüphaneyi istiyorsa, kütüphane yalnızca bir kez başlatılmalıdır. Veritabanı bağlantısında, kaynaklar SQL sorguları göndermeden önce veritabanı sürücüsü çalışıyor olmalıdır.
Ücretsiz Script Kaynakları
| Kaynak | Açıklama |
|---|---|
| GitHub | Açık kaynak scriptler |
| Cfx.re Releases-Forum | Topluluk scriptleri |
| Overextended | Yüksek kaliteli açık kaynak |
Scriptleri yalnızca kodun, değişiklik günlüğünün veya topluluk geri bildirimlerinin izlenebildiği kaynaklardan indir. Bilinmeyen indirmelerde özellikle gizlenmiş (obfuscated) Lua koduna, açıklanamayan HTTP isteklerine, yabancı webhook'lara ve koda gömülü token'lara dikkat etmelisin. Yeni kaynakları önce bir test örneğinde veya ana oyun saatleri dışında kur.
Sonucu Kontrol Etme
Sunucuyu yeniden başlat ve konsolu izle. Doğru yüklenen bir kaynak manifest, bağımlılık veya SQL hatası olmadan görünür. Ardından oyunda scriptin sağladığı işlevi tam olarak test edersin: meslek menüsü, envanter etkileşimi, marker, komut, NUI penceresi veya veritabanı değişikliği. Gerçek oyuncuların daha sonra kullanacağı roller ve yetkilerle test et.
Sunucu konsolunda refresh ve ensure mein_script komutlarını ayrıca yalnızca kontrollü testler için kullan. Canlı değişikliklerde temiz bir yeniden başlatma çoğu zaman daha anlamlıdır, çünkü tüm başlatma sırasını yansıtır.
Sorun Giderme
SCRIPT ERROR
Önce konsoldaki satırı kontrol et. Sık sık bir bağımlılık eksiktir, bir yapılandırma değişkeni yanlış ayarlanmıştır veya hedef kaynak başlamadan önce dışa aktarılmış bir fonksiyon çağrılır. Hata mesajını scriptin README'siyle karşılaştır.
SQL Hatası
Script gerektiriyorsa birlikte gelen tabloları veya sütunları içe aktar. Tablolar zaten varsa SQL'i körü körüne tekrar çalıştırma. Bir yedek oluştur ve ifadeleri mevcut veritabanı yapına göre uyarla.
Script Yüklenmiyor
Klasör adını, ensure girdisini ve fxmanifest.lua dosyasını kontrol et. Manifest dosyasındaki bir yazım hatası veya yanlış iç içe geçmiş bir klasör, kaynağın başlamaması için yeterlidir.
İşlev Oyunda Görünmüyor
Yetkileri, meslekleri, eşyaları, koordinatları ve framework sürümünü kontrol et. Birçok roleplay scripti yalnızca belirli mesleklerde veya gruplarda çalışır. Bu yüzden sadece admin olarak değil, normal bir oyuncu profiliyle de test et.
FAQ
Her scriptten sonra sunucuyu yeniden başlatmam gerekir mi?
Güvenilir bir test için evet. Tek tek kaynaklar konsoldan yeniden yüklenebilir, ancak tam bir yeniden başlatma, başlatma sırasının ve tüm bağımlılıkların gerçekten doğru olup olmadığını gösterir.
ESX ve QBCore'u aynı anda kullanabilir miyim?
Pratikte tek bir framework seçmelisin. Birçok script açıkça ESX veya QBCore için yapılmıştır ve her biri farklı event'ler, tablolar ve yapılandırma yapıları bekler.
Bir scriptte fxmanifest.lua yoksa ne yapmalıyım?
Ek olarak eski bir __resource.lua manifest'inin olup olmadığını kontrol et. Cfx.re bu formatı hâlâ eski (deprecated) olarak belgeler; bu yüzden yalnızca fxmanifest.lua eksikliği bozuk bir indirme olduğunu kanıtlamaz. Yeni kaynaklar için güncel formatı kullan ve eski kaynakları manifest referansına göre taşı. Eski dosyayı sözdizimini ve içeriğini kontrol etmeden sadece yeniden adlandırma.
Ücretsiz scriptleri doğrudan canlı sunucuda test etmeli miyim?
Tercihen hayır. Yeni kaynakları önce ayrı olarak test et, dosyaların ve veritabanının yedeğini al ve konsolu kontrol et. Özellikle roleplay sunucularında hatalı scriptler envanteri, meslekleri veya oyuncu ilerlemesini etkileyebilir.
Bir FiveM Server kaç script kullanabilir?
Anlamlı bir genel sayı yoktur. Belirleyici olan script kalitesi, bağımlılıklar, veritabanı yükü, tick davranışı ve oyuncu sayısıdır. Kaynakları bilinçli planla ve kullanılmayan scriptleri tutarlı şekilde kaldır.
