FiveM Server Scriptleri Kurulumu – ESX ve QBCore

FiveM scriptlerini, kaynağı resources/ klasörüne koyarak, server.cfg içinde ensure ile başlatarak ve ESX, QBCore veya veritabanı sürücüleri gibi bağımlılıkları önceden yükleyerek kurarsın. Belirleyici olan temiz bir klasör yapısı, doğru başlatma sırası, kontrol edilmiş bir SQL içe aktarması 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 veya MariaDB veritabanına erişimin gerekir. Kiralanmış bir FiveM sunucusunda buna genellikle bir dosya yöneticisi, FTP/SFTP ve phpMyAdmin veya Adminer gibi bir veritabanı aracı dahildir. Tüm sunucuyu hâlâ planlıyorsan, dahili rehber FiveM Server mieten und einrichten temel yapı konusunda yardımcı olur.

FiveM, teknik olarak scriptlere kaynak der. Resmi Cfx.re dokümantasyonuna göre fxmanifest.lua, bir kaynağa hangi dosyaların, scriptlerin ve meta verilerin ait olduğunu açıklar. Bu yüzden önce her zaman açılmış 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 et

Tipik bir FiveM kaynağı şöyle görünür:

mein_script/
├── fxmanifest.lua      # Manifest dosyası
├── client.lua          # İstemci kodu
├── server.lua          # Sunucu kodu
├── config.lua          # Yapılandırma
└── html/               # NUI (Web arayüzü)

Önemli olan, yanlışlıkla fazladan bir paket klasörü yüklememendir. Örneğin kaynak aslında doğrudan resources/mein_script/fxmanifest.lua altında olmalıysa resources/mein_script-main/mein_script/fxmanifest.lua yanlış olur. Arşivi açtıktan sonra klasörü aç ve fxmanifest.lua dosyasının hangi seviyede bulunduğunu kontrol et.

Scripti kur

1. Scripti indir
2. resources/ klasörüne çıkar
3. server.cfg içine ekle:

ensure mein_script

4. Sunucuyu yeniden başlat

Kaynak adı olarak tam olarak klasör adını veya README’nin verdiği adı kullan. Birçok hata farklı yazımlardan, klasör adındaki boşluklardan veya özel karakterlerden kaynaklanır. Küçük harfli, kısa, tireli veya alt çizgili adlar önerilir.

ESX scriptlerini ayarla

ESX scriptleri, ESX temelinin ve gerekli ek kaynakların önce 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 kural şudur: Scriptin README dosyasını kontrol et ve mevcut framework dokümantasyonunu dikkate al.

# Temel ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# Meslekler
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob

# Özellikler
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property

Bir meslek scripti kendi veritabanı tablolarını veya itemlarını bekliyorsa, birlikte gelen SQL dosyasını ilk canlı başlatmadan önce içe aktar. Öncesinde veritabanını yedekle. Mevcut roleplay sunucularında SQL dosyaları, kurulumuna uyarlanmamışsa sütunları, itemları veya meslekleri ezebilir.

QBCore scriptlerini ayarla

QBCore kaynakları benzer bir prensibi takip eder: Önce framework, ardından ortak kütüphaneler, sonra envanter, meslekler, garajlar, telefon veya HUD. Basit bir örnek:

ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-garages
ensure qb-inventory
ensure qb-phone

Özellikle config.lua, shared/config.lua veya framework’e özel item dosyaları gibi yapılandırma dosyalarını kontrol et. Bazı QBCore scriptleri Items, Jobs, Gangs veya Permissions içinde kayıtlar bekler. Yalnızca scriptin dokümante ettiği değerleri gir. Kaynakları, txAdmin’i ve sunucu işletimini daha geniş bağlamda planlamak istiyorsan ayrıca FiveM Server mieten: GTA RP einrichten, Ressourcen & txAdmin 2025 rehberini oku.

Başlatma sırasına dikkat et

Başlatma sırası önemlidir:

1. Önce Framework (ESX/QBCore)
2. Dependencies (oxmysql vb.)
3. Temel scriptler (envanter, HUD)
4. Meslek scriptleri
5. Kozmetik scriptler (emote’lar, kıyafetler)

Ortak kullanılan dependencies kaynaklarını mümkün olduğunca merkezi şekilde ve tüm bağımlı kaynaklardan önce yerleştir. 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ı

