Dokümantasyon

Kurulumdan ayarlara kadar ihtiyacın olan tüm rehberler ve açıklamalar tek yerde.

Plugin Loader (Nora Loader) Nedir?

Plugin Loader; satın aldığın eklentilerin lisans doğrulamasını yapan, DLL dosyalarını sunucuna otomatik indirip yükleyen özel bir eklenti yönetim sistemidir. Oyun sunucun ile platformumuz arasında güvenli bir köprü görevi görür.

Öne Çıkan Özellikler

  • Otomatik Teslimat: Eklentinin DLL dosyasını manuel indirmezsin; loader sunucudan çekip yükler.
  • Lisans Koruması: Her eklenti kendine özel bir lisans anahtarı (UT-...) ile doğrulanır; IP + port bazlı çalışır.
  • Anti-Tamper: Harmony patch, dnSpy gibi kurcalama girişimleri tespit edilir ve lisans askıya alınır.
  • Kolay Yönetim: Tek bir Licenses.yaml dosyasında tüm eklentilerini yönetirsin.

Nasıl Çalışır?

  1. Kurulum: Loader'ı (NVPluginLoader.dll) RocketMod sunucuna kur.
  2. Yapılandırma: Lisanslarım sayfandan aldığın eklenti adı + lisans anahtarını Licenses.yaml dosyasına yaz.
  3. Otomatik Yükleme: Sunucu başlarken loader lisansı doğrular, IP+portu kaydeder ve eklentiyi otomatik indirir.

Not: Loader yalnızca RocketMod (LDM) altyapısında çalışır.

Loader Kurulumu (RocketMod)

Unturned sunucunda RocketMod (LDM) kullanıyorsan kurulum adımları:

  1. Loader Paketini Edin: Loader paketini (NVPluginLoader.dll + kütüphaneler) yöneticiden / satın aldığın paketle birlikte al.
  2. Loader'ı Kur: NVPluginLoader.dll dosyasını şu klasöre kopyala: /Servers/SunucuAdin/Rocket/Plugins/
  3. Kütüphaneleri Kur: Loader'ın çalışması için gereken WebhookBuilder.dll ve YamlHelper.dll dosyalarını /Servers/SunucuAdin/Rocket/Libraries/ klasörüne kopyala. ⚠️ Bu iki kütüphane zorunludur; eksik olurlarsa loader başlamaz.
  4. Sunucuyu Yeniden Başlat: Loader ilk çalıştırmada Rocket/Plugins/NVPluginLoader/Licenses.yaml dosyasını otomatik oluşturur.
  5. Yapılandır: Oluşan Licenses.yaml dosyasına eklenti adını ve lisans anahtarını gir (Yapılandırma bölümüne bak), sunucuyu tekrar başlat.

Eklenti Adı ve Lisans Anahtarını Alma

Her satın aldığın loader ürünü için sana özel bir lisans anahtarı (UT- ile başlar) üretilir. Bu anahtarı ve eklenti adını almak için:

  1. Hesabına giriş yap.
  2. Sağ üstteki profil menüsünden Lisanslarım sayfasına git.
  3. İlgili kartta Eklenti Adı ve Lisans Anahtarı yazar; yanlarındaki Kopyala butonuyla ikisini de kopyala.
  4. Bu ikisini loader'ın Licenses.yaml dosyasına gireceksin.

Örnek lisans anahtarı: UT-AB12C-D34EF-GH56I-JK78L

Önemli: Lisans anahtarını kimseyle paylaşma. Anahtar yalnızca senin sunucun içindir; paylaşırsan başkası kullanamaz çünkü sunucu IP'ye kilitlenir, ama yine de gizli tut.

Lisanslar Nasıl Çalışır?

