İçeriğe geç

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.

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.

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.

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.

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.

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.

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.

  • Yerel ve global kapsamı ayırt edebiliyorsun.
  • Oyuncu verisini neden playerid indeksli dizide tuttuğunu açıklayabiliyorsun.
  • String buffer boyutunu sizeof ile 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.