Scriptleri yalnızca kodu, değişiklik günlüğü veya topluluk geri bildirimleri izlenebilir olan kaynaklardan indir. Bilinmeyen indirmelerde özellikle gizlenmiş Lua koduna, açıklanamayan HTTP isteklerine, yabancı webhook’lara ve sabit kodlanmış tokenlara dikkat etmelisin. Yeni kaynakları önce bir test örneğinde veya ana oyun saatleri dışında kur.

Sonucu kontrol et

Sunucuyu yeniden başlat ve konsolu izle. Doğru yüklenen bir kaynak manifest, dependency veya SQL hatası olmadan görünür. Ardından oyunda scriptin sunduğu işlevi tam olarak kontrol et: meslek menüsü, envanter etkileşimi, marker, command, NUI penceresi veya veritabanı değişikliği. Daha sonra gerçek oyuncuların kullanacağı roller ve izinlerle test et.

Ek olarak sunucu konsolunda refresh ve ensure mein_script komutlarını yalnızca kontrollü testler için kullan. Canlı değişikliklerde temiz bir yeniden başlatma çoğu zaman daha anlamlıdır, çünkü tam başlatma sırasını gösterir.

Sorun giderme

SCRIPT ERROR

Önce konsoldaki satırı kontrol et. Sıkça bir dependency eksiktir, bir config değişkeni yanlış ayarlanmıştır veya dışa aktarılan bir fonksiyon hedef kaynak başlamadan önce çağrılıyordur. Hata mesajını scriptin README dosyasıyla karşılaştır.

SQL hatası

Script istiyorsa birlikte gelen tabloları veya sütunları içe aktar. Tablolar zaten varsa SQL’i körlemesine yeniden çalıştırma. Bir yedek oluştur ve ifadeleri mevcut veritabanı yapına göre uyarla.

Script yüklenmiyor

Klasör adını, ensure kaydını 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

İzinleri, meslekleri, itemları, koordinatları ve framework sürümünü kontrol et. Birçok roleplay scripti yalnızca belirli meslekler veya gruplar için çalışır. Bu yüzden yalnızca admin olarak değil, normal bir oyuncu profiliyle de test et.

Kontrol, sınırlar ve güvenli geri dönüş

“FiveM Server Scripts installieren – ESX und QBCore” rehberi, makalede açıklanan sunucu türü ve kontrol anında görünen sürüm durumu için geçerlidir. Menü adları, kullanılabilir sürümler, mod veya plugin uyumluluğu ve gerekli kaynaklar güncellemelerden sonra farklı olabilir. Bu yüzden değerleri kontrol etmeden başka bir oyun, loader veya sunucu sürümüne aktarma.

Dünya, oyun kaydı, yapılandırma veya eklentilerde değişiklik yapmadan önce etkilenen dosyaların yedeğini oluştur. Ardından yalnızca birbiriyle bağlantılı tek bir adımı değiştir ve daha sonra oynamak istediğin aynı istemci ve sunucu sürümüyle kontrol et.

Başarılı tek bir test, performans veya erişilebilirlik garantisi değildir. Dünya boyutu, modlar, pluginler, oyuncu sayısı, ağ yolu ve eşzamanlı yük sonucu değiştirebilir. Sürümü, değişikliği ve test sonucunu belgele ki daha sonraki sapmaları anlayabilesin.

FAQ

Her scriptten sonra sunucuyu yeniden başlatmam gerekir mi?

Güvenilir bir test için evet. Tek tek kaynaklar konsol üzerinden yeniden yüklenebilir, ancak tam yeniden başlatma başlatma sırasının ve tüm dependencies kaynaklarının gerçekten doğru olup olmadığını gösterir.

ESX ve QBCore’u aynı anda kullanabilir miyim?

Pratikte bir framework seçmelisin. Birçok script açıkça ESX veya QBCore için geliştirilmiştir ve her biri farklı eventler, tablolar ve config yapıları bekler.

Bir scriptte fxmanifest.lua yoksa ne yapmalıyım?

O zaman muhtemelen eski, yanlış çıkarılmış veya güncel FiveM kaynak yapılarına hazırlanmamış olabilir. Canlıda kurmadan önce kaynağı ve dokümantasyonu kontrol et.

Ücretsiz scriptleri doğrudan canlı sunucuda test etmeli miyim?

Daha iyisi hayır. Yeni kaynakları önce ayrı olarak test et, dosyaları ve veritabanını yedekle ve konsolu kontrol et. Özellikle roleplay sunucularında hatalı scriptler envanteri, meslekleri veya oyuncu ilerlemesini etkileyebilir.

Bir FiveM sunucusu kaç script kullanabilir?

Anlamlı tek 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.