İçeriğe geç

Görev 1 — SA-MP dünyasını tanı

Kazanacağın yetenek: Bir SA-MP projesindeki dosyaların görevini ve oyuncu bağlandığında kodun hangi yoldan çalıştığını açıklayabilmek.

SA-MP (San Andreas Multiplayer), GTA San Andreas üzerinde topluluk sunucuları çalıştıran çok oyunculu mod ekosistemidir. Oyuncu bilgisayarındaki istemci görüntüleme ve girişle ilgilenirken, oyun kurallarının otoritesi SA-MP sunucusundadır.

SA-MP istemcisi
↓ IP:port üzerinden bağlanır
SA-MP sunucusu (samp-server)
↓ gamemode'u yükler
academy.amx
↓ olayları callback olarak bildirir
OnPlayerConnect → OnPlayerRequestClass → OnPlayerSpawn

Sen sonsuz bir oyun döngüsü yazmazsın. Sunucu “oyuncu bağlandı”, “oyuncu doğdu” veya “checkpoint’e girdi” gibi bir olay olduğunda ilgili callback’i çağırır. Kodun da SA-MP fonksiyonlarını çağırarak mesaj, araç, para veya konum gibi sonuçlar üretir.

Parça Ne yapar? Örnek
Pawn kaynak dosyası Düzenlediğin insan tarafından okunabilir kod gamemodes/academy.pwn
Pawn compiler Kaynağı AMX bytecode’una derler pawno/pawncc.exe
AMX dosyası Sunucunun gerçekten yüklediği çıktı gamemodes/academy.amx
Gamemode Sunucunun ana oyun kuralları sınıf, spawn, görev, ekonomi
Filterscript Gamemode’a eklenen bağımsız yan script yönetim aracı veya etkinlik
Include API bildirimlerini compiler’a tanıtır #include <a_samp>
Plugin SA-MP sunucusuna yerel özellik ekler başlangıç rotasında gerekmiyor
public OnPlayerConnect(playerid) // SA-MP bunu çağırır: callback
{
SendClientMessage( // Sen bunu çağırırsın: function
playerid,
0xFFFFFFFF,
"Sunucuya hos geldin!"
);
return 1;
}

Bu ayrım bütün eğitim boyunca pusulan olacak. “Bu kodu kim çağırıyor?” sorusunun cevabı, akışı anlamanın en kısa yoludur.

İlk projede yalnızca bir gamemode kullanacağız. Filterscript ve plugin eklemek başlangıçta aynı callback’in birden fazla scriptte çalışması, yükleme sırası ve bağımlılık sürümleri gibi yeni sorunlar getirir. Çekirdek akışı öğrendikten sonra bu parçaları bilinçli ekleyebilirsin.

Aşağıdaki dosyalardan hangisinin düzenlendiğini, hangisinin sunucu tarafından çalıştırıldığını cevapla:

academy.pwn
academy.amx

Yanıt: .pwn düzenlenir ve compiler’a verilir; üretilen .amx sunucu tarafından yüklenir. .pwn değiştiğinde yeniden derleme yapılmazsa sunucu eski davranışı göstermeye devam eder.

  • gamemode ile filterscript farkını söyleyebiliyorsun.
  • Fonksiyon ile callback’i “kim çağırır?” sorusuyla ayırabiliyorsun.
  • .pwn → compiler → .amx → SA-MP server zincirini açıklayabiliyorsun.

Sıradaki görev: yerel SA-MP sunucusunu kur.