Görev 5 — Oyuncu verisini modelle
Kazanacağın yetenek: Her oyuncu için skor ve görev durumunu doğru kapsamda, İngilizce adlandırılmış dizilerde saklamak.
Bu derste her oyuncu için puan ve aktif görev durumu saklayacaksın. Amaç yalnızca new yazmak değil; verinin kime ait olduğunu, ne kadar yaşayacağını ve ne zaman sıfırlanacağını doğru modellemektir.
Yerel ve global değişken
Bölüm başlığı “Yerel ve global değişken”Fonksiyon içinde tanımlanan yerel değişken yalnızca o çağrı sırasında kullanılabilir:
public OnPlayerConnect(playerid){ new welcomeMessage[64] = "Sunucuya hos geldin!"; SendClientMessage(playerid, 0xFFFFFFFF, welcomeMessage); return 1;}Fonksiyonların dışında tanımlanan global değişken ise gamemode çalıştığı sürece erişilebilir:
new totalConnections = 0;Geçici hesaplar için yerel, callback’ler arasında korunması gereken sunucu durumu için global veri kullan.
Neden oyuncu dizisi gerekiyor?
Bölüm başlığı “Neden oyuncu dizisi gerekiyor?”playerid, o bağlantı oturumu için oyuncunun sayısal yuvasıdır. Tek bir playerScore değişkeni tüm oyuncular tarafından paylaşılır. Her oyuncuya ayrı yuva vermek için dizi kullan:
new playerScore[MAX_PLAYERS];new bool:isPlayerOnMission[MAX_PLAYERS];Erişimde playerid dizinin indeksidir:
playerScore[playerid] = 250;isPlayerOnMission[playerid] = false;Diziler sıfır tabanlıdır. MAX_PLAYERS elemanlı dizinin geçerli indeksleri 0 ile MAX_PLAYERS - 1 arasındadır. Sabit bir dizi sınırının dışına erişmek güvenli değildir.
Tag ne işe yarar?
Bölüm başlığı “Tag ne işe yarar?”Pawn temel olarak hücrelerle çalışsa da tag, değerin niyetini belirtir:
new Float:distance = 12.5;new bool:isActive = true;Tag uyarısı genellikle iki farklı anlamdaki değeri karıştırdığını söyler. Uyarıyı kapatmak yerine çağırdığın SA-MP fonksiyonunun parametre türünü kontrol et.
İlişkili alanları enum ile adlandır
Bölüm başlığı “İlişkili alanları enum ile adlandır”Başlangıçta iki ayrı dizi okunabilir. Alan sayısı arttığında oyuncu verisini adlandırılmış indekslerle gruplayabilirsin:
enum E_PLAYER_DATA{ playerScore, bool:isPlayerOnMission}
new PlayerData[MAX_PLAYERS][E_PLAYER_DATA];Ardından:
PlayerData[playerid][playerScore] = 250;PlayerData[playerid][isPlayerOnMission] = false;Bu yapı bir veritabanı değildir. Sunucu kapanınca veya gamemode yeniden yüklenince değerler kaybolur. Kalıcılık ileride dosya ya da veritabanı katmanıyla eklenir.
String de bir dizidir
Bölüm başlığı “String de bir dizidir”Pawn’ta string, sonlandırıcı hücreyle biten bir karakter dizisidir. Hedef buffer’a yeterli alan ayır ve boyutu fonksiyona sizeof ile ver:
new playerName[MAX_PLAYER_NAME + 1];GetPlayerName(playerid, playerName, sizeof playerName);
new message[96];format( message, sizeof message, "%s sunucuya baglandi. Puan: %d", playerName, PlayerData[playerid][playerScore]);SendClientMessageToAll(0xFFFFFFFF, message);sizeof playerName, sabit bir sayı tekrar etmek yerine compiler’ın dizinin gerçek boyutunu kullanmasını sağlar.
Oturum verisini başlat ve temizle
Bölüm başlığı “Oturum verisini başlat ve temizle”Aynı playerid, oyuncu ayrıldıktan sonra başka bir bağlantıya verilebilir. Bu yüzden oturum verisini bağlanırken açıkça başlat:
public OnPlayerConnect(playerid){ PlayerData[playerid][playerScore] = 0; PlayerData[playerid][isPlayerOnMission] = false; return 1;}
public OnPlayerDisconnect(playerid, reason){ PlayerData[playerid][playerScore] = 0; PlayerData[playerid][isPlayerOnMission] = false; return 1;}Bu, kalıcı veriyi silme stratejisi değildir. Kalıcı sistemde önce veriyi kaydeder, ardından bellek yuvasını temizlersin.
Kontrol noktası
Bölüm başlığı “Kontrol noktası”- Yerel ve global kapsamı ayırt edebiliyorsun.
- Oyuncu verisini neden
playeridindeksli dizide tuttuğunu açıklayabiliyorsun. - String buffer boyutunu
sizeofile geçiriyorsun. - Yeniden kullanılan oyuncu yuvasına eski oturum verisinin sızmasını önlüyorsun.
Sonraki adım: koşullar ve döngüler.