Bu təlimat ən çox rast gəlinən FiveM server problemlərinin həllərini əhatə edir — TXAdmin giriş problemləri, CFX lisenziya açarı xətaları, verilənlər bazası bağlantı uğursuzluqları, server çökmələri, oyunçu qoşulma problemləri və resursların yüklənməməsi. İlkin server quraşdırması üçün FiveM Server Quraşdırma Təlimatına baxın.
Ümumi problemlərin həlli məsləhəti: Həmişə əvvəlcə GPanel konsol çıxışını və TXAdmin qeydlərini yoxlayın. Əksər xətalar səbəbi göstərən aydın mesaj verir.
TXAdmin Yüklənmir və ya Əlçatmazdır
- Serverin GPanel-də işlədiyini yoxlayın — TXAdmin yalnız FiveM server prosesi aktiv olduqda başlayır.
- GPanel konsolunda TXAdmin URL-ini və portunu yoxlayın. TXAdmin portu oyun portundan fərqlidir.
https://deyil,http://istifadə etdiyinizdən əmin olun — TXAdmin standart olaraq SSL istifadə etmir.- TXAdmin əvvəl işləyirdisə lakin yüklənməyi dayandırıbsa, serveri GPanel-dən yenidən başlatmağa çalışın.
- Brauzerin keşini təmizləyin və ya gizli/xüsusi pəncərədə sınayın.
TXAdmin şifrənizi unutmusunuz? Əgər giriş edə bilmirsinizsə, TXAdmin profil məlumatlarını silməli və quraşdırma sehrbazını yenidən başlatmalı ola bilərsiniz. GPanel Files tabında TXAdmin-in məlumat qovluğunu yoxlayın və profil fayllarını silin, sonra serveri yenidən başladın.
CFX Lisenziya Açarı Xətaları
| Xəta Mesajı | Səbəb | Həll |
|---|---|---|
Invalid license key |
Açar səhv kopyalanıb və ya əlavə boşluq var | Keymaster-ə keçin, açarın aktiv olduğunu təsdiqləyin və onu diqqətlə yenidən kopyalayın. Onu həm GPanel Startup dəyişəninə, həm də server.cfg-dəki sv_licenseKey-ə yapışdırın. |
License key already in use |
Açar fərqli bir server IP-sinə qeydiyyatdan keçib | Hər açar eyni anda yalnız bir serverdə istifadə oluna bilər. Keymaster-da köhnə açarı ləğv edin və cari server IP-nizlə yenisini yaradın. |
Unable to verify license key |
Cfx.re autentifikasiya serverləri müvəqqəti əlçatmazdır | Bir neçə dəqiqə gözləyin və serveri yenidən başladın. Kəsilmələr üçün status.cfx.re saytını yoxlayın. |
Məsləhət: Açarın həm GPanel Startup dəyişənində, həm də
server.cfg-dəki sv_licenseKey-də təyin olunduğundan əmin olun. Konfiqurasiyanızdan asılı olaraq, server birindən və ya digərindən oxuya bilər.
Verilənlər Bazası Bağlantı Xətaları
| Xəta Mesajı | Səbəb | Həll |
|---|---|---|
Connection refused və ya ETIMEDOUT |
Səhv verilənlər bazası host və ya portu | GPanel Databases tabından verilənlər bazası host ünvanını və portunu iki dəfə yoxlayın. localhost və ya 127.0.0.1 istifadə etməyin. |
Access denied |
Səhv istifadəçi adı və ya şifrə | Yazı xətalarından qaçınmaq üçün məlumatları birbaşa GPanel-dən kopyalayın. Şifrələr böyük-kiçik hərfə həssasdır. |
Unknown database |
Verilənlər bazası adı uyğun gəlmir | Bağlantı sətirinizdəki verilənlər bazası adının GPanel-də göstərilənlə tam uyğun olduğundan əmin olun. |
Əlavə verilənlər bazası problemlərinin həlli addımları:
- oxmysql istifadə edirsinizsə,
resources/qovluğunuzdaoxmysqlresursunun olduğundan və verilənlər bazası tələb edən hər hansı resursdan əvvəl server.cfg-dəensure oxmysqlolduğundan əmin olun. - Şifrənizdə
@,#və ya%kimi xüsusi simvollar varsa, onları bağlantı sətirində URL-kodlayın (məsələn,@%40olur). - Bağlantı sətirinizdə əksik və ya artıq simvollar olub-olmadığını yoxlayın — hətta bir yanlış yerləşdirilmiş simvol uğursuzluğa səbəb olacaq.
localhost istifadə etməyin. Verilənlər bazası serveri oyun serverindən ayrıdır. Həmişə GPanel Databases tabında göstərilən tam host ünvanını istifadə edin.
Server Başlanğıcda Çökür
- GPanel konsolunda xəta mesajlarını yoxlayın. Ən çox rast gəlinən səbəblərə əksik və ya səhv konfiqurasiya olunmuş
server.cfg, etibarsız CFX lisenziya açarı və ya xarab resurs daxildir. - server.cfg-dəki xüsusi resursları şərh edərək deaktiv etməyi sınayın (hər
ensuresətirinin əvvəlinə#əlavə edin) və yenidən başladın. Problemli resursu müəyyən etmək üçün onları bir-bir geri əlavə edin. endpoint_add_tcpvəendpoint_add_udp-dəki portların GPanel-də təyin olunmuş portunuzla uyğun olduğundan əmin 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
Xarab resurslar üçün ikili axtarış: Çoxlu resursunuz varsa, onları bir-bir deyil, yarısını eyni anda şərh edin. Bu, problemi daha sürətli daraltmağa kömək edir.
Oyunçular Qoşula Bilmir
- Serverin GPanel-də Running statusunda göstərildiyini təsdiqləyin.
- IP və portu yoxlayın — oyunçular TXAdmin portu deyil, oyun portunu istifadə etməlidirlər.
sv_maxclients-in 0 və ya qeyri-adekvat aşağı rəqəmə təyin olunmadığını yoxlayın.- Server şifrəsi istifadə edirsinizsə (server.cfg-dəki
sv_password), oyunçuların onu bildiyindən əmin olun. - Oyunçuların FiveM klienti quraşdırılmış olmalıdır — adi GTA V başladıcısı ilə qoşula bilməzlər.
- GPanel Network tabını yoxlayın və
endpoint_add_tcpiləendpoint_add_udp-dəki portların uyğun olduğunu təsdiqləyin. Uyğunsuzluq qoşulmaları əngəlləyəcək.
Server brauzerdə yoxdur? Yeni serverlər FiveM server siyahısında görünmək üçün 5-15 dəqiqə çəkə bilər. Bu müddətdə birbaşa qoşulmadan (
IP:PORT) istifadə edin. Həmçinin sv_licenseKey-nizin etibarlı olduğunu yoxlayın.
Resurslar Yüklənmir
- Resurs qovluğunun
resources/qovluğu içində (və ya müvafiq alt qovluqda) olduğunu yoxlayın. - Qovluq adının server.cfg-dəki
ensuresətiri ilə tam uyğun olduğunu yoxlayın (böyük-kiçik hərfə həssasdır). - Hər resursda etibarlı bir
fxmanifest.lua(və ya köhnə__resource.lua) olmalıdır. Bu fayl əskikdirsə, resurs yüklənməyəcək. - Resursla bağlı xəta mesajları üçün TXAdmin və ya GPanel konsolunu yoxlayın. Ən çox rast gəlinən xətalara əskik asılılıqlar və ya Lua sintaksis xətaları daxildir.
- Resurs framework tələb edirsə (ESX, QBCore), server.cfg-də framework-ün resursdan əvvəl yükləndiyindən əmin olun.
- Resurs verilənlər bazası tələb edirsə, MySQL resursunuzun (oxmysql, mysql-async) yükləndiyindən və verilənlər bazası bağlantısının işlədiyindən əmin olun.
Qovluq strukturunu yoxlayın. Ən çox yol verilən səhv resursu yükləyib
resources/my-resource/my-resource/fxmanifest.lua kimi ikiqat iç-içə qovluq əldə etməkdir. Manifest birbaşa resurs qovluğu içində olmalıdır: resources/my-resource/fxmanifest.lua.
Server Performans Problemləri
- TXAdmin-i açın və performans göstəriciləri (tick vaxtı, oyunçu sayı, yaddaş istifadəsi) üçün Dashboard yoxlayın.
- Sağlam bir FiveM serveri server tick vaxtını (həmçinin "hitch" adlanır) 20ms-dən aşağı saxlamalıdır. Bundan yuxarı davamlı sıçrayışlar bir resursun həddən artıq emal vaxtı istifadə etdiyini göstərir.
- Hansı resursların ən çox server vaxtı istifadə etdiyini müəyyən etmək üçün TXAdmin Resources səhifəsini istifadə edin.
- Zəif optimallaşdırılmış resursları silin və ya əvəz edin. Naməlum mənbələrdən alınan pulsuz resurslar çox vaxt performans problemlərinin səbəbi olur.
- Server planınızın yaddaş və ya CPU limitlərinə çatılırsa, yüklənmiş resursların sayını azaldın.
Kömək Almaq
Əgər yuxarıdakı həlləri sınamısınız və hələ də problemlər yaşayırsınızsa:
- GPanel konsolundan və ya TXAdmin qeydlərindən tam xəta mesajını kopyalayın.
- Artıq hansı problemlərin həlli addımlarını sınadığınızı qeyd edin.
- Bu məlumatlarla https://legionhosting.net/submitticket.php ünvanında dəstək bileti açın. Komandamız sizə mümkün qədər tez kömək edəcək.
