Panduan ini mencakup pengaturan admin, resource sisi server, peta kustom, manajemen kendaraan, dan pemecahan masalah untuk server BeamMP Anda di Legion Hosting. Untuk pengaturan server awal, kunci autentikasi, dan konfigurasi dasar, lihat Panduan Pengaturan Server BeamMP.

---

Pengaturan Admin

BeamMP tidak memiliki sistem login atau kata sandi admin tradisional. Sebagai gantinya, perintah admin dijalankan melalui konsol server atau via plugin Lua sisi server yang memeriksa pengenal pemain.

Perintah Konsol

Konsol server di GPanel menyediakan akses langsung ke perintah server bawaan. Ketik perintah langsung ke kolom input konsol:

---

Struktur Folder Resources

BeamMP menggunakan folder Resources untuk mengorganisir konten sisi server. Folder ini berisi dua subdirektori dengan tujuan yang berbeda:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Resource Client

File yang ditempatkan di Resources/Client/ secara otomatis diunduh oleh pemain saat mereka terhubung. Ini digunakan untuk:

• Peta kustom — File .zip mod peta yang dibutuhkan pemain untuk memuat peta server.
• Kendaraan kustom — File .zip mod kendaraan yang menambahkan mobil baru atau memodifikasi yang sudah ada.
• Mod client lainnya — Mod BeamNG.drive apa pun yang perlu ada di client.

Resource Server (Plugin Lua)

Direktori Resources/Server/ berisi plugin Lua sisi server. Plugin ini berjalan hanya di server dan tidak dikirim ke pemain. Setiap plugin berada di subfoldernya sendiri dengan file main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Plugin sisi server dapat:

• Merespons event pemain (bergabung, keluar, pesan obrolan, spawn kendaraan).
• Menerapkan perintah kustom yang dipicu via obrolan (mis., /tp, /give).
• Mengelola izin dan batas kendaraan.
• Menambahkan sistem ekonomi, teleportasi, atau fitur gameplay kustom lainnya.
• Mencatat aktivitas pemain dan menegakkan aturan.

---

Menambahkan Peta Kustom

Untuk menjalankan peta kustom (non-default) di server BeamMP Anda:

1. Unduh mod peta sebagai file .zip dari sumber mod BeamNG.drive (mis., repositori mod BeamNG.drive).
2. Hentikan server Anda di GPanel.
3. Unggah file .zip ke Resources/Client/ via tab Files atau SFTP. Jangan ekstrak zip-nya.
4. Perbarui variabel startup MAP (atau Map di ServerConfig.toml) ke jalur peta yang benar untuk peta kustom. Jalur ini biasanya dalam format /levels/map_name/info.json — periksa dokumentasi mod untuk jalur yang tepat.
5. Mulai server.

---

Manajemen Kendaraan

Manajemen kendaraan di server BeamMP dikontrol melalui pengaturan MaxCars dan secara opsional melalui plugin Lua sisi server.

Pengaturan MaxCars

Pengaturan MaxCars di ServerConfig.toml (atau variabel startup MAX_CARS) mengontrol berapa banyak kendaraan yang dapat di-spawn setiap pemain secara bersamaan:

• 1 — Setiap pemain dapat memiliki satu kendaraan pada satu waktu (direkomendasikan untuk server yang lebih besar).
• 2–3 — Memungkinkan pemain memiliki beberapa kendaraan, berguna untuk server yang lebih kecil atau pertemuan mobil.
• Nilai yang lebih tinggi meningkatkan beban server secara proporsional.

Mod Kendaraan Kustom

Untuk menambahkan kendaraan kustom ke server Anda:

1. Unduh mod kendaraan sebagai file .zip.
2. Tempatkan di Resources/Client/.
3. Mulai ulang server. Pemain akan secara otomatis mengunduh mod kendaraan saat terhubung.

Membatasi Kendaraan via Plugin

Untuk kontrol yang lebih terperinci (mis., memblokir kendaraan tertentu, membatasi jenis kendaraan), Anda memerlukan plugin Lua sisi server. Plugin ini dapat mencegat event spawn kendaraan dan mengizinkan atau menolaknya berdasarkan aturan kustom. Periksa forum BeamMP untuk plugin manajemen kendaraan.

---

