Bu kılavuz, en yaygın FiveM sunucu sorunlarına yönelik çözümleri kapsar — TXAdmin erişim sorunları, CFX lisans anahtarı hataları, veritabanı bağlantı hataları, sunucu çökmeleri, oyuncu bağlantı sorunları ve yüklenmeyen kaynaklar. İlk sunucu kurulumu için, FiveM Sunucu Kurulum Kılavuzu'na bakın.
Genel sorun giderme ipucu: Önce her zaman GPanel konsol çıktısını ve TXAdmin günlüklerini kontrol edin. Çoğu hata, nedeni gösteren açık bir mesaj üretir.
TXAdmin Yüklenmiyor veya Erişilemiyor
- Sunucunun GPanel'de çalıştığını doğrulayın — TXAdmin yalnızca FiveM sunucu süreci aktifken başlar.
- TXAdmin URL'si ve portu için GPanel konsolunu kontrol edin. TXAdmin portu, oyun portundan farklıdır.
https://değilhttp://kullandığınızdan emin olun — TXAdmin varsayılan olarak SSL kullanmaz.- TXAdmin daha önce çalışıyorduysa ancak yüklenmeyi durdurduysa, sunucuyu GPanel'den yeniden başlatmayı deneyin.
- Tarayıcı önbelleğinizi temizleyin veya gizli/özel bir pencere deneyin.
TXAdmin parolanızı mı kaybettiniz? Giriş yapamıyorsanız, TXAdmin profil verilerini silmeniz ve kurulum sihirbazını yeniden çalıştırmanız gerekebilir. TXAdmin'in veri dizini için GPanel Files sekmesini kontrol edin ve profil dosyalarını kaldırın, ardından sunucuyu yeniden başlatın.
CFX Lisans Anahtarı Hataları
| Hata Mesajı | Neden | Çözüm |
|---|---|---|
Invalid license key |
Anahtar yanlış kopyalanmış veya fazladan boşluk var | Keymaster'a gidin, anahtarın aktif olduğunu doğrulayın ve dikkatlice yeniden kopyalayın. Hem GPanel Startup değişkenine hem de server.cfg dosyasındaki sv_licenseKey alanına yapıştırın. |
License key already in use |
Anahtar farklı bir sunucu IP'sine kayıtlı | Her anahtar aynı anda yalnızca bir sunucuda kullanılabilir. Keymaster'da eski anahtarı iptal edin ve mevcut sunucu IP'nizle yeni bir tane oluşturun. |
Unable to verify license key |
Cfx.re kimlik doğrulama sunucuları geçici olarak kullanılamıyor | Birkaç dakika bekleyin ve sunucuyu yeniden başlatın. Kesintiler için status.cfx.re adresini kontrol edin. |
İpucu: Anahtarın hem GPanel Startup değişkeninde hem de
server.cfg dosyasında (sv_licenseKey) ayarlandığından emin olun. Yapılandırmanıza bağlı olarak, sunucu birinden veya diğerinden okuyabilir.
Veritabanı Bağlantı Hataları
| Hata Mesajı | Neden | Çözüm |
|---|---|---|
Connection refused veya ETIMEDOUT |
Yanlış veritabanı ana bilgisayarı veya portu | GPanel Databases sekmesinden veritabanı ana bilgisayar adresini ve portunu iki kez kontrol edin. localhost veya 127.0.0.1 kullanmayın. |
Access denied |
Yanlış kullanıcı adı veya parola | Yazım hatalarını önlemek için kimlik bilgilerini doğrudan GPanel'den kopyalayın. Parolalar büyük/küçük harfe duyarlıdır. |
Unknown database |
Veritabanı adı eşleşmiyor | Bağlantı dizenizdeki veritabanı adının, GPanel'de gösterilenle tam olarak eşleştiğinden emin olun. |
Ek veritabanı sorun giderme adımları:
- oxmysql kullanıyorsanız,
resources/klasörünüzdeoxmysqlkaynağının bulunduğundan veensure oxmysqlsatırının server.cfg dosyasında veritabanı gerektiren herhangi bir kaynaktan önce yer aldığından emin olun. - Parolanız
@,#veya%gibi özel karakterler içeriyorsa, bunları bağlantı dizesinde URL kodlamayla yazın (örneğin@,%40olur). - Bağlantı dizenizde eksik veya fazla karakter olup olmadığını test edin — yanlış yerleştirilmiş tek bir karakter bile başarısızlığa neden olur.
localhost kullanmayın. Veritabanı sunucusu, oyun sunucusundan ayrıdır. Her zaman GPanel Databases sekmesinde gösterilen tam ana bilgisayar adresini kullanın.
Sunucu Başlatma Sırasında Çöküyor
- Hata mesajları için GPanel konsolunu kontrol edin. Yaygın nedenler arasında eksik veya yanlış yapılandırılmış bir
server.cfg, geçersiz bir CFX lisans anahtarı veya bozuk bir kaynak yer alır. - Özel kaynakları server.cfg dosyasında yorum satırına alarak (her
ensuresatırının önüne#ekleyerek) devre dışı bırakmayı deneyin ve yeniden başlatın. Sorunlu kaynağı belirlemek için bunları teker teker geri ekleyin. endpoint_add_tcpveendpoint_add_udpiçindeki portların GPanel tarafından atanan portunuzla eşleştiğinden emin olun.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Hatalı kaynaklar için ikili arama: Birçok kaynağınız varsa, tek tek yerine her seferinde yarısını yorum satırına alın. Bu, sorunu çok daha hızlı daraltır.
Oyuncular Bağlanamıyor
- Sunucunun GPanel'de Running gösterdiğini doğrulayın.
- IP ve portu doğrulayın — oyuncular TXAdmin portunu değil, oyun portunu kullanmalıdır.
sv_maxclientsdeğerinin 0 veya mantıksız derecede düşük bir sayıya ayarlanmadığından emin olun.- Bir sunucu parolası kullanıyorsanız (server.cfg dosyasında
sv_password), oyuncuların bunu bildiğinden emin olun. - Oyuncuların FiveM istemcisinin kurulu olması gerekir — normal GTA V başlatıcısını kullanarak bağlanamazlar.
- GPanel Network sekmesini kontrol edin ve
endpoint_add_tcpileendpoint_add_udpiçindeki portların eşleştiğini doğrulayın. Bir uyuşmazlık, bağlantıları engelleyecektir.
Sunucu tarayıcıda yok mu? Yeni sunucuların FiveM sunucu listesinde görünmesi 5-15 dakika sürebilir. Bu sırada doğrudan bağlanmayı (
IP:PORT) kullanın. Ayrıca sv_licenseKey değerinizin geçerli olduğunu doğrulayın.
Kaynaklar Yüklenmiyor
- Kaynak klasörünün
resources/dizininin (veya uygun bir alt klasörün) içinde olduğunu kontrol edin. - Klasör adının server.cfg dosyasındaki
ensuresatırıyla tam olarak eşleştiğini doğrulayın (büyük/küçük harfe duyarlı). - Her kaynak geçerli bir
fxmanifest.lua(veya eski__resource.lua) içermelidir. Bu dosya eksikse, kaynak yüklenmez. - Kaynakla ilgili hata mesajları için TXAdmin veya GPanel konsolunu kontrol edin. Yaygın hatalar arasında eksik bağımlılıklar veya Lua sözdizimi hataları yer alır.
- Kaynak bir framework (ESX, QBCore) gerektiriyorsa, server.cfg dosyasında framework'ün kaynaktan önce yüklendiğinden emin olun.
- Kaynak bir veritabanı gerektiriyorsa, MySQL kaynağınızın (oxmysql, mysql-async) yüklendiğinden ve veritabanı bağlantısının çalıştığından emin olun.
Klasör yapısını kontrol edin. Yaygın bir hata, bir kaynak yükleyip
resources/my-resource/my-resource/fxmanifest.lua gibi iç içe çift klasörle karşılaşmaktır. Manifest doğrudan kaynak klasörünün içinde olmalıdır: resources/my-resource/fxmanifest.lua.
Sunucu Performans Sorunları
- TXAdmin'i açın ve performans metrikleri (tick süresi, oyuncu sayısı, bellek kullanımı) için Dashboard'u kontrol edin.
- Sağlıklı bir FiveM sunucusu, 20ms'nin altında bir sunucu tick süresi (aynı zamanda "hitch" olarak da adlandırılır) korumalıdır. Bunun üzerinde tutarlı yükselmeler, bir kaynağın çok fazla işlem süresi kullandığını gösterir.
- Hangi kaynakların en fazla sunucu süresini tükettiğini belirlemek için TXAdmin Resources sayfasını kullanın.
- Yetersiz optimize edilmiş kaynakları kaldırın veya değiştirin. Bilinmeyen kaynaklardan gelen ücretsiz kaynaklar genellikle performans sorunlarının nedenidir.
- Sunucu planınızın bellek veya CPU sınırlarına ulaşılıyorsa, yüklenen kaynak sayısını azaltın.
Yardım Alma
Yukarıdaki çözümleri denediyseniz ve hâlâ sorun yaşıyorsanız:
- GPanel konsolundan veya TXAdmin günlüğünden tam hata mesajını kopyalayın.
- Hangi sorun giderme adımlarını zaten denediğinizi not edin.
- Bu bilgiyle birlikte https://legionhosting.net/submitticket.php adresinde bir destek talebi açın. Ekibimiz size mümkün olan en kısa sürede yardımcı olacaktır.
