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.
Bağlantının yolculuğu
Bölüm başlığı “Bağlantının yolculuğu”SA-MP istemcisi ↓ IP:port üzerinden bağlanırSA-MP sunucusu (samp-server) ↓ gamemode'u yükleracademy.amx ↓ olayları callback olarak bildirirOnPlayerConnect → OnPlayerRequestClass → OnPlayerSpawnSen 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.
Projedeki parçalar
Bölüm başlığı “Projedeki parçalar”| 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 |
Fonksiyon ve callback farkı
Bölüm başlığı “Fonksiyon ve callback farkı”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.
Gamemode ile başla
Bölüm başlığı “Gamemode ile başla”İ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.
Mini görev
Bölüm başlığı “Mini görev”Aşağıdaki dosyalardan hangisinin düzenlendiğini, hangisinin sunucu tarafından çalıştırıldığını cevapla:
academy.pwnacademy.amxYanı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.
Görev tamamlandı mı?
Bölüm başlığı “Görev tamamlandı mı?”gamemodeilefilterscriptfarkını söyleyebiliyorsun.- Fonksiyon ile callback’i “kim çağırır?” sorusuyla ayırabiliyorsun.
.pwn → compiler → .amx → SA-MP serverzincirini açıklayabiliyorsun.
Sıradaki görev: yerel SA-MP sunucusunu kur.