21-11-2026, 15:38
ReAPI ile oyuncuların hasar almasını yönetmek (TakeDamage kancası)#1
Kısa özet: ReAPI ile oyuncu hasarını ReGameDLL uyumlu biçimde yönetebilirsiniz. RegisterHookChain(RG_CBasePlayer_TakeDamage, "hasar_once") ile kanca tanımlanır; kanca içinde saldıran ve kurban kontrol edilir, SetHookChainArg ile hasar değeri değiştirilebilir. Hasarı tamamen engellemek için SetHookChainReturn(ATYPE_INTEGER, 0) ve HC_SUPERCEDE kullanılır. Botlarda da sorunsuz çalışır; argüman sırası ReAPI sürümüne göre değişebileceğinden include dosyasındaki tanımı kontrol edin.
ReAPI ile hasar yönetimi
ReAPI, oyuncu hasarını ReGameDLL ile uyumlu biçimde yönetmenizi sağlar. TakeDamage kancası, hasarı değiştirmek ya da engellemek için en yaygın yoldur.
Kanca
KOD
RegisterHookChain(RG_CBasePlayer_TakeDamage, "hasar_once");
public hasar_once(kurban, inflictor, saldiran, Float:hasar, tur) {
if (!is_user_connected(saldiran) || saldiran == kurban) return HC_CONTINUE;
if (get_user_flags(saldiran) & ADMIN_LEVEL_H) {
SetHookChainArg(4, ATYPE_FLOAT, hasar * 1.1);
}
return HC_CONTINUE;
}Kodun mantığı
- RegisterHookChain ile TakeDamage çağrısı hasar_once fonksiyonuna bağlanır.
- Saldıran bağlı değilse ya da kurbanla aynıysa hasara dokunulmaz.
- Yetki bayrağına sahip saldıranın hasarı SetHookChainArg ile yüzde on artırılır.
- HC_CONTINUE zincirin normal devam etmesini sağlar.
Hasarı engellemek
KOD
SetHookChainReturn(ATYPE_INTEGER, 0);
return HC_SUPERCEDE;Bu iki satır hasarı tamamen engeller. Örneğin takım arkadaşına zararı kapatmak ya da koruma süresi tanımak için kullanılabilir.
Avantajları
- Botlarda da sorunsuz çalışır (CZ bot sorunu yaşanmaz).
- ReGameDLL'in hasar mantığıyla uyumludur.
Dikkat
Argüman sırası ReAPI sürümüne göre değişebilir; include dosyasındaki tanımı kontrol edin. Eklentiyi önce test sunucusunda deneyin; hasar kancası çok sık çalışan bir noktadır ve yavaş kod sunucuyu yorabilir.
Sık yapılan hatalar
- Argüman sırasını kontrol etmemek.
- Kanca içinde ağır işlemler yapmak.
- Kendine verilen hasarı hesaba katmamak.
- HC_SUPERCEDE kullanımının sonuçlarını bilmemek.
- Test etmeden canlıya almak.
Sık sorulan sorular
Hasarı nasıl değiştiririm? SetHookChainArg ile hasar argümanını değiştirerek.
Hasarı nasıl engellerim? SetHookChainReturn(ATYPE_INTEGER, 0) ve HC_SUPERCEDE.
Botlarla çalışır mı? Evet; CZ bot sorunu yaşanmaz.
Örnek senaryo
Bir sunucu sahibi takım arkadaşına hasarı spawn koruma süresince kapatmak istedi. TakeDamage kancasında koruma süresini kontrol edip hasarı engelleyince sorun çözüldü.
Kontrol listesi
- Kanca doğru tanımlı mı?
- Argüman sırası kontrol edildi mi?
- Kod hafif mi?
- Test edildi mi?
- Bayraklar doğru mu?
Ek ipucu
ReAPI include dosyasını sürüm güncellemelerinde yeniden okuyun; bir kancanın argüman düzeni ya da dönüş tipi değiştiğinde eski eklenti sessizce yanlış çalışabilir. Değişiklikleri önce test ortamında deneyin, çalışan son hâli yedekte tutun ve oyuncu geri bildirimlerini düzenli toplayın; ayarlarınızı gerçek ihtiyaca göre şekillendirmenin en güvenilir yolu budur.
Takıldığınız bir yer olursa bu konunun altına yazın; ekip ve topluluk yardımcı olur.
Ek ipuçları
Hasar kancasını yazarken önce hangi durumda tetiklendiğini konsola yazdırarak (test sunucusunda) doğrulayın; kancanın hangi hasar türlerinde çağrıldığını bilmek, beklenmeyen davranışları önler. Kodunuzu mümkün olduğunca kısa tutun ve gereksiz döngü ya da dosya işlemi koymayın; çünkü bu kanca her darbede çalışır ve yoğun maçlarda saniyede çok kez tetiklenir.