İçeriğe geç

Görev 12 — SA-MP Oyuncu Verisini MySQL ile Kaydet

Kazanacağın yetenek: Oyuncu bağlandığında profili yükleyen, kayıt yoksa oluşturan ve oturum verisini doğru oyuncuya uygulayan eksiksiz bir load/create/save akışı kurmak.

Bu görev, academy.pwn içindeki geçici skor ve görev verisini kalıcı hale getirir. Örneği parola tabanlı giriş sistemi olarak kullanmıyoruz; oyuncu adı yalnızca profil anahtarıdır ve gerçek kimlik doğrulaması sağlamaz.

OnPlayerConnect
→ player session numarası artırılır
→ bellek alanı temizlenir
→ SELECT kuyruğa alınır
├─ satır varsa → cache değerlerini PlayerData'ya kopyala
└─ satır yoksa → INSERT kuyruğa al → yeni ID'yi al
→ profil hazır işaretlenir
→ oyuncu spawn edilir
Görev tamamlanır / oyuncu ayrılır
→ bellekteki son değerlerle UPDATE kuyruğa alınır

Her asenkron callback, sorguyu başlatan bağlantı oturumunun hâlâ geçerli olduğunu kontrol edecek. Aynı playerid başka bir oyuncuya verilmişse eski sonuç yok sayılacak.

Mevcut E_PLAYER_DATA yapısını kalıcı alanlarla güncelle:

#define PROFILE_LOAD_TIMEOUT_MS (10000)
enum E_PLAYER_DATA
{
playerDatabaseId,
playerName[MAX_PLAYER_NAME + 1],
playerScore,
playerMoney,
playerMissionCount,
playerProfileLoadTimer,
bool:isPlayerOnMission,
bool:isPlayerDataLoaded
}
new PlayerData[MAX_PLAYERS][E_PLAYER_DATA];
new PlayerSession[MAX_PLAYERS];

PlayerSession ayrı dizide tutuluyor. PlayerData sıfırlanırken session değerinin yanlışlıkla sıfırlanmaması gerekir.

ResetPlayerData(playerid)
{
static const emptyPlayerData[E_PLAYER_DATA];
PlayerData[playerid] = emptyPlayerData;
return 1;
}
StopPlayerProfileLoadTimer(playerid)
{
if (PlayerData[playerid][playerProfileLoadTimer] != 0)
{
KillTimer(PlayerData[playerid][playerProfileLoadTimer]);
PlayerData[playerid][playerProfileLoadTimer] = 0;
}
return 1;
}

Zaman aşımı, SQL hatası nedeniyle normal sonuç callback’i hiç çalışmazsa oyuncunun yükleme ekranında sınırsız beklemesini engeller.

Oyuncuyu veri hazır olana kadar spectate modunda tut:

public OnPlayerConnect(playerid)
{
PlayerSession[playerid]++;
ResetPlayerData(playerid);
GetPlayerName(
playerid,
PlayerData[playerid][playerName],
MAX_PLAYER_NAME + 1
);
TogglePlayerSpectating(playerid, true);
SendClientMessage(playerid, 0xFFFFFFFF, "Profilin yukleniyor...");
PlayerData[playerid][playerProfileLoadTimer] = SetTimerEx(
"OnPlayerProfileLoadTimeout",
PROFILE_LOAD_TIMEOUT_MS,
false,
"dd",
playerid,
PlayerSession[playerid]
);
if (PlayerData[playerid][playerProfileLoadTimer] == 0)
{
SendClientMessage(playerid, 0xFF4444FF, "Profil zaman asimi baslatilamadi.");
Kick(playerid);
return 1;
}
new query[192];
mysql_format(
g_Database,
query,
sizeof query,
"SELECT `id`, `score`, `money`, `mission_count` FROM `players` WHERE `username` = '%e' LIMIT 1",
PlayerData[playerid][playerName]
);
if (!mysql_tquery(
g_Database,
query,
"OnPlayerProfileLoaded",
"dd",
playerid,
PlayerSession[playerid]
))
{
StopPlayerProfileLoadTimer(playerid);
SendClientMessage(playerid, 0xFF4444FF, "Profil sorgusu baslatilamadi.");
Kick(playerid);
}
return 1;
}

Callback formatındaki "dd", sırasıyla playerid ve session numarasını taşır. Oyuncu sorgu bitmeden ayrılırsa callback daha sonra gelebilir; yalnızca IsPlayerConnected kontrolü bunu yakalamaya yetmez çünkü aynı slot yeni oyuncuya verilmiş olabilir.

Sonuç zamanında gelmezse aynı session’a ait oyuncuyu kontrollü biçimde çıkar:

