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.
Profil akışı
Bölüm başlığı “Profil akışı”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ırHer 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.
1. Oyuncu veri modelini genişlet
Bölüm başlığı “1. Oyuncu veri modelini genişlet”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.
2. Bağlantıda profil sorgusunu başlat
Bölüm başlığı “2. Bağlantıda profil sorgusunu başlat”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.
3. Mevcut profili yükle
Bölüm başlığı “3. Mevcut profili yükle”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.
4. Kayıt yoksa yeni profil oluştur
Bölüm başlığı “4. Kayıt yoksa yeni profil oluştur”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.
5. Profili oyuna uygula
Bölüm başlığı “5. Profili oyuna uygula”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.
6. Görev ödülünü bellekte güncelle
Bölüm başlığı “6. Görev ödülünü bellekte güncelle”Ö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.
7. Profili kaydet
Bölüm başlığı “7. Profili kaydet”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.
8. Ayrılma ve kapanış sırasını kur
Bölüm başlığı “8. Ayrılma ve kapanış sırasını kur”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.
Session kontrolü hangi hatayı önlüyor?
Bölüm başlığı “Session kontrolü hangi hatayı önlüyor?”Örnek olay:
playerid 7 → Alice bağlanır → SELECT başlarAlice ayrılırplayerid 7 → Bob bağlanır → yeni SELECT başlarAlice'in eski SELECT sonucu tamamlanırYalnı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.
Bu bir giriş sistemi mi?
Bölüm başlığı “Bu bir giriş sistemi mi?”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 pisti
Bölüm başlığı “Test pisti”| 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.