Bir loader ürünü satın aldığında lisansı otomatik olarak hesabına tanımlanır ve Lisanslarım sayfasında görünür. Süreç şöyle işler:

  1. Satın Alma: Ürünü aldığında UT- lisans anahtarın otomatik üretilir.
  2. İlk Çalıştırma: Loader'ı yapılandırıp sunucuyu başlattığında, sunucunun IP adresi ve portu otomatik olarak kaydedilir (senin bir şey girmene gerek yok).
  3. Otomatik Doğrulama: Sonraki her başlatmada loader bu IP:Port'u doğrular ve eklentiyi indirir.
  4. Kart Dolar: Lisanslarım sayfasındaki "Kayıtlı Sunucular" kısmı, loader ilk çalıştığında otomatik dolar.

Önemli Kısıtlamalar

  • ⚠️ IP + Port Kilidi: Lisans yalnızca kayıtlı IP:Port'ta çalışır. Portunu değiştirirsen loader "PORT YANLIŞ" der ve yüklemez.
  • ⚠️ Sunucu Limiti: Varsayılan olarak lisans tek sunucuda çalışır. Birden fazla sunucu (2. VDS) için yöneticiden IP limitinin artırılmasını isteyebilirsin.
  • ⚠️ Paylaşım Yasak: Lisansını başkasının sunucusunda kullanamazsın.

Sık Karşılaşılan Sorunlar

Loader Hiç Başlamıyor

  • WebhookBuilder.dll ve YamlHelper.dll dosyalarının Rocket/Libraries/ klasöründe olduğundan emin ol; bu kütüphaneler eksikse loader yüklenmez.

Licenses.yaml Oluşmadı

  • NVPluginLoader.dll dosyasının Rocket/Plugins/ klasöründe olduğundan emin ol.
  • Sunucunun klasöre yazma izni olmalı.
  • Sunucuyu bir kez tam başlatıp kapat; dosya Rocket/Plugins/NVPluginLoader/ altında oluşur.

"PORT YANLIŞ" Uyarısı

  • Sunucunun portu, lisansa kayıtlı porttan farklı. Ya sunucu portunu eski haline getir, ya da Lisanslarım'dan yeni port için whitelist talebi gönder.

"IP Whitelist'te Kayıtlı Değil"

  • Bu sunucunun IP'si lisansta kayıtlı değil ve limit dolu. Lisanslarım → + Yeni IP Ekle ile talep gönder, yönetici onaylasın.

Eklenti "Askıda" Görünüyor

  • Harmony patch / kural ihlali nedeniyle lisans askıya alınmış. Destek talebi (ticket) aç.

Loader Sürümü Doğrulanamadı

  • Elindeki loader eski. Yöneticiden en güncel loader sürümünü iste ve değiştir.

Sunucu Yanıt Vermiyor

  • Sunucunun internet erişimi olmalı; giden bağlantıları engelleyen güvenlik duvarı kurallarını kontrol et.

Kuruluma Dair Önemli Notlar

Kurulum sırasında dikkat etmen gereken noktalar:

  • Loader yalnızca RocketMod ile çalışır (OpenMod desteklenmez).
  • WebhookBuilder.dll ve YamlHelper.dll kütüphaneleri Rocket/Libraries/ klasöründe olmalı; eksikse loader hiç başlamaz.
  • Sunucunun Rocket/Plugins klasörüne yazma erişimi olmalı; yoksa Licenses.yaml oluşamaz.
  • Kurulumdan sonra sunucu konsolunu kontrol et; loader'ın durum mesajları (yüklendi / port yanlış / IP kayıtlı değil) orada görünür.
  • Loader sürümü sunucudaki sürümle eşleşmezse eklentiler yüklenmez; her zaman en güncel loader'ı kullan.

Licenses.yaml Yapılandırması

Loader ilk çalıştığında /Servers/SunucuAdin/Rocket/Plugins/NVPluginLoader/Licenses.yaml dosyasını oluşturur. Bu dosyayı açıp eklenti adını ve lisans anahtarını girmen yeterli:

Plugins:
- Name: DropRestrictions
  License: UT-AB12C-D34EF-GH56I-JK78L

Name: Lisanslarım sayfasındaki eklenti adı (birebir aynı olmalı).
License: Lisanslarım sayfasındaki UT- ile başlayan anahtar.

Birden fazla eklenti için satırları çoğaltabilirsin:

Plugins:
- Name: DropRestrictions
  License: UT-AB12C-D34EF-GH56I-JK78L
- Name: BankPlugin
  License: UT-MN90P-QR12S-TU34V-WX56Y

Kaydedip sunucuyu yeniden başlat. Loader eklentiyi otomatik indirip yükleyecektir.

IP / Port Değişikliği ve Sunucu Ekleme

Sunucunun adresi değiştiyse ya da yeni bir sunucu eklemek istiyorsan:

  1. Lisanslarım sayfasına git.
  2. İlgili kartta + Yeni IP Ekle butonuna tıkla.
  3. Yeni IP ve portu gir (veya loader'ı deneyip whitelist'e takılan sunucular listeden çıkarsa oradan seç).
  4. Whitelist Talebi Gönder de. Talebin yöneticiye düşer.
  5. Yönetici onayladıktan sonra eklentin yeni adreste çalışmaya başlar.

Eklentini geçici kapatma: Kartın sağ üstündeki aç/kapa düğmesiyle eklentini istediğin an kendin devre dışı bırakıp tekrar açabilirsin.

Askıya alınma: Sunucunda Harmony patch / kurcalama tespit edilirse lisansın otomatik askıya alınır ve sana bildirim + mail gelir. Bu durumda destek talebi (ticket) açman gerekir.

Hâlâ Sorun mu Yaşıyorsun?

Sorunun devam ediyorsa destek ekibimiz yardımcı olur:

  • Site üzerinden ilgili kategoride bir destek talebi (ticket) oluştur.
  • Hızlı topluluk desteği için Discord sunucumuza katıl.
  • Talebine sunucu konsol loglarını ekle (lisans anahtarını gizlemeyi unutma!).
  • Denediğin çözümleri kısaca yaz; sorun daha hızlı çözülür.

RCON Nasıl Aktif Edilir?

RCON (Remote Console), sunucuna oyuna girmeden uzaktan komut göndermeni sağlayan sistemdir. RCON'u aktif ettikten sonra sitemizdeki RCON Konsol aracıyla tarayıcından sunucunu yönetebilirsin.

1. Rocket.config.xml dosyasını bul

RCON özelliği RocketMod ile gelir. Sunucu dosyalarında şu yola git:

Unturned/Servers/SunucuAdın/Rocket/Rocket.config.xml

2. RCON satırını düzenle

Dosyayı bir metin editörüyle aç ve <RCON> satırını bul. Şu şekilde düzenle:

<RCON Enabled="true" Port="27017" Password="BuraYaGucLuBirSifre" />
  • Enabled: true yaparak RCON'u açıyorsun.
  • Port: RCON'un dinleyeceği port. Varsayılan 27017 genelde uygundur; oyun portundan farklı olmalıdır.
  • Password: RCON şifren. Mutlaka güçlü ve tahmin edilemez bir şifre kullan — bu şifreyi bilen herkes sunucunda komut çalıştırabilir!

3. Portu aç

Sunucunu bir firma panelinden kiraladıysan panelden, kendi makinende çalıştırıyorsan güvenlik duvarından (firewall) RCON portunu TCP olarak açman gerekir. Emin değilsen hosting firmana "27017 TCP portunu açar mısınız?" diye sorman yeterli.

4. Sunucuyu yeniden başlat

Ayarların geçerli olması için sunucuyu kapatıp aç. Konsolda RocketRcon ile ilgili bir satır görüyorsan RCON çalışıyor demektir.

5. Bağlan ve yönet!

Artık hazırsın. RCON Konsol sayfamıza git; sunucu IP'ni, RCON portunu ve şifreni gir. Bağlandıktan sonra komut gönderebilir, konsolu izleyebilir ve sağdaki oyuncu kartlarından tek tıkla kick / ban / heal işlemleri yapabilirsin.

İpucu: Siteye giriş yaparsan RCON bağlantı bilgilerini kaydedebilirsin; bir dahaki girişinde form otomatik dolar.

Cevabını bulamadın mı?

Sıkça sorulan sorular bölümüne göz at veya destek ekibimizle Discord üzerinden iletişime geç!