İçeriğe geç

Görev 14 — SA-MP hata ayıklama tamirhanesi

Kazanacağın yetenek: “Çalışmıyor” demek yerine sorunun aşamasını, beklenen davranışı ve kanıtını belirlemek.

Belirti Aşama İlk kontrol
.amx üretilmiyor Derleme Pawno compiler çıktısı
Run time error 19 Yükleme/bağımlılık plugin, native ve server_log.txt
Gamemode bulunamıyor Yapılandırma gamemode0 ve dosya adı
Callback çalışmıyor Olay akışı callback imzası ve debug kaydı
MySQL callback’i çalışmıyor Veritabanı OnQueryError, callback adı ve sorgu kuyruğu
Eski oyuncuya veri geliyor Asenkron akış player session değeri ve bağlantı kontrolü
Yanlış oyuncu değişiyor Veri modeli playerid indeksi
Özellik iki kez çalışıyor Script etkileşimi gamemode ve filterscript callback’leri

Bir eksik parantez aşağıdaki satırlarda onlarca ikincil hata oluşturabilir. En üstteki ilk gerçek hatayı düzelt, yeniden derle ve listeyi tekrar değerlendir.

  • undefined symbol: isim yanlış, bildirim görünür değil veya include eksik.
  • invalid expression: parantez, virgül ya da operatör eksik.
  • array index out of bounds: sabit indeks dizinin sınırını aşıyor.
  • tag mismatch: beklenen Float: veya başka tag ile verilen değer uyuşmuyor.
  • symbol is never used: yarım kalmış veya gereksiz tanım var.

Uyarıyı #pragma warning disable ile susturmak son çare bile değildir; önce uyarının hangi yanlış varsayımı gösterdiğini bul.

  1. academy.pwn dosyasını kaydet.
  2. F5 sonrası compiler’ın başarıyla tamamlandığını doğrula.
  3. academy.amx değiştirilme saatini kontrol et.
  4. server.cfg içinde gamemode0 academy 1 bulunduğunu doğrula.
  5. Sunucuyu yeniden başlat ve server_log.txt dosyasını incele.

Sürüm izi eklemek eski AMX şüphesini hızla çözer:

public OnGameModeInit()
{
print("DEBUG build: academy-004");
return 1;
}
public OnPlayerEnterCheckpoint(playerid)
{
printf(
"DEBUG checkpoint player=%d active=%d score=%d",
playerid,
PlayerData[playerid][isPlayerOnMission],
PlayerData[playerid][playerScore]
);
return 1;
}

Bu kayıt callback’in çağrılıp çağrılmadığını, doğru playerid değerini ve bellekteki durumu gösterir. Parola, token veya oyuncu parolası gibi gizli verileri loglama.

Sorunu küçültmek için:

  1. Tekrarlanabilir en kısa senaryoyu yaz.
  2. Son çalışan sürümle aradaki en küçük değişikliği bul.
  3. Büyük bloğu yarıya indirerek hatanın hangi tarafta kaldığını test et.
  4. Şüpheli davranışı küçük fonksiyona ayır.
  5. Her denemede yalnızca bir değişkeni değiştir.
SA-MP server sürümü:
Pawn compiler sürümü:
İşletim sistemi:
Kullanılan include/plugin sürümleri:
Beklenen davranış:
Gerçekleşen davranış:
Tam hata metni:
En küçük yeniden üretim kodu:
Denenmiş çözümler:

Ekran görüntüsü yerine hata metnini kod bloğunda paylaş. Böylece aranabilir, kopyalanabilir ve satır numarasıyla tartışılabilir olur.

Bu noktada kurulumu, derlemeyi, Pawn temelini, oyuncu verisini, fonksiyonları, callback akışını ve MySQL ile kalıcı veri yönetimini gördün. Bir sonraki mantıklı konular dialog, araç, pickup, timer ve modüler dosya yapısıdır. Bilmediğin bir API için önce ayrı fonksiyon veya callback referans sayfasını aç.