forward OnPlayerProfileLoadTimeout(playerid, session);
public OnPlayerProfileLoadTimeout(playerid, session)
{
if (!IsPlayerConnected(playerid) ||
session != PlayerSession[playerid])
{
return 1;
}
PlayerData[playerid][playerProfileLoadTimer] = 0;
if (!PlayerData[playerid][isPlayerDataLoaded])
{
SendClientMessage(playerid, 0xFF4444FF, "Profil yukleme zaman asimina ugradi.");
Kick(playerid);
}
return 1;
}

Bu timer veritabanı sorgusunu iptal etmez. Oyuncunun session değerini daha sonra değiştiren disconnect akışı, geç tamamlanan callback’in yeni oyuncuya uygulanmasını engeller.

forward OnPlayerProfileLoaded(playerid, session);
public OnPlayerProfileLoaded(playerid, session)
{
if (!IsPlayerConnected(playerid) ||
session != PlayerSession[playerid])
{
return 1;
}
new rowCount;
if (!cache_get_row_count(rowCount))
{
StopPlayerProfileLoadTimer(playerid);
SendClientMessage(playerid, 0xFF4444FF, "Profil sonucu okunamadi.");
Kick(playerid);
return 1;
}
if (rowCount == 0)
{
if (!CreatePlayerProfile(playerid, session))
{
StopPlayerProfileLoadTimer(playerid);
SendClientMessage(playerid, 0xFF4444FF, "Profil olusturma sorgusu baslatilamadi.");
Kick(playerid);
}
return 1;
}
if (!cache_get_value_name_int(
0,
"id",
PlayerData[playerid][playerDatabaseId]
) ||
!cache_get_value_name_int(
0,
"score",
PlayerData[playerid][playerScore]
) ||
!cache_get_value_name_int(
0,
"money",
PlayerData[playerid][playerMoney]
) ||
!cache_get_value_name_int(
0,
"mission_count",
PlayerData[playerid][playerMissionCount]
))
{
StopPlayerProfileLoadTimer(playerid);
SendClientMessage(playerid, 0xFF4444FF, "Profil verisi eksik.");
Kick(playerid);
return 1;
}
ActivatePlayerProfile(playerid);
return 1;
}

Cache içeriği callback bitmeden PlayerData dizisine kopyalanıyor. Böylece cache’i cache_save ile uzun süre bellekte tutmaya gerek kalmıyor.

CreatePlayerProfile(playerid, session)
{
new query[160];
mysql_format(
g_Database,
query,
sizeof query,
"INSERT INTO `players` (`username`) VALUES ('%e')",
PlayerData[playerid][playerName]
);
return mysql_tquery(
g_Database,
query,
"OnPlayerProfileCreated",
"dd",
playerid,
session
);
}
forward OnPlayerProfileCreated(playerid, session);
public OnPlayerProfileCreated(playerid, session)
{
if (!IsPlayerConnected(playerid) ||
session != PlayerSession[playerid])
{
return 1;
}
new databaseId = cache_insert_id();
if (databaseId <= 0)
{
StopPlayerProfileLoadTimer(playerid);
SendClientMessage(playerid, 0xFF4444FF, "Profil olusturulamadi.");
Kick(playerid);
return 1;
}
PlayerData[playerid][playerDatabaseId] = databaseId;
PlayerData[playerid][playerScore] = 0;
PlayerData[playerid][playerMoney] = 0;
PlayerData[playerid][playerMissionCount] = 0;
ActivatePlayerProfile(playerid);
return 1;
}

cache_insert_id yalnızca INSERT sonuç callback’i içindeyken okunur. players.username unique olduğu için aynı kullanıcı adına ait iki kayıt oluşamaz; eş zamanlı çakışma olursa OnQueryError üzerinden görünür hale gelir.

ActivatePlayerProfile(playerid)
{
StopPlayerProfileLoadTimer(playerid);
PlayerData[playerid][isPlayerDataLoaded] = true;
SetPlayerScore(playerid, PlayerData[playerid][playerScore]);
ResetPlayerMoney(playerid);
GivePlayerMoney(playerid, PlayerData[playerid][playerMoney]);
SetSpawnInfo(
playerid,
NO_TEAM,
0,
1958.3783,
1343.1572,
15.3746,
269.1425,
0, 0,
0, 0,
0, 0
);
TogglePlayerSpectating(playerid, false);
SpawnPlayer(playerid);
SendClientMessage(playerid, 0x33CC33FF, "Profilin hazir. /mission yazabilirsin.");
return 1;
}

isPlayerDataLoaded, oyun komutlarının sorgu tamamlanmadan boş veriyle çalışmasını engelleyecek.

if (!PlayerData[playerid][isPlayerDataLoaded])
{
SendClientMessage(playerid, 0xFFCC00FF, "Profilin henuz hazir degil.");
return 1;
}

Bu kontrolü /mission, /status ve kalıcı veriye dokunan diğer komutların başına koy.

