Görev 4 — Pawn ehliyetini al
Kazanacağın yetenek: Pawn ifadelerini okuyup İngilizce ve aranabilir kod kimlikleriyle küçük hesaplamalar yazmak.
Ön koşul: ilk gamemode’u derleyip çalıştırmış olmalısın. Bu görevde yeni oyun özelliği eklemek yerine, yazdığın kodun dil düzeyinde nasıl okunduğunu öğreneceksin.
Pawn programı nasıl oluşur?
Bölüm başlığı “Pawn programı nasıl oluşur?”Pawn programı temelde iki parçadan oluşur:
- Değişkenler, çalışma sırasında veriyi tutar.
- Fonksiyonlar, bu veriler üzerinde işlem yapan ifadeleri içerir.
Pawn, C benzeri söz dizimine sahip küçük bir gömülü script dilidir. Bu projede Pawn programının çalıştığı host uygulama SA-MP sunucusudur; SendClientMessage gibi native fonksiyonları dilin kendisi değil, a_samp API’si sağlar.
İfade, blok ve girinti
Bölüm başlığı “İfade, blok ve girinti”Bir işlem satırını ; ile bitir; birden fazla ifadeyi {} içinde grupla:
new reward = 250;
if (reward > 0){ printf("Reward: %d", reward);}Pawn bazı noktalı virgül ve parantezleri isteğe bağlı kabul etse de bu seride tutarlı C biçimini kullanacağız. Bu biçim, özellikle iç içe koşullarda hangi satırın hangi bloğa ait olduğunu açık tutar.
Büyük-küçük harf önemlidir
Bölüm başlığı “Büyük-küçük harf önemlidir”Pawn büyük-küçük harfe duyarlıdır. SendClientMessage, sendclientmessage ile aynı isim değildir. API fonksiyonlarını referanstaki yazımıyla kullan.
Kendi isimlerinde anlamı gösteren tutarlı bir biçim seç:
new playerScore = 0;new bool:isPlayerReady = false;Değerler ve temel işlemler
Bölüm başlığı “Değerler ve temel işlemler”Pawn’ta temel depolama birimi cell’dir; klasik ortamda 32 bitlik bir değerdir. Tam sayılar doğrudan saklanır. Float: ve bool: gibi tag’ler aynı hücrenin nasıl yorumlanması gerektiğini derleyiciye anlatır.
new score = 10;new Float:health = 100.0;new bool:isMissionActive = false;
score += 5; // 15isMissionActive = (score >= 15); // trueSık kullanılan operatörler:
| Amaç | Operatör | Örnek |
|---|---|---|
| Atama | = |
score = 10 |
| Toplama/çıkarma | +, - |
score + 5 |
| Birleşik atama | +=, -= |
score += 5 |
| Karşılaştırma | ==, !=, <, >= |
score >= 10 |
| Mantıksal ve/veya | &&, || |
bagli && hazir |
| Mantıksal değil | ! |
!hazir |
Sabitler ve renkler
Bölüm başlığı “Sabitler ve renkler”Değişmeyecek, anlamlı değerleri adlandır:
#define COLOR_WHITE 0xFFFFFFFF#define START_REWARD 250
SendClientMessage(playerid, COLOR_WHITE, "Hazirsin!");#define, derleme öncesinde metinsel bir tanım oluşturur. Her değeri makroya çevirmek gerekmez; paylaşılan ve anlam taşıyan sabitlerde kullan.
Yorumlar
Bölüm başlığı “Yorumlar”Yorum, kodun ne yaptığını tekrar etmek yerine kararın nedenini açıklamalıdır:
// Prevent session data from leaking into a reused player slot.playerScore[playerid] = 0;
/* * Bu blok birden fazla satirlik aciklama icindir. */Küçük alıştırma
Bölüm başlığı “Küçük alıştırma”OnPlayerConnect içindeki renk değerini bir sabit olarak adlandır ve konsola başlangıç ödülünü yazdır:
#define COLOR_WHITE 0xFFFFFFFF#define START_REWARD 250
public OnPlayerConnect(playerid){ SendClientMessage(playerid, COLOR_WHITE, "GTAVerse test sunucusuna hos geldin!"); printf("Player %d start reward: %d", playerid, START_REWARD); return 1;}%d yer tutucuları sırasıyla sonraki tam sayı argümanlarıyla doldurulur. Bu çıktı, ileride hata ayıklarken hangi callback’in hangi değerle çalıştığını görmeni sağlar.
İsimlendirme garajı
Bölüm başlığı “İsimlendirme garajı”Kodda İngilizce adlar kullanırken şu düzeni izle:
| Öğe | Biçim | Örnek |
|---|---|---|
| Değişken | camelCase |
playerScore |
| Boolean | soru gibi | isMissionActive, hasAdminAccess |
| Fonksiyon | eylem + nesne | StartMission, ResetPlayerData |
| Sabit | UPPER_SNAKE_CASE |
MISSION_REWARD |
| Enum | açıklayıcı alanlar | E_PLAYER_DATA, playerKills |
Kısaltma yığını (pS, gmSt) yerine aramada bulunabilen adlar seç. API’nin zorunlu parametre adları olan playerid, vehicleid ve objectid SA-MP geleneğine uygun biçimde korunur.
Pit stop
Bölüm başlığı “Pit stop”Bir kod satırında değişkeni, değeri, operatörü, fonksiyon çağrısını ve fonksiyon argümanlarını ayırt edebiliyorsan devam et.
Sonraki adım: değişkenler, diziler ve oyuncu verisi.