Bu təlimat Legion Hosting-dəki BeamMP serveriniz üçün admin quraşdırmasını, server tərəfi resursları, xüsusi xəritələri, nəqliyyat vasitəsi idarəetməsini və problemlərin həllini əhatə edir. İlkin server quraşdırması, autentifikasiya açarları və əsas konfiqurasiya üçün BeamMP Server Quraşdırma Təlimatına baxın.

---

Admin Quraşdırması

BeamMP-də ənənəvi admin giriş və ya parol sistemi yoxdur. Əvəzində admin əmrləri server konsolu vasitəsilə və ya oyunçu identifikatorlarını yoxlayan server tərəfi Lua plaginləri vasitəsilə icra edilir.

Konsol Əmrləri

GPanel-dəki server konsolu daxili server əmrlərinə birbaşa giriş təmin edir. Əmrləri birbaşa konsol daxiletmə sahəsinə yazın:

---

Resurslar Qovluğunun Strukturu

BeamMP server tərəfi məzmunu təşkil etmək üçün Resources qovluğundan istifadə edir. Bu qovluq fərqli məqsədləri olan iki alt qovluq ehtiva edir:

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

Müştəri Resursları

Resources/Client/ qovluğuna yerləşdirilən fayllar oyunçular qoşulduqda avtomatik olaraq yüklənir. Bu aşağıdakılar üçün istifadə olunur:

• Xüsusi xəritələr — Oyunçuların serverin xəritəsini yükləməsi üçün lazım olan xəritə modu .zip faylları.
• Xüsusi nəqliyyat vasitələri — Yeni avtomobillər əlavə edən və ya mövcud olanları dəyişdirən nəqliyyat vasitəsi modu .zip faylları.
• Digər müştəri modları — Müştəri tərəfində mövcud olması lazım olan istənilən BeamNG.drive modu.

Server Resursları (Lua Plaginləri)

Resources/Server/ qovluğu server tərəfi Lua plaginlərini ehtiva edir. Bunlar yalnız serverdə işləyir və oyunçulara göndərilmir. Hər plagin main.lua faylı olan öz alt qovluğunda yerləşir:

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

Server tərəfi plaginlər aşağıdakıları edə bilər:

• Oyunçu hadisələrinə cavab vermə (qoşulma, ayrılma, söhbət mesajları, nəqliyyat vasitəsi yaratma).
• Söhbət vasitəsilə işə salınan xüsusi əmrləri həyata keçirmə (məs., /tp, /give).
• Nəqliyyat vasitəsi icazələrini və limitlərini idarə etmə.
• İqtisadiyyat sistemləri, teleportasiya və ya digər xüsusi oyun xüsusiyyətləri əlavə etmə.
• Oyunçu fəaliyyətini qeyd etmə və qaydaları tətbiq etmə.

---

Xüsusi Xəritələrin Əlavə Edilməsi

BeamMP serverinizdə xüsusi (standart olmayan) xəritə işə salmaq üçün:

1. Xəritə modunu BeamNG.drive mod mənbəyindən (məs., BeamNG.drive mod deposu) .zip faylı olaraq yükləyin.
2. GPanel-də serverinizi dayandırın.
3. .zip faylını Files nişanı və ya SFTP vasitəsilə Resources/Client/ qovluğuna yükləyin. Zip faylını açmayın.
4. MAP başlanğıc dəyişənini (və ya ServerConfig.toml-dakı Map) xüsusi xəritə üçün düzgün xəritə yoluna yeniləyin. Bu yol adətən /levels/map_name/info.json formatındadır — dəqiq yol üçün modun sənədlərinə baxın.
5. Serveri başladın.

---

Nəqliyyat Vasitəsi İdarəetməsi

BeamMP serverlərində nəqliyyat vasitəsi idarəetməsi MaxCars parametri və ixtiyari olaraq server tərəfi Lua plaginləri vasitəsilə idarə olunur.

MaxCars Parametri

ServerConfig.toml-dakı MaxCars parametri (və ya MAX_CARS başlanğıc dəyişəni) hər oyunçunun eyni anda neçə nəqliyyat vasitəsi yarada biləcəyini idarə edir:

• 1 — Hər oyunçu eyni anda bir nəqliyyat vasitəsinə sahib ola bilər (böyük serverlər üçün tövsiyə olunur).
• 2–3 — Oyunçulara bir neçə nəqliyyat vasitəsinə sahib olmağa imkan verir, kiçik serverlər və ya avtomobil görüşləri üçün faydalıdır.
• Daha yüksək dəyərlər server yükünü mütənasib olaraq artırır.

Xüsusi Nəqliyyat Vasitəsi Modları

Serverinizə xüsusi nəqliyyat vasitələri əlavə etmək üçün:

1. Nəqliyyat vasitəsi modunu .zip faylı olaraq yükləyin.
2. Resources/Client/ qovluğuna yerləşdirin.
3. Serveri yenidən başladın. Oyunçular qoşulduqda nəqliyyat vasitəsi modunu avtomatik yükləyəcək.

Plaginlər Vasitəsilə Nəqliyyat Vasitələrinin Məhdudlaşdırılması

Daha dəqiq nəzarət üçün (məs., xüsusi nəqliyyat vasitələrini qadağan etmə, nəqliyyat vasitəsi növlərini məhdudlaşdırma) server tərəfi Lua plagininə ehtiyacınız olacaq. Bu plaginlər nəqliyyat vasitəsi yaratma hadisələrini ələ keçirə və xüsusi qaydalara əsasən icazə verə və ya rədd edə bilər. Nəqliyyat vasitəsi idarəetmə plaginləri üçün BeamMP forumlarına baxın.

