Това ръководство покрива решения на най-често срещаните проблеми с FiveM сървъри — проблеми с достъпа до TXAdmin, грешки с CFX лицензен ключ, неуспешни връзки с базата данни, сривове на сървъра, проблеми с връзката на играчите и неуспешно зареждане на ресурси. За първоначална настройка на сървъра вижте Ръководство за настройка на FiveM сървър.

TXAdmin не се зарежда или е недостъпен

• Проверете дали сървърът работи в GPanel — TXAdmin стартира само когато процесът на FiveM сървъра е активен.
• Проверете конзолата на GPanel за URL адреса и порта на TXAdmin. Портът на TXAdmin е различен от порта на играта.
• Уверете се, че използвате http://, а не https:// — TXAdmin не използва SSL по подразбиране.
• Ако TXAdmin е работил преди, но е спрял да се зарежда, опитайте да рестартирате сървъра от GPanel.
• Изчистете кеша на браузъра си или опитайте инкогнито/частен прозорец.

Грешки с CFX лицензен ключ

Грешки при свързване с базата данни

Допълнителни стъпки за отстраняване на проблеми с базата данни:

• Ако използвате oxmysql, уверете се, че имате ресурса oxmysql в папката resources/ и че ensure oxmysql се появява в server.cfg преди всички ресурси, които изискват база данни.
• Ако паролата ви съдържа специални символи като @, # или %, кодирайте ги с URL кодиране в connection string-а (напр. @ става %40).
• Проверете connection string-а си за липсващи или излишни символи — дори един неправилно поставен символ ще причини неуспех.

Сривове на сървъра при стартиране

• Проверете конзолата на GPanel за съобщения за грешки. Чести причини включват липсващ или неправилно конфигуриран server.cfg, невалиден CFX лицензен ключ или повреден ресурс.
• Опитайте да деактивирате потребителските ресурси, като ги коментирате в server.cfg (добавете # пред всеки ред ensure) и рестартирайте. Добавяйте ги обратно един по един, за да идентифицирате проблемния ресурс.
• Уверете се, че портовете в endpoint_add_tcp и endpoint_add_udp съвпадат с присвоения ви порт в GPanel.

# 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

Играчите не могат да се свържат

• Потвърдете, че сървърът показва Running в GPanel.
• Проверете IP-то и порта — играчите трябва да използват порта на играта, а не порта на TXAdmin.
• Проверете дали sv_maxclients не е зададено на 0 или необосновано ниско число.
• Ако използвате парола за сървъра (sv_password в server.cfg), уверете се, че играчите я знаят.
• Играчите трябва да имат инсталиран FiveM клиент — те не могат да се свържат чрез обикновения GTA V launcher.
• Проверете раздела Network в GPanel и потвърдете, че портовете в endpoint_add_tcp и endpoint_add_udp съвпадат. Несъответствие ще попречи на връзките.

Ресурсите не се зареждат

• Проверете дали папката на ресурса е вътре в директорията resources/ (или подходяща подпапка).
• Уверете се, че името на папката съответства точно на реда ensure в server.cfg (с отчитане на главните/малките букви).
• Всеки ресурс трябва да съдържа валиден fxmanifest.lua (или по-стария __resource.lua). Ако този файл липсва, ресурсът няма да се зареди.
• Проверете конзолата на TXAdmin или GPanel за съобщения за грешки, свързани с ресурса. Чести грешки включват липсващи зависимости или Lua синтактични грешки.
• Ако ресурсът изисква фреймуърк (ESX, QBCore), уверете се, че фреймуъркът се зарежда преди ресурса в server.cfg.
• Ако ресурсът изисква база данни, уверете се, че вашият MySQL ресурс (oxmysql, mysql-async) е зареден и връзката с базата данни работи.

Проблеми с производителността на сървъра

• Отворете TXAdmin и проверете Dashboard за показатели на производителността (време за тик, брой играчи, използване на паметта).
• Здравословен FiveM сървър трябва да поддържа време за тик на сървъра (наричано също „hitch“) под 20ms. Постоянни скокове над тази стойност показват, че ресурс използва твърде много процесорно време.
• Използвайте страницата Resources на TXAdmin, за да идентифицирате кои ресурси консумират най-много време на сървъра.
• Премахнете или заменете лошо оптимизираните ресурси. Безплатните ресурси от непознати източници често са причината за проблеми с производителността.
• Намалете броя на заредените ресурси, ако се достигат ограниченията на паметта или процесора на вашия сървърен план.

Получаване на помощ

Ако сте опитали решенията по-горе и все още изпитвате проблеми:

1. Копирайте пълното съобщение за грешка от конзолата на GPanel или лога на TXAdmin.
2. Отбележете кои стъпки за отстраняване на проблеми вече сте опитали.
3. Отворете билет за поддръжка на https://legionhosting.net/submitticket.php с тази информация. Нашият екип ще ви помогне възможно най-бързо.

Свързани статии

• Ръководство за настройка на FiveM сървър
• Настройка на FiveM ресурси, скриптове и база данни
• Как да намерите IP и порт на сървъра си
• Ръководство за стартиране на сървъра