Panduan pemecahan masalah untuk masalah umum server RedM termasuk kesalahan kunci lisensi, visibilitas di server browser, kegagalan resource, koneksi client, masalah basis data, dan optimasi performa. Untuk instruksi pengaturan awal, lihat Panduan Pengaturan Server RedM kami.
Kesalahan Kunci Lisensi
Masalah kunci lisensi adalah masalah paling umum saat memulai server RedM baru. Berikut adalah kesalahan tipikal dan solusinya:
"Invalid license key" atau "Could not authenticate"
| Penyebab | Solusi |
|---|---|
| Kunci lisensi salah ketik atau memiliki spasi tambahan | Salin kunci langsung dari Keymaster. Hapus spasi kosong di awal/akhir dari variabel startup CFX_LICENSE di GPanel atau baris sv_licenseKey di server.cfg. |
| Ketidakcocokan alamat IP | Kunci terdaftar ke IP yang berbeda dari IP aktual server Anda. Buka Keymaster, periksa IP yang terdaftar, dan perbarui agar cocok dengan IP server Anda yang ditampilkan di GPanel. |
| Kunci diatur di GPanel dan server.cfg dengan nilai yang berbeda | Pastikan kunci konsisten. Sebaiknya atur di variabel startup GPanel dan biarkan egg menangani penerusan ke server. Hapus atau jadikan komentar sv_licenseKey dari server.cfg jika GPanel menanganinya. |
| Masalah akun Cfx.re atau kunci dicabut | Masuk ke Keymaster dan verifikasi bahwa kunci masih aktif. Buat kunci baru jika kunci lama dihapus atau kedaluwarsa. |
| Layanan Keymaster sedang tidak tersedia sementara | Periksa halaman status Cfx.re untuk gangguan. Tunggu dan coba lagi nanti. |
Penting: Jika Anda baru-baru ini menerima server baru atau IP server Anda berubah (misalnya, setelah migrasi node), Anda harus memperbarui IP di Keymaster atau membuat kunci lisensi baru. Kunci lama tidak akan bekerja pada IP yang berbeda.
Server Tidak Muncul di Browser
Jika server Anda berjalan tetapi pemain tidak dapat menemukannya di server browser RedM:
Checklist
- Tunggu setidaknya 5 menit. Setelah dimulai, server memerlukan waktu untuk mendaftar ke master server list Cfx.re. Server baru mungkin memerlukan beberapa menit untuk muncul.
- Verifikasi bahwa kunci lisensi valid. Server tidak akan terdaftar tanpa kunci lisensi yang berfungsi. Periksa konsol server untuk kesalahan terkait lisensi.
- Periksa konfigurasi endpoint. Pastikan
endpoint_add_tcpdanendpoint_add_udpdiserver.cfgmenggunakan port yang benar:
Port harus cocok dengan yang ditetapkan di GPanel.endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" - Periksa pengaturan "sv_master1" atau listing. Pastikan Anda tidak secara tidak sengaja mengatur server agar tidak mendaftarkan dirinya. Seharusnya tidak ada
sv_master1 ""di konfigurasi Anda (ini menonaktifkan registrasi master list). - Verifikasi bahwa server benar-benar berjalan. Periksa konsol GPanel. Jika server crash atau berhenti, server tidak akan muncul di browser.
- Coba direct connect. Bahkan jika server tidak ada di browser, direct connect seharusnya berfungsi. Minta pemain menekan F8 di RedM dan ketik:
connect YOUR_SERVER_IP:PORT
Tip: Anda dapat memverifikasi bahwa server Anda dapat dijangkau dengan menggunakan pencarian server Cfx.re. Coba navigasikan ke
http://YOUR_SERVER_IP:PORT/info.json di browser web. Jika server berjalan dan dapat diakses, server akan mengembalikan respons JSON dengan informasi server.
Kegagalan Pemuatan Resource
Kesalahan resource umum terjadi saat menambahkan skrip atau framework baru ke server Anda. Berikut adalah masalah yang paling sering terjadi:
"Could not find resource [resource_name]"
- Folder resource tidak ada di direktori
resources/, atau berada di lokasi yang salah. - Nama folder tidak cocok dengan nama yang digunakan dalam
ensure. Nama resource bersifat case-sensitive. - Perbaikan: Verifikasi bahwa folder resource ada dan nama di
server.cfgcocok persis. Gunakan file manager GPanel atau SFTP untuk memeriksa.
"Failed to load resource [resource_name]: manifest error"
- File
fxmanifest.luaatau__resource.luadari resource memiliki kesalahan sintaks. - Manifest mereferensikan file yang tidak ada di folder resource.
- Perbaikan: Buka file manifest dan periksa kesalahan ketik, koma yang hilang, atau referensi ke file yang tidak ada. Periksa konsol server untuk nomor baris spesifik dari kesalahan tersebut.
"Error loading script [filename]: [error details]"
- File Lua, C#, atau JavaScript di dalam resource memiliki kesalahan sintaks atau runtime.
- Perbaikan: Baca pesan kesalahan lengkap di konsol. Pesan tersebut akan menyertakan nama file dan nomor baris. Penyebab umum meliputi:
- Dependensi yang hilang (resource lain yang harus dimuat terlebih dahulu)
- Resource usang yang tidak kompatibel dengan versi server RedM saat ini
- Nilai konfigurasi yang salah di file config resource
Masalah Urutan Pemuatan Resource
Resource di server.cfg dimuat sesuai urutan kemunculannya. Jika sebuah resource bergantung pada resource lain (misalnya, vorp_inventory bergantung pada vorp_core), dependensinya harus dicantumkan terlebih dahulu:
# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores
# Wrong order - will cause errors
# ensure vorp_inventory <-- depends on vorp_core
# ensure vorp_core <-- loaded too late
Peringatan: Jika sebuah resource gagal dimuat, resource apa pun yang bergantung padanya juga akan gagal. Selalu periksa output konsol dengan cermat untuk mengidentifikasi akar penyebabnya, yang biasanya merupakan kesalahan pertama yang muncul.
Masalah Koneksi Client
Ketika pemain tidak dapat menghubungkan ke server Anda:
"Connection timed out" / "Failed to connect"
| Penyebab | Solusi |
|---|---|
| Server tidak berjalan | Periksa konsol GPanel untuk memastikan server online dan tidak crash. |
| IP atau port salah | Verifikasi bahwa pemain menggunakan IP dan port yang benar dari GPanel. Lihat Cara Menemukan IP dan Port Server Anda. |
| Kesalahan konfigurasi endpoint | Pastikan endpoint_add_tcp dan endpoint_add_udp di server.cfg menggunakan port 0.0.0.0:PORT di mana PORT cocok dengan GPanel. |
| Server penuh | Periksa apakah sv_maxclients telah tercapai. Tingkatkan nilainya jika paket hosting Anda mengizinkan. |
"Connection rejected by server"
- Password server: Jika
sv_passworddiatur, pemain harus memasukkan password yang benar. - Resource whitelist/allowlist: Jika Anda memiliki resource whitelist yang diaktifkan, pemain harus disetujui sebelum menghubungkan.
- Ban: Pemain mungkin di-ban. Periksa daftar ban atau basis data Anda untuk identifier mereka.
Client crash saat menghubungkan
- Sebuah resource di server mengirim data yang buruk atau memiliki kesalahan skrip sisi client yang membuat client crash.
- Perbaikan: Nonaktifkan resource yang baru ditambahkan satu per satu untuk mengidentifikasi yang bermasalah. Periksa konsol server untuk kesalahan selama koneksi client.
- Pastikan client RedM pemain sudah diperbarui.
Kesalahan "Could not download file"
- Server mencoba mengirim file besar (misalnya, aset streaming) yang melebihi batas transfer atau koneksi tidak stabil.
- Perbaikan: Kurangi ukuran aset yang di-stream, gunakan CDN/hosting eksternal untuk file besar jika didukung, atau minta pemain mencoba koneksi ulang.
Masalah Basis Data (MySQL / oxmysql)
Sebagian besar framework roleplay RedM menggunakan MySQL untuk penyimpanan data persisten. Konektor basis data yang paling umum adalah oxmysql.
Kesalahan Connection Failed
Jika oxmysql (atau konektor MySQL lainnya) gagal terhubung, periksa hal-hal berikut:
# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"| Kesalahan | Solusi |
|---|---|
ECONNREFUSED atau "Connection refused" |
Server MySQL tidak berjalan, host/port salah, atau server MySQL tidak menerima koneksi eksternal. Verifikasi host, port, dan bahwa server basis data Anda online. |
ER_ACCESS_DENIED_ERROR |
Username atau password salah dalam connection string. Periksa kembali kredensial di panel hosting basis data Anda. |
ER_BAD_DB_ERROR |
Nama basis data tidak ada. Buat basis data terlebih dahulu melalui panel pengelolaan basis data Anda (phpMyAdmin, dll.). |
ETIMEDOUT |
Server basis data tidak dapat dijangkau. Periksa apakah ada aturan firewall yang memblokir koneksi, atau apakah host basis data sudah benar. |
| "Too many connections" | Basis data telah mencapai batas koneksi maksimumnya. Ini dapat terjadi jika resource tidak menutup koneksi dengan benar, atau jika batasnya terlalu rendah. Restart server dan periksa pengaturan max_connections MySQL Anda. |
Tip: Jika server RedM dan basis data MySQL Anda berada di mesin yang sama, gunakan
localhost atau 127.0.0.1 sebagai host. Jika keduanya berada di server yang berbeda, gunakan alamat IP server basis data dan pastikan pengguna MySQL memiliki hak istimewa koneksi jarak jauh.
Tabel Hilang atau Kesalahan Skema
Framework roleplay sering kali memerlukan tabel basis data untuk diatur sebelum dapat berfungsi:
- Periksa dokumentasi framework atau repositori GitHub untuk file impor SQL (sering kali bernama
database.sql,schema.sql, atau serupa). - Impor file SQL ke basis data Anda menggunakan phpMyAdmin atau client MySQL.
- Beberapa framework membuat tabel secara otomatis pada pemulaian pertama. Pastikan pengguna basis data memiliki hak istimewa
CREATE TABLE.
Masalah Performa
Jika server RedM Anda mengalami lag, tick rate rendah, atau performa buruk secara umum:
Mengidentifikasi Masalah Performa
Periksa konsol server untuk peringatan performa. Server RedM menargetkan tick rate sekitar 30-64 tick per detik. Anda dapat memantau ini dengan:
- Dashboard txAdmin: Jika txAdmin tersedia, ia menampilkan metrik performa server secara real-time.
- Konsol server: Perhatikan peringatan "slow tick" atau "resource hitch".
- Perintah resmon: Ketik
resmon 1di konsol server (atau konsol F8) untuk mengaktifkan resource monitor, yang menampilkan waktu CPU per resource.
Solusi Performa Umum
| Masalah | Solusi |
|---|---|
| Penggunaan CPU tinggi dari resource tertentu | Gunakan resmon 1 untuk mengidentifikasi resource. Pertimbangkan untuk menggantinya dengan alternatif yang lebih dioptimalkan, atau hubungi pengembang resource. |
| Terlalu banyak resource yang dimuat | Setiap resource mengonsumsi sumber daya server. Audit daftar resource Anda dan hapus yang tidak terpakai atau redundan. |
| Bottleneck kueri basis data | Kueri basis data yang lambat atau tidak ter-index dapat menyebabkan server hitch. Periksa peringatan slow query oxmysql di konsol. Tambahkan index ke kolom yang sering dikueri. |
| Jumlah pemain tinggi menyebabkan lag | Kurangi sv_maxclients ke tingkat yang dapat ditangani perangkat keras server Anda. Pertimbangkan untuk meningkatkan paket hosting Anda untuk sumber daya lebih banyak. |
| Batas entitas OneSync | Terlalu banyak entitas yang di-spawn (ped, kendaraan, objek) dapat menurunkan performa. Gunakan resource yang membersihkan entitas yang tidak terpakai. |
| Kebocoran memori | Beberapa resource yang dikodekan dengan buruk membocorkan memori dari waktu ke waktu. Pantau penggunaan RAM server di GPanel. Restart server berkala (setiap 6-12 jam) dapat mengurangi hal ini. |
Praktik yang Direkomendasikan
- Jadwalkan restart otomatis setiap 6-12 jam menggunakan fitur schedule GPanel atau txAdmin untuk membersihkan masalah memori dan entitas yang terakumulasi.
- Jaga resource tetap diperbarui untuk mendapatkan manfaat dari perbaikan dan optimasi performa.
- Hindari fungsionalitas duplikat — jangan menjalankan dua resource yang melakukan hal yang sama (misalnya, dua sistem cuaca).
- Uji resource baru di server staging (atau dengan jumlah pemain rendah) sebelum menerapkannya ke server utama Anda.
- Pantau metrik server secara berkala melalui GPanel atau txAdmin untuk menangkap masalah lebih awal.
Catatan: Jika Anda secara konsisten mengalami masalah performa meskipun telah dioptimalkan, server Anda mungkin memerlukan paket hosting tingkat lebih tinggi dengan sumber daya CPU dan RAM yang lebih banyak. Hubungi tim dukungan kami untuk membahas opsi peningkatan.
Tips Pemecahan Masalah Umum
- Selalu baca output konsol server. Hampir setiap kesalahan menyertakan pesan di konsol yang memberi tahu Anda apa yang salah dan di mana.
- Restart server setelah perubahan konfigurasi. Sebagian besar perubahan pada
server.cfgmemerlukan restart server penuh agar diterapkan. - Nonaktifkan resource satu per satu untuk mengisolasi masalah. Jadikan komentar baris
ensurediserver.cfgdengan#. - Simpan cadangan konfigurasi yang berfungsi sebelum melakukan perubahan. Unduh
server.cfgdan basis data Anda sebelum pembaruan besar. - Periksa forum dan dokumentasi Cfx.re di docs.fivem.net untuk dokumentasi resmi yang berlaku untuk FiveM maupun RedM.
- Verifikasi kompatibilitas resource dengan versi server Anda. Resource yang dibangun untuk versi lama mungkin tidak bekerja dengan build RedM saat ini.
Artikel Terkait
- Panduan Pengaturan Server RedM — Kunci lisensi, konfigurasi server.cfg, pengelolaan resource, dan menghubungkan.
- Cara Menemukan IP dan Port Server Anda
- Cara Mengunggah File via SFTP
- Memulai dengan Server Baru Anda
Butuh Bantuan?
Masih mengalami masalah dengan server RedM Anda? Buka tiket dukungan dan sertakan pesan kesalahan apa pun dari konsol server Anda. Tim kami akan membantu Anda mendiagnosis dan menyelesaikan masalah.