Menginstal dan Mengelola Plugin

Plugin Lua sisi server memperluas fungsionalitas server Anda. Berikut cara menginstal dan mengelolanya:

Menginstal Plugin

1. Unduh file plugin (biasanya folder yang berisi main.lua dan mungkin file lainnya).
2. Hentikan server Anda.
3. Unggah folder plugin ke Resources/Server/ via tab Files atau SFTP.
4. Pastikan struktur folder benar: Resources/Server/PluginName/main.lua.
5. Mulai server. Konsol akan menampilkan pesan saat plugin dimuat.

Menghapus Plugin

1. Hentikan server Anda.
2. Hapus folder plugin dari Resources/Server/.
3. Mulai server.

---

Pemecahan Masalah

Error Kunci Autentikasi

• Verifikasi kunci ditempel dengan benar di variabel startup AUTH_KEY — tanpa spasi tambahan atau jeda baris.
• Pastikan kunci belum dicabut atau kedaluwarsa di BeamMP Keymaster.
• Setiap kunci hanya dapat digunakan pada satu server pada satu waktu. Jika Anda menggunakan kunci yang sama di tempat lain, akan gagal.
• Konsol akan menampilkan error autentikasi saat startup jika kunci tidak valid.

Pemain Tidak Dapat Terhubung

• Konfirmasikan server sudah sepenuhnya dimulai dan ditampilkan sebagai online di GPanel.
• Periksa bahwa pemain menggunakan launcher BeamMP, bukan launcher BeamNG.drive standar.
• Jika server diatur ke Private = true, pemain harus menggunakan direct connect dengan IP dan port yang benar. Lihat Cara Menemukan IP dan Port Server Anda.
• Pastikan versi launcher BeamMP pemain kompatibel dengan versi server. Launcher yang usang mungkin gagal terhubung.
• Jika server penuh (MaxPlayers tercapai), pemain tambahan tidak dapat bergabung sampai seseorang keluar.

Masalah Sinkronisasi Mod

• Jika pemain terjebak mengunduh atau menerima error tentang mod yang hilang, verifikasi file .zip mod di Resources/Client/ tidak rusak.
• Unduh ulang dan unggah ulang file mod jika .zip-nya rusak.
• File mod yang sangat besar dapat menyebabkan timeout bagi pemain dengan koneksi lambat. Pertimbangkan untuk menghapus mod besar yang tidak perlu.
• Pastikan file .zip mod tidak bersarang (yaitu, .zip di dalam folder di dalam .zip lain).

Masalah Performa dengan Banyak Pemain/Kendaraan

• Kurangi MaxCars ke 1 per pemain.
• Turunkan MaxPlayers jika server mengalami lag yang konsisten.
• Beralih ke peta yang lebih sederhana (Grid Map atau Industrial) untuk performa yang lebih baik dengan jumlah pemain tinggi.
• Hapus mod client yang tidak perlu dari Resources/Client/ untuk mengurangi waktu unduh dan penggunaan memori.
• Periksa grafik penggunaan resource GPanel — jika CPU atau RAM secara konsisten berada pada batas, pertimbangkan untuk meng-upgrade paket server Anda. Buka tiket dukungan untuk mendiskusikan opsi.

Server Tidak Muncul di Browser

• Pastikan Private diatur ke false dalam konfigurasi Anda.
• Verifikasi kunci autentikasi valid dan tidak sedang digunakan oleh server lain.
• Tunggu 1–2 menit setelah startup agar server terdaftar dengan backend BeamMP.
• Periksa konsol untuk error apa pun terkait koneksi master server.

---

Artikel Terkait

• Panduan Pengaturan Server BeamMP — Pengaturan awal, kunci autentikasi, konfigurasi, dan petunjuk koneksi
• Cara Menemukan IP dan Port Server Anda
• Cara Mengunggah File via SFTP
• Panduan Memulai Server — Panduan umum untuk memulai server game apa pun di Legion Hosting

---

Butuh Bantuan Lebih Lanjut?

Jika Anda mengalami masalah yang tidak tercakup dalam panduan ini, tim dukungan kami siap membantu. Buka tiket di legionhosting.net/submitticket.php dengan detail server Anda, deskripsi masalah, dan pesan error relevan apa pun dari konsol GPanel.