Panduan ini mencakup solusi untuk masalah server FiveM yang paling umum — masalah akses TXAdmin, kesalahan kunci lisensi CFX, kegagalan koneksi database, crash server, masalah koneksi pemain, dan resource yang tidak dimuat. Untuk pengaturan awal server, lihat Panduan Pengaturan Server FiveM.
Tips pemecahan masalah umum: Selalu periksa output konsol GPanel dan log TXAdmin terlebih dahulu. Sebagian besar kesalahan menghasilkan pesan yang jelas yang menunjuk ke penyebabnya.
TXAdmin Tidak Memuat atau Tidak Dapat Diakses
- Pastikan server berjalan di GPanel — TXAdmin hanya dimulai saat proses server FiveM aktif.
- Periksa konsol GPanel untuk URL dan port TXAdmin. Port TXAdmin berbeda dari port game.
- Pastikan Anda menggunakan
http://bukanhttps://— TXAdmin tidak menggunakan SSL secara default. - Jika TXAdmin sebelumnya berfungsi tetapi berhenti memuat, coba mulai ulang server dari GPanel.
- Bersihkan cache browser Anda atau coba jendela incognito/pribadi.
Kehilangan kata sandi TXAdmin Anda? Jika Anda tidak dapat masuk, Anda mungkin perlu menghapus data profil TXAdmin dan menjalankan ulang wizard pengaturan. Periksa tab Files di GPanel untuk direktori data TXAdmin dan hapus file profilnya, lalu mulai ulang server.
Kesalahan Kunci Lisensi CFX
| Pesan Kesalahan | Penyebab | Solusi |
|---|---|---|
Invalid license key |
Kunci disalin secara tidak benar atau ada spasi berlebih | Buka Keymaster, konfirmasi kunci aktif, dan salin ulang dengan hati-hati. Tempelkan ke variabel Startup GPanel dan ke sv_licenseKey di server.cfg. |
License key already in use |
Kunci terdaftar untuk IP server yang berbeda | Setiap kunci hanya dapat digunakan pada satu server pada satu waktu. Cabut kunci lama di Keymaster dan buat yang baru dengan IP server Anda saat ini. |
Unable to verify license key |
Server autentikasi Cfx.re sementara tidak tersedia | Tunggu beberapa menit dan mulai ulang server. Periksa status.cfx.re untuk gangguan. |
Tips: Pastikan kunci diatur di kedua variabel Startup GPanel dan di
server.cfg (sv_licenseKey). Tergantung konfigurasi Anda, server mungkin membaca dari salah satunya.
Kesalahan Koneksi Database
| Pesan Kesalahan | Penyebab | Solusi |
|---|---|---|
Connection refused atau ETIMEDOUT |
Host atau port database salah | Periksa kembali alamat host dan port database dari tab Databases GPanel. Jangan gunakan localhost atau 127.0.0.1. |
Access denied |
Nama pengguna atau kata sandi salah | Salin kredensial langsung dari GPanel untuk menghindari kesalahan ketik. Kata sandi peka huruf besar/kecil. |
Unknown database |
Nama database tidak cocok | Pastikan nama database dalam string koneksi Anda sama persis dengan yang ditampilkan di GPanel. |
Langkah pemecahan masalah database tambahan:
- Jika menggunakan oxmysql, pastikan Anda memiliki resource
oxmysqldi folderresources/Anda dan bahwaensure oxmysqlmuncul di server.cfg sebelum resource apa pun yang memerlukan database. - Jika kata sandi Anda mengandung karakter khusus seperti
@,#, atau%, lakukan URL-encode pada string koneksi (mis.@menjadi%40). - Uji string koneksi Anda untuk karakter yang hilang atau berlebih — bahkan satu karakter yang salah tempat akan menyebabkan kegagalan.
Jangan gunakan localhost. Server database terpisah dari server game. Selalu gunakan alamat host lengkap yang ditampilkan di tab Databases GPanel.
Server Crash saat Startup
- Periksa konsol GPanel untuk pesan kesalahan. Penyebab umum termasuk
server.cfgyang hilang atau salah konfigurasi, kunci lisensi CFX yang tidak valid, atau resource yang rusak. - Coba nonaktifkan resource kustom dengan memberi tanda komentar di server.cfg (tambahkan
#sebelum setiap barisensure) dan mulai ulang. Tambahkan kembali satu per satu untuk mengidentifikasi resource yang bermasalah. - Pastikan port di
endpoint_add_tcpdanendpoint_add_udpcocok dengan port yang ditetapkan GPanel Anda.
# 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
Pencarian biner untuk resource yang buruk: Jika Anda memiliki banyak resource, beri tanda komentar setengahnya sekaligus daripada satu per satu. Ini mempersempit masalah jauh lebih cepat.
Pemain Tidak Dapat Terhubung
- Konfirmasi server menunjukkan Running di GPanel.
- Verifikasi IP dan port — pemain harus menggunakan port game, bukan port TXAdmin.
- Periksa bahwa
sv_maxclientstidak diatur ke 0 atau angka yang terlalu rendah. - Jika menggunakan kata sandi server (
sv_passworddi server.cfg), pastikan pemain mengetahuinya. - Pemain harus memiliki klien FiveM yang terpasang — mereka tidak dapat terhubung menggunakan launcher GTA V biasa.
- Periksa tab Network GPanel dan konfirmasi port di
endpoint_add_tcpdanendpoint_add_udpcocok. Ketidakcocokan akan mencegah koneksi.
Server tidak ada di browser? Server baru dapat memerlukan waktu 5-15 menit untuk muncul di daftar server FiveM. Gunakan koneksi langsung (
IP:PORT) sementara itu. Verifikasi juga bahwa sv_licenseKey Anda valid.
Resource Tidak Dimuat
- Periksa bahwa folder resource berada di dalam direktori
resources/(atau subfolder yang sesuai). - Verifikasi nama folder cocok dengan baris
ensuredi server.cfg secara persis (peka huruf besar/kecil). - Setiap resource harus berisi
fxmanifest.luayang valid (atau__resource.luayang lebih lama). Jika file ini hilang, resource tidak akan dimuat. - Periksa konsol TXAdmin atau GPanel untuk pesan kesalahan terkait resource. Kesalahan umum termasuk dependensi yang hilang atau kesalahan sintaks Lua.
- Jika resource memerlukan framework (ESX, QBCore), pastikan framework dimuat sebelum resource di server.cfg.
- Jika resource memerlukan database, pastikan resource MySQL Anda (oxmysql, mysql-async) dimuat dan koneksi database berfungsi.
Periksa struktur folder. Kesalahan umum adalah mengunggah resource dan berakhir dengan folder bersarang ganda seperti
resources/my-resource/my-resource/fxmanifest.lua. Manifest harus langsung berada di dalam folder resource: resources/my-resource/fxmanifest.lua.
Masalah Performa Server
- Buka TXAdmin dan periksa Dashboard untuk metrik performa (waktu tick, jumlah pemain, penggunaan memori).
- Server FiveM yang sehat harus mempertahankan waktu tick server (juga disebut "hitch") di bawah 20ms. Lonjakan yang konsisten di atas ini menunjukkan suatu resource menggunakan terlalu banyak waktu pemrosesan.
- Gunakan halaman Resources TXAdmin untuk mengidentifikasi resource mana yang mengonsumsi waktu server paling banyak.
- Hapus atau ganti resource yang dioptimalkan dengan buruk. Resource gratis dari sumber yang tidak dikenal sering menjadi penyebab masalah performa.
- Kurangi jumlah resource yang dimuat jika batas memori atau CPU paket server Anda tercapai.
Mendapatkan Bantuan
Jika Anda telah mencoba solusi di atas dan masih mengalami masalah:
- Salin pesan kesalahan lengkap dari konsol GPanel atau log TXAdmin.
- Catat langkah pemecahan masalah mana yang telah Anda coba.
- Buka tiket dukungan di https://legionhosting.net/submitticket.php dengan informasi ini. Tim kami akan membantu Anda secepat mungkin.