FiveM Sunucusu Açılırken Karşılaşılan Yaygın Hatalar ve Kontrol Listesi

[KaraKağanX]

1. Sistem Gereksinimlerinin Yanlış Belirlenmesi​

• Çekirdek ve RAM: top veya htop ile gerçek CPU çekirdeği sayısını kontrol edin.
• Disk Alanı: df -h ile root partition ve resources klasörünün boş alanını kontrol edin; 5 GB altında bir sunucu, resource yüklenirken hataya yol açacaktır.

2. server.cfg Dosyasındaki Hatalar​

• Port Çakışması: # Please edit this file satırında endpoint_add_tcp ve endpoint_add_udp portlarının aynı olup olmadığını kontrol edin; aynı port atanırsa “E110” hatası alırsınız.
• Resource Listesi: ensure satırları arasında boş satır veya yanlış isim (ör. es_extended yerine es_extendeds) varsa load sırasında “Could not find resource” hatası oluşur.

3. Eksik veya Bozuk DLL/DOSYA​

• Windows: server.exe ile aynı klasörde cfx_server.exe yoksa “Failed to load server executable” hatası.
• Linux: chmod +x server çalıştırıldığından emin olun.
• GeoIP: geoip.dat dosyası eksik, kurulum sonrası yeniden indirilmeli.

4. Çalışma Dizininde İzin Hataları​

• Windows: server_data klasörü için “Read/Write” izinleri verilmemişse, resource yüklenemeyebilir.
• Linux: chown -R <user>:<group> ./ ile sahipliği değiştirin; 80’den yüksek port çalıştırmak için root yetkisine ihtiyaç vardır.

5. Resim ve Map Dosyalarının Eksikliği​

• resources/mapdata içinde mapdata.txt veya terrain.dat yoksa “Map not found” hatası.
• client.lua içinde AddMap çağrısı, map dosyasının adını doğru verdiniz mi?

6. MySQL Bağlantı Hataları​

• mysql-async veya oxmysql resource’lerinde config.lua’daki host, port, user ve password doğru girilmelidir.
• bind-address sadece 127.0.0.1 ise dış bağlantıdan yapılacak sorgular “Cannot connect to MySQL” şeklinde başarısız olur.

7. JavaScript / Lua Runtime Çakışması​

• fxserver 2.0 ve üstü için ES6 desteklenen node gerekebilir.
• Çoklu resource aynı anda aynı değişkeni değiştirse “resource conflict” hatası alır; değişken isimlerini isim alanına (QBCore vs ESX) alın.

8. Yetersiz RAM / OOM (Out Of Memory)​

• free -m ile RAM kullanımını izleyin. 2 GB RAM, 20 resource komple çalıştırırken sık sık “Out of memory” hatası verir.
• ulimit -n 4096 komutu ile açılacak dosya sayısını artırın; çok sayıda client bağlantısı için gereklidir.

9. Resource Sürüm Uyuşmazlığı​

• es_extended 1.2 vs 1.3 versiyonları arasında v1.3’te ESX.ShowNotification yerine ESX.ShowAdvancedNotification kullanılmalı.
• ox_lib güncelemesinde exports.ox_lib:drawText() yerine exports.ox_lib:DrawText() çağrılır; hatalı fonksiyon adı “Attempt to call a nil value” hatası verir.

10. Güncelleme Sonrası Çalışma Sistemi​

• Güncellemeden önce resources klasöründeki tüm resource’ları git pull --rebase ile alıp, ardından server.restart komutu ile yeniden başlatın.
• Her güncellemeden sonra logs/server.log dosyasını kontrol edin; “Failed to load resource” satırları varsa ilgili resource’ları tekrar başlatın.

Kontrol Listesi

- [ ] Sistem gereksinimleri (CPU, RAM, disk) yeterli

- [ ] server.cfg port ve resource liste doğruluğu

- [ ] Gerekli dll/ek dosyalar mevcut

- [ ] Dizin izinleri doğru

- [ ] Map dosyaları eksik değil

- [ ] MySQL bağlantı ayarları doğru

- [ ] Runtime çakışması yok

- [ ] RAM ve dosya limitleri yeterli

- [ ] Resource sürümleri uyumlu

- [ ] Güncelleme sonrası log kontrolü

Bu adımları izleyerek açılış sırasında oluşan hataların çoğunu önleyebilir, sunucunuzu daha stabil bir şekilde çalıştırabilirsiniz.
Siz hangi hatayı en sık karşılıyorsunuz?

İlgili konular​

• FiveM Sunucu Kurulumunda En Yaygın Hatalar ve Çözümleri
• ESX vs QBCore: Karşılaşılan Yaygın Hatalar ve Çözüm Önerileri
• FiveM Sunucusu İçin Gereken Sistem Kaynakları Nasıl Hesaplanır