İçeriğe geç

SA-MP Plugin Geliştirme: C++ ile Adım Adım Rehber

SA-MP plugin geliştirme, Pawn ile çözemediğin veya C++ tarafında daha verimli yapabileceğin işleri sunucuya yeni bir modül olarak eklemeni sağlar. Bu rehberde boş bir C++ projesinden başlayıp Pawn tarafından çağrılabilen, Windows’ta .dll, Linux’ta .so olarak çalışan bir plugin hazırlayacağız.

Rehberin sonunda yalnızca örnek kodu derlemiş olmayacaksın. SA-MP ile plugin arasındaki sınırı, dönüş değerlerini, AMX belleğini ve bir pluginin neden yüklenmediğini okuyabilecek seviyeye geleceksin.

Plugin, SA-MP sunucu sürecine yüklenen yerel bir kütüphanedir. Pawn kodu AMX sanal makinesinde çalışırken plugin doğrudan C++ kodu çalıştırır. İki taraf şu noktalar üzerinden konuşur:

Parça Görevi
server.cfg Plugin dosyasını sunucu açılırken yükler.
Plugin giriş fonksiyonları Sunucunun plugin ile kurduğu yaşam döngüsünü yönetir.
AMX Gamemode veya filterscript’in çalışan Pawn örneğini temsil eder.
Native fonksiyon C++ kodunu Pawn tarafından çağrılabilir hale getirir.
Public callback C++ tarafının Pawn script’e olay göndermesini sağlar.
.inc dosyası Pluginin Pawn tarafındaki fonksiyon sözleşmesini tanımlar.

Plugin yazmak, gamemode’u tamamen C++’a taşımak anlamına gelmez. Sağlıklı yaklaşım; oyun kurallarını Pawn’da, performans veya sistem erişimi gerektiren dar işi pluginde tutmaktır.

Şu durumlarda plugin doğru araç olabilir:

  • Pawn’da bulunmayan bir C veya C++ kütüphanesini kullanmak,
  • yoğun veri işleme ya da özel ağ protokolü çalıştırmak,
  • bir servise kontrollü ve yeniden kullanılabilir bir köprü kurmak,
  • birden fazla gamemode’un kullanacağı native API tasarlamak.

Basit komut, checkpoint, oyuncu verisi veya oyun akışı için önce Pawn kullan. Plugin, küçük bir özellik için gereksiz derleme ve çökme riski ekleyebilir. Yerel kodda oluşan erişim ihlali yalnızca script’i değil, bütün sunucu sürecini kapatabilir.

Şunları okuyabiliyor olman yeterli:

  • C++ fonksiyonu, koşul, döngü, pointer ve std::string,
  • Pawn’da fonksiyon, native, forward, public ve referans parametresi,
  • SA-MP sunucusunu çalıştırma ve server.cfg düzenleme.

C++ uzmanı olman beklenmiyor. Ancak pointer’ın bir bellek adresini tuttuğunu ve bir dizinin sınırları dışında okumaman gerektiğini bilmeden AMX verisine dokunmamalısın.

Örnek projenin adı starter olacak. Bölümler ilerledikçe şu yetenekleri ekleyeceğiz:

  • plugin sürümünü döndüren basit native,
  • sayı, string, Float, referans ve dizi parametreleri,
  • C++ tarafından tetiklenen bir Pawn callback’i,
  • ana sunucu döngüsüne güvenli iş aktaran ProcessTick,
  • isteğe bağlı sampgdk entegrasyonu,
  • Windows ve Linux için dağıtılabilir çıktılar.

Kod içindeki sınıf, değişken ve fonksiyon adlarını İngilizce yazacağız. oyuncuSayisi yerine playerCount, mesajGonder yerine SendMessage kullan. Hata metni veya oyuncuya gösterilen içerik Türkçe olabilir.

  1. Geliştirme ortamını ve CMake projesini hazırla.
  2. İlk C++ pluginini derle ve sunucuya yükle.
  3. Pawn tarafından çağrılan native fonksiyonlar yaz.
  4. String, Float, referans ve dizileri AMX belleğinden güvenle oku.
  5. Pluginden Pawn public callback’i çağır.
  6. ProcessTick ve worker thread sınırını doğru kur.
  7. sampgdk ile SA-MP fonksiyonlarını C++ tarafından kullan.
  8. Release çıktısını dağıt ve yükleme hatalarını ayıkla.

Her adım bir öncekinin çalışan hali üzerine kuruluyor. Bir bölümün kontrol listesini tamamlamadan sonrakine geçme; plugin hatalarında en hızlı teşhis yöntemi son çalışan sürüme dönebilmektir.

Klasik SDK ve bu rehber C++ kullanır. Dışarı açılan fonksiyonlar C uyumlu bir ABI ile export edilir; pluginin iç tasarımında C++ sınıfları ve standart kütüphane kullanılabilir.

Derleme yapılabilir ama doğru API tasarlamak zordur. cell, native parametreleri, public callback ve AMX yaşam döngüsü Pawn’ın çalışma biçimiyle doğrudan ilişkilidir.

Gamemode oyun davranışını Pawn ile tanımlar ve .amx olarak çalışır. Plugin sunucu sürecine yerel kütüphane olarak yüklenir. Çoğu projede plugin altyapıyı, gamemode ise oyun kurallarını yönetir.

İlk adım: SA-MP plugin geliştirme ortamını kur.