Bu kılavuz, Legion Hosting üzerindeki BeamMP sunucunuz için yönetici kurulumunu, sunucu tarafı kaynaklarını, özel haritaları, araç yönetimini ve sorun gidermeyi kapsar. İlk sunucu kurulumu, kimlik doğrulama anahtarları ve temel yapılandırma için BeamMP Sunucu Kurulum Kılavuzu'na bakın.

---

Yönetici Kurulumu

BeamMP'nin geleneksel bir yönetici girişi veya parola sistemi yoktur. Bunun yerine yönetici komutları, sunucu konsolu aracılığıyla veya oyuncu tanımlayıcılarını kontrol eden sunucu tarafı Lua eklentileri aracılığıyla çalıştırılır.

Konsol Komutları

GPanel'deki sunucu konsolu, yerleşik sunucu komutlarına doğrudan erişim sağlar. Komutları doğrudan konsol giriş alanına yazın:

---

Kaynaklar Klasör Yapısı

BeamMP, sunucu tarafı içeriğini düzenlemek için bir Resources klasörü kullanır. Bu klasör, farklı amaçlara sahip iki alt dizin içerir:

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

İstemci Kaynakları

Resources/Client/ içine yerleştirilen dosyalar, oyuncular bağlandığında otomatik olarak indirilir. Bu, şunlar için kullanılır:

• Özel haritalar — Oyuncuların sunucunun haritasını yüklemesi için gereken harita modu .zip dosyaları.
• Özel araçlar — Yeni arabalar ekleyen veya mevcut olanları değiştiren araç modu .zip dosyaları.
• Diğer istemci modları — İstemcide bulunması gereken herhangi bir BeamNG.drive modu.

Sunucu Kaynakları (Lua Eklentileri)

Resources/Server/ dizini, sunucu tarafı Lua eklentilerini içerir. Bunlar yalnızca sunucuda çalışır ve oyunculara gönderilmez. Her eklenti, bir main.lua dosyasıyla birlikte kendi alt klasöründe bulunur:

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

Sunucu tarafı eklentiler şunları yapabilir:

• Oyuncu olaylarına yanıt verme (katılma, ayrılma, sohbet mesajları, araç oluşturma).
• Sohbet aracılığıyla tetiklenen özel komutlar uygulama (ör. /tp, /give).
• Araç izinlerini ve sınırlarını yönetme.
• Ekonomi sistemleri, ışınlanma veya diğer özel oyun özellikleri ekleme.
• Oyuncu etkinliğini günlüğe kaydetme ve kuralları uygulama.

---

Özel Harita Ekleme

BeamMP sunucunuzda özel (varsayılan olmayan) bir harita çalıştırmak için:

1. Haritayı bir BeamNG.drive mod kaynağından (ör. BeamNG.drive mod deposu) .zip dosyası olarak indirin.
2. Sunucunuzu GPanel'de durdurun.
3. .zip dosyasını Files sekmesi üzerinden veya SFTP ile Resources/Client/ içine yükleyin. Zip dosyasını çıkarmayın.
4. MAP başlangıç değişkenini (veya ServerConfig.toml içindeki Map) özel harita için doğru harita yoluna güncelleyin. Bu yol genellikle /levels/map_name/info.json biçimindedir — tam yol için modun belgelerine bakın.
5. Sunucuyu başlatın.

---

Araç Yönetimi

BeamMP sunucularında araç yönetimi, MaxCars ayarı ve isteğe bağlı olarak sunucu tarafı Lua eklentileri aracılığıyla kontrol edilir.

MaxCars Ayarı

ServerConfig.toml içindeki MaxCars ayarı (veya MAX_CARS başlangıç değişkeni), her oyuncunun aynı anda kaç araç oluşturabileceğini kontrol eder:

• 1 — Her oyuncu aynı anda bir araca sahip olabilir (daha büyük sunucular için önerilir).
• 2–3 — Oyuncuların birkaç araca sahip olmasına olanak tanır; daha küçük sunucular veya araba buluşmaları için kullanışlıdır.
• Daha yüksek değerler sunucu yükünü orantılı olarak artırır.

Özel Araç Modları

Sunucunuza özel araçlar eklemek için:

1. Araç modunu .zip dosyası olarak indirin.
2. Onu Resources/Client/ içine yerleştirin.
3. Sunucuyu yeniden başlatın. Oyuncular bağlandıklarında araç modunu otomatik olarak indirir.

Eklentiler Aracılığıyla Araç Kısıtlama

Daha ayrıntılı kontrol için (ör. belirli araçları yasaklama, araç türlerini sınırlama), bir sunucu tarafı Lua eklentisine ihtiyacınız olacaktır. Bu eklentiler, araç oluşturma olaylarını engelleyebilir ve özel kurallara göre bunlara izin verebilir veya reddedebilir. Araç yönetimi eklentileri için BeamMP forumlarını kontrol edin.

---

Eklenti Kurulumu ve Yönetimi

Sunucu tarafı Lua eklentileri, sunucunuzun işlevselliğini genişletir. Bunları nasıl kurup yöneteceğiniz aşağıda açıklanmıştır:

Eklenti Kurma

1. Eklenti dosyalarını (genellikle main.lua ve muhtemelen diğer dosyaları içeren bir klasör) indirin.
2. Sunucunuzu durdurun.
3. Eklenti klasörünü Files sekmesi veya SFTP aracılığıyla Resources/Server/ içine yükleyin.
4. Klasör yapısının doğru olduğundan emin olun: Resources/Server/PluginName/main.lua.
5. Sunucuyu başlatın. Eklentiler yüklenirken konsol mesajları gösterecektir.

Eklenti Kaldırma

1. Sunucunuzu durdurun.
2. Eklenti klasörünü Resources/Server/ içinden silin.
3. Sunucuyu başlatın.

---

Sorun Giderme

Kimlik Doğrulama Anahtarı Hataları

• Anahtarın AUTH_KEY başlangıç değişkenine doğru bir şekilde yapıştırıldığını doğrulayın — fazladan boşluk veya satır sonu olmamalıdır.
• Anahtarın BeamMP Keymaster üzerinde iptal edilmediğinden veya süresinin dolmadığından emin olun.
• Her anahtar aynı anda yalnızca bir sunucuda kullanılabilir. Aynı anahtarı başka bir yerde kullanıyorsanız başarısız olur.
• Anahtar geçersizse, konsol başlangıçta kimlik doğrulama hatalarını görüntüler.

Oyuncular Bağlanamıyor

• Sunucunun tamamen başladığını ve GPanel'de çevrimiçi olarak göründüğünü onaylayın.
• Oyuncunun standart BeamNG.drive başlatıcısını değil, BeamMP başlatıcısını kullandığını kontrol edin.
• Sunucu Private = true olarak ayarlanmışsa, oyuncular doğru IP ve port ile direct connect kullanmalıdır. Sunucu IP ve Portunuzu Nasıl Bulursunuz sayfasına bakın.
• Oyuncunun BeamMP başlatıcı sürümünün sunucu sürümüyle uyumlu olduğundan emin olun. Güncel olmayan başlatıcılar bağlanamayabilir.
• Sunucu doluysa (MaxPlayers sayısına ulaşıldıysa), biri ayrılana kadar ek oyuncular katılamaz.

Mod Senkronizasyon Sorunları

• Oyuncular indirme sırasında takılıp kalıyorsa veya eksik modlar hakkında hata alıyorsa, Resources/Client/ içindeki mod .zip dosyalarının bozuk olmadığını doğrulayın.
• .zip hasarlıysa mod dosyasını yeniden indirip yeniden yükleyin.
• Çok büyük mod dosyaları, yavaş bağlantısı olan oyuncular için zaman aşımlarına neden olabilir. Gereksiz büyük modları kaldırmayı düşünün.
• Mod .zip dosyalarının iç içe geçmediğinden emin olun (yani başka bir .zip içindeki bir klasörün içinde bir .zip).

Çok Sayıda Oyuncu/Araç ile Performans Sorunları

• MaxCars değerini oyuncu başına 1'e düşürün.
• Sunucu sürekli gecikme yaşıyorsa MaxPlayers değerini azaltın.
• Yüksek oyuncu sayılarında daha iyi performans için daha basit bir haritaya (Grid Map veya Industrial) geçin.
• İndirme sürelerini ve bellek kullanımını azaltmak için gereksiz istemci modlarını Resources/Client/ içinden kaldırın.
• GPanel'in kaynak kullanım grafiklerini kontrol edin — CPU veya RAM sürekli sınırdaysa, sunucu planınızı yükseltmeyi düşünün. Seçenekleri görüşmek için bir destek talebi açın.

Sunucu Tarayıcıda Görünmüyor

• Yapılandırmanızda Private değerinin false olarak ayarlandığından emin olun.
• Kimlik doğrulama anahtarının geçerli olduğunu ve başka bir sunucu tarafından kullanılmadığını doğrulayın.
• Sunucunun BeamMP arka ucuna kaydolması için başlangıçtan sonra 1–2 dakika bekleyin.
• Konsolda ana sunucu bağlantısıyla ilgili herhangi bir hata olup olmadığını kontrol edin.

---

İlgili Makaleler

• BeamMP Sunucu Kurulum Kılavuzu — İlk kurulum, kimlik doğrulama anahtarı, yapılandırma ve bağlantı talimatları
• Sunucu IP ve Portunuzu Nasıl Bulursunuz
• SFTP ile Dosyalar Nasıl Yüklenir
• Sunucu Başlatma Kılavuzu — Legion Hosting'de herhangi bir oyun sunucusunu başlatmak için genel kılavuz

---

Daha Fazla Yardıma mı İhtiyacınız Var?

Bu kılavuzda ele alınmayan sorunlarla karşılaşıyorsanız, destek ekibimiz size yardımcı olmaya hazırdır. Sunucu ayrıntılarınız, sorunun bir açıklaması ve GPanel konsolundan ilgili hata mesajlarıyla birlikte legionhosting.net/submitticket.php adresinden bir talep açın.