---

Plaginlərin Quraşdırılması və İdarə Edilməsi

Server tərəfi Lua plaginləri serverinizin funksionallığını genişləndirir. Onları necə quraşdırmaq və idarə etmək olar:

Plaginin Quraşdırılması

1. Plagin fayllarını yükləyin (adətən main.lua və ehtimal olunan digər faylları ehtiva edən qovluq).
2. Serverinizi dayandırın.
3. Plagin qovluğunu Files nişanı və ya SFTP vasitəsilə Resources/Server/ qovluğuna yükləyin.
4. Qovluq strukturunun düzgün olduğundan əmin olun: Resources/Server/PluginName/main.lua.
5. Serveri başladın. Plaginlər yükləndikcə konsolda mesajlar görünəcək.

Plaginin Silinməsi

1. Serverinizi dayandırın.
2. Plagin qovluğunu Resources/Server/ qovluğundan silin.
3. Serveri başladın.

---

Problemlərin Həlli

Autentifikasiya Açarı Xətaları

• Açarın AUTH_KEY başlanğıc dəyişəninə düzgün yapışdırıldığını yoxlayın — əlavə boşluq və ya sətir fasiləsi olmamalıdır.
• Açarın BeamMP Keymaster-da ləğv edilmədiyini və ya müddətinin bitmədiyini yoxlayın.
• Hər açar eyni anda yalnız bir serverdə istifadə edilə bilər. Eyni açarı başqa yerdə istifadə edirsinizsə, uğursuz olacaq.
• Açar etibarsız olarsa, konsol başlanğıcda autentifikasiya xətalarını göstərəcək.

Oyunçular Qoşula Bilmir

• Serverin tam başladığını və GPanel-də onlayn göründüyünü təsdiqləyin.
• Oyunçunun standart BeamNG.drive başladıcısı deyil, BeamMP başladıcısı istifadə etdiyini yoxlayın.
• Server Private = true olaraq təyin edilibsə, oyunçular düzgün IP və port ilə birbaşa qoşulma istifadə etməlidirlər. Server IP və Portunuzu Necə Tapmalı bölməsinə baxın.
• Oyunçunun BeamMP başladıcı versiyasının server versiyası ilə uyğun olduğundan əmin olun. Köhnəlmiş başladıcılar qoşula bilməyə bilər.
• Server doludursa (MaxPlayers limitinə çatıbsa), kimsə ayrılana qədər əlavə oyunçular qoşula bilməz.

Mod Sinxronizasiya Problemləri

• Oyunçular yükləmə zamanı ilişib qalırsa və ya çatışmayan modlar haqqında xətalar alırsa, Resources/Client/ qovluğundakı mod .zip fayllarının zədələnmədiyini yoxlayın.
• .zip zədələnibsə, mod faylını yenidən yükləyin və yenidən servərə yükləyin.
• Çox böyük mod faylları yavaş bağlantılı oyunçular üçün zaman aşımına səbəb ola bilər. Lazımsız böyük modları silməyi düşünün.
• Mod .zip fayllarının iç-içə olmadığından əmin olun (yəni, başqa bir .zip içindəki qovluğun içində .zip).

Çoxlu Oyunçu/Nəqliyyat Vasitəsi ilə Performans Problemləri

• MaxCars parametrini hər oyunçu üçün 1-ə endirin.
• Server davamlı gecikmə yaşayırsa MaxPlayers parametrini azaldın.
• Yüksək oyunçu sayı ilə daha yaxşı performans üçün daha sadə xəritəyə (Grid Map və ya Industrial) keçin.
• Yükləmə vaxtlarını və yaddaş istifadəsini azaltmaq üçün lazımsız müştəri modlarını Resources/Client/ qovluğundan silin.
• GPanel-in resurs istifadə qrafiklərini yoxlayın — CPU və ya RAM davamlı olaraq limitdədirsə, server planınızı yüksəltməyi düşünün. Seçimləri müzakirə etmək üçün dəstək sorğusu açın.

Server Brauzerdə Görünmür

• Konfiqurasiyanızda Private parametrinin false olaraq təyin edildiyinə əmin olun.
• Autentifikasiya açarının etibarlı olduğunu və başqa server tərəfindən istifadə edilmədiyini yoxlayın.
• Serverin BeamMP backend ilə qeydiyyatdan keçməsi üçün başlanğıcdan sonra 1–2 dəqiqə gözləyin.
• Konsolda master server bağlantısı ilə əlaqəli hər hansı xətanı yoxlayın.

---

Əlaqəli Məqalələr

• BeamMP Server Quraşdırma Təlimatı — İlkin quraşdırma, autentifikasiya açarı, konfiqurasiya və qoşulma təlimatları
• Server IP və Portunuzu Necə Tapmalı
• SFTP vasitəsilə Faylları Necə Yükləməli
• Server Başlatma Təlimatı — Legion Hosting-də istənilən oyun serverini başlatmaq üçün ümumi təlimat

---

Əlavə Kömək Lazımdır?

Bu təlimatda əhatə olunmayan problemlər yaşayırsınızsa, dəstək komandamız kömək etməyə hazırdır. Server məlumatlarınız, problemin təsviri və GPanel konsolundan müvafiq xəta mesajları ilə legionhosting.net/submitticket.php ünvanında sorğu açın.