İçeriğe geç

sampgdk ile SA-MP Fonksiyonları ve Callback’ler

Temel plugin SDK’si kendi Pawn native fonksiyonlarını kaydetmek ve AMX ile konuşmak için yeterlidir. C++ içinden SendClientMessage, GetPlayerPos gibi SA-MP fonksiyonlarını çağırmak veya OnPlayerConnect gibi olayları doğrudan karşılamak istediğinde sampgdk ek bir köprü sağlar.

sampgdk zorunlu değildir. Plugin yalnızca Pawn’a native sunuyorsa önceki bölümlerdeki daha küçük yapıyı korumak daha kolaydır.

Şu ihtiyaçlardan biri varsa değerlendirebilirsin:

  • pluginin kendi zamanlamasıyla oyuncuya mesaj göndermesi,
  • C++ tarafında SA-MP oyuncu veya araç verisi okuması,
  • bir SA-MP callback’ini Pawn’a uğramadan C++ içinde işlemesi,
  • C++ ağırlıklı bir sunucu modülü geliştirilmesi.

Bir native çağrısının sonucu Pawn’a dönüp SA-MP fonksiyonunu Pawn’ın çağırması yeterliyse sampgdk eklemek zorunda değilsin. Daha az bağımlılık, daha kolay derleme ve dağıtım demektir.

Kullandığın sampgdk paketindeki include ve library dosyaları aynı sürüme ve sunucu mimarisine ait olmalıdır. Örnek dizilim:

starter-plugin/
└── vendor/
└── sampgdk/
├── include/
│ └── sampgdk/
│ └── sampgdk.h
└── lib/
├── sampgdk.lib
└── libsampgdk.a

Paketindeki kütüphane adı farklıysa CMake yolunu gerçek dosya adına göre değiştir. Özellikle 32 bit plugin için 32 bit sampgdk binary’si kullan.

Mevcut CMakeLists.txt içine include yolu ve işletim sistemine uygun library ekle:

target_include_directories(starter PRIVATE
"${CMAKE_CURRENT_SOURCE_DIR}/vendor/sampgdk/include"
)
if(WIN32)
target_link_libraries(starter PRIVATE
"${CMAKE_CURRENT_SOURCE_DIR}/vendor/sampgdk/lib/sampgdk.lib"
)
else()
target_link_libraries(starter PRIVATE
"${CMAKE_CURRENT_SOURCE_DIR}/vendor/sampgdk/lib/libsampgdk.a"
)
endif()

Header bulunamıyorsa include yolu, unresolved external symbol veya undefined reference alıyorsan library yolu ya da mimarisi yanlıştır. Header’ın bulunması linker’ın hazır olduğu anlamına gelmez.

Kaynak dosyasına amalgamated header’ı ekle:

#include <sampgdk/sampgdk.h>

Ardından temel giriş noktalarını güncelle:

PLUGIN_EXPORT unsigned int PLUGIN_CALL Supports()
{
return sampgdk::Supports() |
SUPPORTS_VERSION |
SUPPORTS_AMX_NATIVES |
SUPPORTS_PROCESS_TICK;
}
PLUGIN_EXPORT bool PLUGIN_CALL Load(void** data)
{
pAMXFunctions = data[PLUGIN_DATA_AMX_EXPORTS];
if (!sampgdk::Load(data))
{
return false;
}
sampgdk::logprintf("[starter] Plugin loaded with sampgdk");
return true;
}
PLUGIN_EXPORT void PLUGIN_CALL Unload()
{
sampgdk::logprintf("[starter] Plugin unloaded");
sampgdk::Unload();
}
PLUGIN_EXPORT void PLUGIN_CALL ProcessTick()
{
sampgdk::ProcessTick();
DrainMainThreadTasks();
}

Load içinde kendi başlangıç işlemlerini sampgdk başarıyla yüklendikten sonra yap. Kısmi yükleme başarısız olursa başlatılmış kaynakları temizleyip false döndür.

sampgdk fonksiyonlarını namespace ile açıkça çağır:

void SendPluginReadyMessage(int playerId)
{
sampgdk::SendClientMessage(
playerId,
0xFFFFFFFF,
"Starter plugin is ready."
);
}

using namespace sampgdk; kullanma. Plugin SDK ve standart kütüphane ile benzer isimler bulunduğunda hangi fonksiyonun çağrıldığı belirsizleşebilir. sampgdk:: prefix’i kod incelemesinde çağrının sunucu API’sine gittiğini de açıkça gösterir.

Bu çağrıları yalnızca ana sunucu thread’inde yap. Worker thread sonucu önce ProcessTick kuyruğuna bırakmalıdır.

Örneğin oyuncu bağlandığında plugin mesajı gönder:

PLUGIN_EXPORT bool PLUGIN_CALL OnPlayerConnect(int playerId)
{
sampgdk::SendClientMessage(
playerId,
0xFFFFFFFF,
"C++ plugin initialized for your session."
);
return true;
}

Windows’ta callback adını .def dosyasına ekle:

starter.def
EXPORTS
Supports
Load
Unload
AmxLoad
AmxUnload
ProcessTick
OnPlayerConnect

Her yeni C++ callback’i export listesinde yer almalıdır. Aksi halde kod derlenir fakat sampgdk callback’i bulamaz.

Callback dönüşünü alışkanlıkla true yapma. Her SA-MP callback’inin dönüş davranışı aynı değildir; işlemeyi durdurma, devam ettirme veya sonucu geçersiz kılma anlamı callback’e göre değişebilir. Kullandığın callback’in dönüş sözleşmesini uygulamadan önce kontrol et.

Kendi Pawn native’lerin çalışmaya devam eder mi?

Bölüm başlığı “Kendi Pawn native’lerin çalışmaya devam eder mi?”

Evet. AmxLoad içinde aynı kayıt dizisini kullanmaya devam et:

PLUGIN_EXPORT int PLUGIN_CALL AmxLoad(AMX* amx)
{
return amx_Register(amx, pluginNatives, -1);
}
PLUGIN_EXPORT int PLUGIN_CALL AmxUnload(AMX*)
{
return AMX_ERR_NONE;
}

sampgdk, kendi native API’ni ortadan kaldırmaz. SA-MP fonksiyonlarını çağırma ve callback yakalama katmanı ekler.

target_include_directories yolu, içinde sampgdk/ klasörü bulunan dizini göstermelidir.

Library target’a bağlanmamıştır, yanlış dosya seçilmiştir veya library ile plugin farklı mimaridedir. Önce gerçek dosya yolunu ve x86 hedefini doğrula.

  • sampgdk::Supports, Load ve ProcessTick bağlı mı?
  • callback PLUGIN_EXPORT ve PLUGIN_CALL ile tanımlı mı?
  • Windows .def listesinde callback adı var mı?
  • callback imzası beklenen parametrelerle birebir aynı mı?
  • sampgdk sürümü, header ve library dosyaları birbiriyle uyumlu.
  • CMake hem include hem linker ayarını içeriyor.
  • sampgdk yaşam döngüsünün dört çağrısı bağlı.
  • C++ callback’leri Windows export listesinde.
  • SA-MP fonksiyonları yalnızca ana thread’den çağrılıyor.

Sıradaki adım: Plugini Release derle, dağıt ve yükleme hatalarını ayıkla.