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.
SA-MP plugin nedir?
Bölüm başlığı “SA-MP plugin nedir?”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.
Ne zaman plugin yazmalısın?
Bölüm başlığı “Ne zaman plugin yazmalısın?”Ş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.
Başlamadan önce
Bölüm başlığı “Başlamadan önce”Şunları okuyabiliyor olman yeterli:
- C++ fonksiyonu, koşul, döngü, pointer ve
std::string, - Pawn’da fonksiyon,
native,forward,publicve referans parametresi, - SA-MP sunucusunu çalıştırma ve
server.cfgdü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.
Geliştireceğimiz plugin
Bölüm başlığı “Geliştireceğimiz plugin”Ö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.
SA-MP plugin öğrenme yolu
Bölüm başlığı “SA-MP plugin öğrenme yolu”- Geliştirme ortamını ve CMake projesini hazırla.
- İlk C++ pluginini derle ve sunucuya yükle.
- Pawn tarafından çağrılan native fonksiyonlar yaz.
- String, Float, referans ve dizileri AMX belleğinden güvenle oku.
- Pluginden Pawn public callback’i çağır.
- ProcessTick ve worker thread sınırını doğru kur.
- sampgdk ile SA-MP fonksiyonlarını C++ tarafından kullan.
- 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.
Sık sorulan sorular
Bölüm başlığı “Sık sorulan sorular”SA-MP plugini hangi dille yazılır?
Bölüm başlığı “SA-MP plugini hangi dille yazılır?”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.
Pawn bilmeden plugin yazılır mı?
Bölüm başlığı “Pawn bilmeden plugin yazılır mı?”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.
Plugin ile gamemode arasındaki fark nedir?
Bölüm başlığı “Plugin ile gamemode arasındaki fark nedir?”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.