İçeriğe geç

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ı 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.

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.

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;

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; // 15
isMissionActive = (score >= 15); // true

Sı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

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.

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.
*/

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.

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.

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.