Önceki bölümdeki GiveMissionReward fonksiyonunu para ve tamamlanan görev sayısını da takip edecek biçimde değiştir:

bool:GiveMissionReward(playerid, amount)
{
if (!IsPlayerConnected(playerid) ||
!PlayerData[playerid][isPlayerDataLoaded] ||
amount <= 0)
{
return false;
}
PlayerData[playerid][playerScore] += amount;
PlayerData[playerid][playerMoney] += amount;
PlayerData[playerid][playerMissionCount]++;
SetPlayerScore(playerid, PlayerData[playerid][playerScore]);
GivePlayerMoney(playerid, amount);
SavePlayerProfile(playerid);
return true;
}

Her checkpoint kontrolünde önce veritabanından skor okumuyoruz. Bellekteki değer tek gerçek oyun durumu; MySQL bunun kalıcı kopyasıdır.

SavePlayerProfile(playerid)
{
if (!PlayerData[playerid][isPlayerDataLoaded] ||
PlayerData[playerid][playerDatabaseId] <= 0)
{
return 0;
}
new query[224];
mysql_format(
g_Database,
query,
sizeof query,
"UPDATE `players` SET `score` = %d, `money` = %d, `mission_count` = %d WHERE `id` = %d LIMIT 1",
PlayerData[playerid][playerScore],
PlayerData[playerid][playerMoney],
PlayerData[playerid][playerMissionCount],
PlayerData[playerid][playerDatabaseId]
);
return mysql_tquery(g_Database, query);
}

Fonksiyonun 1 dönmesi UPDATE’in veritabanında tamamlandığını değil, kuyruğa alındığını gösterir. Kesin onay gereken bir işlemde sonuç callback’i ve cache_affected_rows kullan.

Oyuncu ayrılırken önce bellekteki son snapshot ile sorguyu oluştur, sonra session numarasını değiştir ve alanı temizle:

public OnPlayerDisconnect(playerid, reason)
{
#pragma unused reason
SavePlayerProfile(playerid);
StopPlayerProfileLoadTimer(playerid);
PlayerSession[playerid]++;
ResetPlayerData(playerid);
return 1;
}

Gamemode kapanışında bağlı profilleri kuyruğa al ve sonra bağlantıyı kapat:

public OnGameModeExit()
{
for (new playerid = 0; playerid < MAX_PLAYERS; playerid++)
{
if (IsPlayerConnected(playerid))
{
SavePlayerProfile(playerid);
}
}
if (g_Database != MYSQL_INVALID_HANDLE)
{
mysql_close(g_Database);
g_Database = MYSQL_INVALID_HANDLE;
}
return 1;
}

mysql_close kuyruktaki sorguların bitmesini beklediği için kapanış uzayabilir. Bu normaldir; yine de her oyuncu için çok sayıda gereksiz sorgu üretmemelisin.

Örnek olay:

playerid 7 → Alice bağlanır → SELECT başlar
Alice ayrılır
playerid 7 → Bob bağlanır → yeni SELECT başlar
Alice'in eski SELECT sonucu tamamlanır

Yalnızca IsPlayerConnected(7) kontrol edilirse Alice’in skoru Bob’a uygulanabilir. Callback’e gönderilen session değeri güncel PlayerSession[7] ile eşleşmediğinde eski sonuç sessizce yok sayılır. Yeni oyuncuyu kicklemek de yanlış olur; hata Bob’a ait değildir.

Hayır. SA-MP kullanıcı adı değiştirilebilir ve tek başına hesap sahipliğini kanıtlamaz. Buradaki amaç MySQL sorgu ve kalıcı profil akışını öğretmektir.

Gerçek kayıt/giriş sistemi eklerken:

  • parolayı hiçbir zaman düz metin saklama,
  • hızlı genel hash veya SQL içindeki MD5/SHA fonksiyonlarını kullanma,
  • parola için tasarlanmış güncel Argon2id veya bcrypt entegrasyonu kullan,
  • hash doğrulaması bitene kadar cache veya profil verisini oyuncuya uygulama,
  • login denemelerine süre ve adet sınırı koy.
Test Beklenen sonuç
İlk bağlantı players tablosunda tek profil oluşur
Aynı adla tekrar bağlantı Yeni INSERT yerine mevcut profil yüklenir
Görev tamamlama Skor, para ve görev sayısı bellekte artar
Ayrılıp geri gelme Son kaydedilen değerler geri yüklenir
Sorgu sırasında ayrılma Eski callback yeni oyuncuya veri uygulamaz
SELECT içinde geçici SQL hatası OnQueryError log yazar; yükleme zaman aşımı oyuncuyu bekletmez
MySQL kapalıyken açılış Sunucu boş profille devam etmez

Sıradaki görev: MySQL güvenliği ve sorgu hatalarını yönet.