FiveM oynarken ya da sunucu yönetirken karşılaşılan hataların çoğu birkaç bilinen nedene dayanır. Bu rehberde oyuncu ve sunucu tarafında en sık görülen hataları, ne anlama geldiklerini ve nasıl çözüleceklerini bir arada topladık. Hata mesajını sayfada aratarak (Ctrl+F) doğrudan çözüme gidebilirsin.
Oyuncu tarafı hatalar
1. "Couldn't load resource" / kaynak yükleme hataları
Sunucuya bağlanırken bir kaynağın indirilememesi anlamına gelir. Önce FiveM önbelleğini temizle: %localappdata%\FiveM\FiveM.app\data klasöründeki cache içeriğini sil (game klasörüne dokunma), sonra tekrar bağlan. Sorun sürerse sunucu sahibine hangi kaynakta takıldığını bildir.
2. "Server didn't respond" / sunucu yanıt vermedi
Sunucu kapalı, port kapalı ya da internet bağlantında sorun vardır. Başka sunucularda da aynı hatayı alıyorsan modemini yeniden başlat ve güvenlik duvarının FiveM'i engellemediğini kontrol et.
3. Doku kaybı (texture loss)
Grafik belleği dolmuştur. Doku kalitesini düşür, "Extended Texture Budget" ayarını artır ve arka planda çalışan tarayıcı gibi uygulamaları kapat. Sunucuda aşırı büyük araç ve MLO dokuları varsa sorun sunucu tarafındadır (MLO rehberi).
4. Oyun açılırken çökme (crash)
Hata penceresindeki çökme kodunu not al. Genellikle eski ekran kartı sürücüsü, GTA V'e yüklü tek oyunculu modlar ya da bozuk oyun dosyaları neden olur. GTA V'i başlatıcı üzerinden doğrula, sürücülerini güncelle ve oyun klasöründeki modları kaldır.
5. "You are banned from this server"
Sunucu yönetimi tarafından yasaklanmışsındır. Ban kaydı sunucunun kendi sistemindedir; itiraz için sunucunun Discord'undaki destek kanalını kullan.
6. Global ban (Cfx.re)
FiveM tarafından hile tespiti nedeniyle verilir ve tüm sunucularda geçerlidir. Sunucu sahipleri bu banı kaldıramaz; yalnızca Cfx.re destek sürecine başvurulabilir.
Sunucu tarafı hatalar
7. "Server license key authentication failed"
Lisans anahtarı hatalı, süresi dolmuş ya da farklı bir IP için oluşturulmuştur. portal.cfx.re üzerinden anahtarı kontrol et ve server.cfg içindeki sv_licenseKey satırını güncelle.
8. "Could not find dependency"
Bir script, yüklenmemiş başka bir kaynağa ihtiyaç duyuyor. Eksik kaynağı indir ve server.cfg içinde bağımlı scriptten önce ensure et. Ayrıntılar script kurulumu rehberimizde.
9. "You lack the required entitlement"
Escrow (şifreli) bir script, sunucunun lisans anahtarının ait olduğu Cfx.re hesabında satın alınmamış. Scripti satın aldığın hesap ile lisans anahtarını aldığın hesap aynı olmalıdır.
10. oxmysql / MySQL bağlantı hataları
"ECONNREFUSED" veritabanı sunucusunun çalışmadığını, "Access denied" kullanıcı adı ya da şifrenin yanlış olduğunu, "Unknown database" ise veritabanının oluşturulmadığını gösterir. Bağlantı satırını kontrol et:
set mysql_connection_string "mysql://kullanici:sifre@127.0.0.1/veritabani?charset=utf8mb4"Şifrede özel karakter varsa URL kodlamasıyla yazman gerekebilir.
11. "Unknown column" / "Table doesn't exist"
Scriptin SQL dosyası veritabanına aktarılmamış ya da eski bir sürüm aktarılmıştır. Scriptin .sql dosyasını yedek aldıktan sonra içe aktar.
12. "SCRIPT ERROR: attempt to index a nil value"
Lua'da var olmayan bir değere erişilmeye çalışılmıştır. Hata satırında dosya adı ve satır numarası yazar. Çoğu zaman framework nesnesinin (ESX ya da QBCore) yüklenmemesinden ya da config'teki bir yazım hatasından kaynaklanır. Script, framework'ünle uyumlu mu kontrol et (ESX vs QBCore).
13. "Server thread hitch warning"
Sunucunun bir karesi beklenenden uzun sürmüştür. Arada bir görülmesi normaldir; sürekli görülüyorsa ağır çalışan bir script ya da yetersiz işlemci vardır. profiler ile kaynağı bul (optimizasyon rehberi).
14. Port 30120 kullanımda
Aynı makinede başka bir FiveM sunucusu ya da önceki oturumdan kalan bir işlem portu tutuyor. Eski işlemi kapat ya da endpoint_add_tcp ve endpoint_add_udp satırlarıyla farklı bir port kullan.
15. Sunucu listede görünmüyor
sv_master1 "" satırı listeyi kapatır; varsa kaldır. Ayrıca lisans anahtarının geçerli olduğundan ve portun dışarıdan erişilebilir olduğundan emin ol. Listede görünmek tek başına yeterli değil; sunucunu fivemci.net sunucu listesine de ekleyebilirsin.
Hata çözerken genel yöntem
- Hata mesajını tam olarak oku; çoğu zaman dosya ve satır numarası yazar.
- Son yaptığın değişikliği geri al ve sorunun kaybolup kaybolmadığını gör.
- Scriptleri tek tek kapatarak sorunlu olanı bul.
- Çözemediğinde Teknik Destek bölümünde hata mesajı, konsol çıktısı ve framework bilgisiyle konu aç.
Sıkça Sorulan Sorular
FiveM önbelleğini silmek güvenli mi?
Evet. cache klasöründeki içerikler sunucuya bağlandığında yeniden indirilir. Yalnızca game klasörünü silme.
Konsol hatalarını nereden görürüm?
Sunucu hataları txAdmin'in Live Console bölümünde, oyuncu tarafı hatalar ise oyunda F8 konsolunda görünür.
Sunucu açılıyor ama oyuncular düşüyor, neden?
Genellikle bir istemci scriptindeki hata ya da büyük stream dosyalarıdır. Düşen oyuncudan F8 çıktısını ve hata kodunu iste.
Global ban'ı sunucu sahibi kaldırabilir mi?
Hayır. Global ban Cfx.re tarafından verilir ve yalnızca Cfx.re destek süreciyle değerlendirilir.
Hatanın hangi scriptten geldiğini nasıl bulurum?
Hata satırında genellikle @scriptadi/dosya.lua:satır şeklinde kaynak adı yazar. Yazmıyorsa scriptleri sırayla kapatıp test et.