İçeriğe geç

SA-MP Plugin Geliştirme Ortamı Nasıl Kurulur?

Bu adımda starter adlı plugin için tekrar üretilebilir bir CMake projesi kuracağız. Amaç IDE’ye özel ayar ezberlemek değil; aynı kaynak koddan Windows için starter.dll, Linux için starter.so üretebilen temiz bir temel hazırlamak.

  • C++ masaüstü geliştirme bileşenleri kurulmuş Visual Studio,
  • CMake 3.20 veya üzeri,
  • klasik SA-MP ile uyumlu plugin SDK,
  • test için ayrı bir SA-MP sunucu klasörü.

Visual Studio kurulumunda MSVC, Windows SDK ve CMake tools for Windows bileşenlerini seç. Klasik Windows sunucusu için proje üretirken Win32 hedefini kullanacağız.

  • C++17 destekleyen GCC veya Clang,
  • CMake 3.20 veya üzeri,
  • 32 bit çıktı üretmek için multilib geliştirme paketleri,
  • klasik SA-MP ile uyumlu plugin SDK.

Dağıtım yapacağın Linux sürümüne yakın bir ortamda Release derlemesi almak, çalışma zamanı kütüphanesi uyuşmazlıklarını azaltır.

SDK’nin bu rehberde kullandığımız iki ana başlığı vardır:

  • SDK/amx/amx.h: AMX, cell ve AMX API fonksiyonlarını tanımlar.
  • SDK/plugincommon.h: plugin export makrolarını, destek bayraklarını ve sunucunun verdiği fonksiyon tablosunu tanımlar.

SDK klasörünün içeriğini rastgele eksiltme. Farklı paketlerde ek başlıklar bulunabilir; kendi paketinin dizin yapısını koru. Rehberdeki include yolları şu proje ağacını varsayar:

starter-plugin/
├── CMakeLists.txt
├── starter.def
├── SDK/
│ ├── plugincommon.h
│ └── amx/
│ ├── amx.h
│ └── ...
├── pawn/
│ └── include/
│ └── starter.inc
└── src/
└── main.cpp

build/ klasörü kaynak ağacına eklenmeyecek; CMake tarafından daha sonra oluşturulacak.

Kök dizindeki CMakeLists.txt dosyasına şunu ekle:

CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(starter VERSION 1.0.0 LANGUAGES CXX)
add_library(starter SHARED
src/main.cpp
)
target_include_directories(starter PRIVATE
"${CMAKE_CURRENT_SOURCE_DIR}"
)
target_compile_features(starter PRIVATE cxx_std_17)
set_target_properties(starter PROPERTIES
PREFIX ""
OUTPUT_NAME "starter"
)
if(WIN32)
target_sources(starter PRIVATE starter.def)
if(MSVC)
target_compile_options(starter PRIVATE /W4 /EHsc)
endif()
else()
target_compile_options(starter PRIVATE
-m32
-Wall
-Wextra
-Wpedantic
)
target_link_options(starter PRIVATE -m32)
endif()

Buradaki üç karar önemlidir:

  • SHARED, çalıştırılabilir dosya değil dinamik kütüphane üretir.
  • PREFIX "", Linux’ta varsayılan libstarter.so yerine starter.so adını kullanır.
  • uyarı seviyeleri, bellek ve tür hatalarını daha sunucuya yüklemeden yakalamaya yardım eder.

starter.def, sunucunun DLL içinde bulacağı giriş noktalarını listeler:

starter.def
EXPORTS
Supports
Load
Unload
AmxLoad
AmxUnload

İleride ProcessTick veya sampgdk callback’i eklediğimizde bu listeyi de güncelleyeceğiz. Kaynak kodda fonksiyonun bulunması tek başına yeterli değildir; Windows DLL export tablosunda görünmesi gerekir.

  • src/: yalnızca C++ uygulama kodu,
  • SDK/: SA-MP ile konuşmak için gereken uyumluluk katmanı,
  • pawn/include/: gamemode geliştiricisinin kullanacağı public Pawn API,
  • build/: geçici derleme dosyaları ve çıktı.

Bu ayrım, daha sonra SDK’yı veya derleme sistemini değiştirirken Pawn API sözleşmesini bozmadan ilerlemeni sağlar.

Şu aşamada aşağıdakiler hazır olmalı:

  • C++ derleyicisi ve CMake terminalden çalışıyor,
  • SDK başlıkları proje içinde doğru konumda,
  • Windows hedefi Win32, Linux hedefi 32 bit olarak planlandı,
  • .def dosyasında beş temel giriş noktası bulunuyor.

Henüz configure veya build çalıştırma; src/main.cpp dosyasını bir sonraki adımda eksiksiz oluşturacağız.

Sıradaki adım: İlk SA-MP C++ pluginini yaz ve yükle.