FiveM Kaynak (Resource) Sistemi Nasıl Çalışır?

FiveM'in tüm gücü kaynak (resource) sisteminden gelir. Bir sunucuda gördüğün her şey — meslekler, araçlar, arayüz, haritalar — bir kaynaktır. Bu rehber sunucu sahipleri için kaynak sistemini açıklıyor.

Kaynak nedir?

Kaynak, kendi başına yüklenip kaldırılabilen bir işlev paketidir. Her kaynak kendi klasöründe yaşar ve bir yapılandırma dosyasıyla kendini tanımlar.

Tipik bir kaynak klasörü şunları içerir:

• Manifest dosyası — kaynağın adını, sürümünü, bağımlılıklarını ve hangi dosyaların yükleneceğini tanımlar.
• Sunucu tarafı script'leri — sunucuda çalışan mantık (veritabanı, doğrulama).
• İstemci tarafı script'leri — oyuncunun bilgisayarında çalışan mantık (arayüz, tuş kontrolleri).
• Paylaşılan dosyalar — her iki tarafın da kullandığı yapılandırma.
• Varlıklar — arayüz dosyaları, modeller, sesler.

İstemci ve sunucu ayrımı — en kritik kavram

Bu ayrımı yanlış anlamak, hem güvenlik açığı hem performans sorunu üretir.

• Sunucu tarafı güvenilir alandır. Para, envanter ve yetki kontrolleri burada yapılmalıdır.
• İstemci tarafı güvenilmez alandır. Oyuncunun bilgisayarında çalışır ve değiştirilebilir.

Kural: Önemli bir karar istemci tarafında verilmemelidir. "Oyuncunun parası var mı?" sorusunu istemci tarafında sorarsan, oyuncu cevabı değiştirebilir. Bu, FiveM sunucularındaki en yaygın açık türüdür.

Kaynak nasıl eklenir?

1. Kaynağı resources/ klasörüne kopyala.
2. server.cfg dosyasına ensure kaynak_adi satırını ekle.
3. Bağımlılıkları varsa onları önce yükle — sıralama önemlidir.
4. Sunucuyu yeniden başlat ve konsolu hata için kontrol et.

Tek tek ekle ve test et. Aynı anda on kaynak ekleyip sunucu açılmayınca hangisinin sebep olduğunu aramak saatler alır.

Bağımlılık yönetimi

Çoğu kaynak başka kaynaklara bağımlıdır: bir çerçeve (framework), veritabanı katmanı, arayüz kütüphanesi. Bağımlılıklar yüklenmeden ana kaynak çalışmaz.

Yaygın hata: kaynağı server.cfg içinde bağımlılığından önce yüklemek. Konsolda "resource not found" veya benzeri hatalar görüyorsan sıralamayı kontrol et.

Performans: kaynaklar sunucuyu nasıl yavaşlatır?

Kalabalık sunucularda performans sorunlarının çoğu kötü yazılmış kaynaklardan gelir. En yaygın sebepler:

• Sürekli çalışan döngüler. Her karede çalışan ve gereksiz iş yapan döngüler, oyuncu sayısıyla çarpılarak sunucuyu boğar.
• Aşırı veritabanı sorgusu. Her etkileşimde veritabanına gitmek yerine önbellek kullanmak gerekir.
• Gereksiz veri gönderimi. Tüm oyunculara sürekli veri yollamak ağ yükü yaratır.

Sunucu konsolundan kaynak performansını izleyebilirsin; hangi kaynağın ne kadar süre harcadığını görmek, sorunu doğrudan işaret eder.

Kaynak seçerken nelere dikkat etmeli?

• Güncel mi? Uzun süredir güncellenmemiş kaynaklar yeni FiveM sürümleriyle uyumsuz olabilir.
• Kaynak kodu açık mı? Şifrelenmiş (escrow) kaynakları denetleyemezsin; ne yaptıklarını bilemezsin.
• Bağımlılıkları ne? Kullandığın çerçeveyle uyumlu olmalı.
• Nereden geliyor? Rastgele dosya paylaşım sitelerinden inen kaynaklar arka kapı içerebilir.

Kendi kaynağını yazmak

Hazır kaynakları birleştirerek kurulan sunucular birbirine benzer. Sunucunu ayırt edici kılan şey kendi yazdığın kaynaklardır.

Başlangıç için basit bir şey seç: bir bilgi paneli, bir komut, küçük bir arayüz. Çalışan küçük bir kaynak üretmek, büyük bir projeyi yarıda bırakmaktan çok daha öğreticidir.

Sunucu kurulumunun tamamı için FiveM sunucu açma rehberimize bakabilirsin.