Цей посібник охоплює рішення для найпоширеніших проблем із сервером 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 у рядку підключення (наприклад, @ стає %40).
• Перевірте свій рядок підключення на наявність відсутніх або зайвих символів — навіть один неправильно розміщений символ призведе до збою.

Сервер аварійно завершує роботу під час запуску

• Перевірте консоль 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.
• Перевірте вкладку 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") нижче 20 мс. Постійні стрибки вище цього значення вказують на те, що ресурс використовує занадто багато процесорного часу.
• Використовуйте сторінку Resources у TXAdmin, щоб визначити, які ресурси споживають найбільше часу сервера.
• Видаліть або замініть погано оптимізовані ресурси. Безкоштовні ресурси з невідомих джерел часто є причиною проблем із продуктивністю.
• Зменшіть кількість завантажених ресурсів, якщо досягаються ліміти пам'яті або процесора вашого тарифного плану сервера.

Отримання допомоги

Якщо ви спробували наведені вище рішення, але все ще стикаєтеся з проблемами:

1. Скопіюйте повне повідомлення про помилку з консолі GPanel або журналу TXAdmin.
2. Зазначте, які кроки з усунення несправностей ви вже спробували.
3. Відкрийте тикет підтримки за адресою https://legionhosting.net/submitticket.php з цією інформацією. Наша команда допоможе вам якомога швидше.

Пов'язані статті

• Посібник із налаштування сервера FiveM
• Ресурси, скрипти та налаштування бази даних FiveM
• Як знайти IP та порт вашого сервера
• Посібник із запуску сервера