Metin2 Affect Sistemi: Etkiler, Süreler ve Yeni Etki Ekleme

Metin2'de iksir, beceri desteği, zehir, nesne marketi bonusu ya da quest ödülü olan her süreli etki, oyun çekirdeğinde bir affect kaydıdır. Kayıt altı alandan oluşur, karakterin etki listesinde durur, oyundaki karakter için her saniye bir azalır ve sıfıra inince puanı geri alınarak silinir. Etki eklendiği anda player veritabanındaki affect tablosuna yazılır, kalan süre oyundan çıkışta güncellenir.

Bu yazı etkinin kodda nasıl yaşadığını ve yeni bir etki eklerken nelere bakılacağını anlatır; dosya ve fonksiyon adları bu kaynağa göredir, yapı resmî koddan geldiği için sunucuların büyük çoğunluğunda aynıdır. İksirlerin oyuncu tarafı iksirler, zehir ve sersemletme durum etkileri yazısında.

Bir etki neyden oluşur?

game/src/affect.h içindeki CAffect sınıfının altı alanı, affect tablosunun sütunlarıyla bire birdir:

Etki eklenince ComputeAffect bayrağı açar ve PointChange(bApplyOn, lApplyValue) çağırır; silinince aynı değeri eksiyle geri alır. Bu yüzden etkinin puanı, PointChange switch'inde dalı olan bir POINT olmalıdır. Puan numarası ile efsun numarası arasındaki fark yeni efsun ekleme yazısında anlatılıyor.

Tür numaraları hangi aralıkta?

Kural iki makrodadır: IS_NO_CLEAR_ON_DEATH_AFFECT 500-599 arasını ve sohbet yasağını, IS_NO_SAVE_AFFECT savaş bayrağını, dirilme dokunulmazlığını, premium türleri ve binek bonusunu ayırır. Ölünce çalışan ClearAffect(true) ikisine de uyan etkileri yerinde bırakır, geri kalanını siler.

AFF bayrakları ne işe yarar?

dwFlag bir puan değil, karakterin üstündeki görsel ya da durum bitidir: sersemlemişken oynayamamak, görünmezlik, beceri ışıkları. Sunucu bitleri iki DWORD'lük TAffectFlag'te tutar, yani en çok 64 bayrak olur; bu kaynakta AFF_BITS_MAX 46'dır. İstemcideki CInstanceBase enum'u aynı sırayı bir eksiğiyle izler (sunucuda AFF_YMIR 1, istemcide AFFECT_YMIR 0) ve sınırı AFFECT_NUM = 64'tür. Adlar iki tarafta farklı olabilir; önemli olan sıradır. Yeni bayrak iki tarafta da listenin sonuna eklenir, görünecek efekt playersettingmodule.py'de chrmgr.RegisterEffect(chrmgr.EFFECT_AFFECT + sıra, ...) ile bağlanır.

Süre nasıl akar?

Karakterde en az bir etki varken affect_event her saniye UpdateAffect'i, o da ProcessAffect'i çağırır. Her etkinin lDuration'ı bir azalır, lSPCost varsa SP düşülür, süre bitince etki silinir. Olay yalnız oyundaki karakter için çalıştığı için etki süreleri oyundan çıkınca durur. Gerçek zamanlı süreler eşyanın soketinde tutulur; etki sisteminin işi değildir.

• Süresi 0 verilen etki, syserr'e Character::AddAffect lDuration == 0 yazılıp 1 saniyeye çevrilir.
• "Süresiz" etkiler büyük bir sayıyla eklenir. INFINITE_AFFECT_DURATION 60 yıllık saniyedir; bazı eşyalar Value3'e 536.870.911 yazar.
• Premium türlerde süre hesabın bitiş zamanından her saniye yeniden hesaplanır, saç etkisi hair.limit_time quest bayrağına bakar.

Kayıt: affect tablosu ve çökme

AddAffect etkiyi önce listeye koyar, sonra istemciye bildirir ve db'ye REPLACE INTO affect ... gönderir. Silinen etki DELETE ... WHERE dwPID AND bType AND bApplyOn ile tablodan kalkar. Kalan süreler ise yalnız CHARACTER::Disconnect içindeki SaveAffect'te, yani oyundan çıkışta ve ışınlanmada yazılır. Bunun iki sonucu var:

• Çekirdek çökerse tabloda etkinin eklendiği andaki tam süresi kalır; oyuncu girişte iksirini baştan alır. Bu kaynakta binek bonusu, çökmeden sonra hem tablodan yüklenip hem binekle yeniden eklenerek iki kat olmasın diye kaydedilmeyenler listesine alınmıştır.
• Tablonun birincil anahtarı dwPID, bType, bApplyOn, lApplyValue'dır. Bellekte aynı tür, puan ve değerden iki etki olabilir, ama tabloda tek satır kalır; bir sonraki girişte bonus yarıya iner. Silme ise değere bakmadan aynı tür ve puandaki bütün satırları siler.

Girişte LoadAffect önce listeyi temizler, satırları yükler ve puanları yeniden hesaplar. Bu kaynakta Muyeong etkisi yüklenmez, arena haritasında iyi etkiler silinir ve karakter ölü değilse HP ile SP en yüksek değere doldurulur. Etkiler yüklenene kadar eşya kullanılamaz, oyuncu "Affects are not loaded yet!" iletisini görür. Tablonun yeri veritabanları yazısında.

İksir etkisinin akışı

İksirler iki farklı alt türle etki verir ve Value sütunlarının sırası ikisinde farklıdır:

USE_ABILITY_UP türü kendisi seçer (saldırı hızı için 201) ve yalnız dokuz efsun türünü tanır; diğerlerinde eşya harcanır ama etki gelmez. USE_AFFECT ise türü proto'dan alır, efsun numarasını aApplyInfo ile puana çevirir ve aynı tür ile aynı puandan bir etki varsa "Bu etki zaten çalışıyor." der. Kritik İsabet ile Delici İsabet'in birlikte içilebilmesi bu yüzdendir: ikisi de 510 türündedir ama puanları farklıdır. Value1'e geçerli bir efsun numarası yazılmalıdır, kod bu değerin sınırını denetlemez.

Beceri etkisinin akışı

Destek becerisi kullanılınca etkinin türü becerinin numarasıdır; puan, değer formülü, süre formülü ve bayrak skill_proto'dan gelir, süreye gruptaki destekçinin bonusu eklenir. İkinci puanı olan beceriler aynı türle ikinci bir etki ekler. Sütunların ayrıntısı skill_proto yazısında.

Büyü Çözme gibi iyi etkileri silen beceriler RemoveGoodAffect'i çağırır. Bu fonksiyon sabit bir listeyi siler: hız ve güç iksirlerinin türleri, havai fişek ve oyuncu destek becerileri. Hedefte Büyü Çözme bayrağı varken IsGoodAffect listesindeki destekler yeniden atılamaz. Yeni bir destek etkisi bu iki listeye eklenmezse Büyü Çözme onu silmez.

Quest'ten verilen etkiler

Bütün quest'lerin affect.add etkileri aynı 1000 türünde durduğu için affect.remove(1000) hepsini birden siler. Bu nedenle quest'te süreli bonus verirken tekrar kullanımı bir bayrakla engellemek gerekir. Fonksiyonların genel kullanımı quest fonksiyonları yazısında.

Yeni etki eklerken dikkat edilecekler

1. Türü aralığına göre seç. Ölümde kalması gerekiyorsa 500-599 arasında boş bir numara al; kaydedilmemesi gerekiyorsa IS_NO_SAVE_AFFECT'e ekle. affect.h bu aralıkta 542'den sonrasını tanımlamaz, ama varsayılan item_proto bazı USE_AFFECT eşyalarında 570, 574, 583, 584, 587 ve 588'i kullanır; numara seçmeden önce bu eşyaların Value0 sütununa bak. Yeni türü enum'a adıyla yaz.
2. Üst üste binmeyi kendin engelle. AddAffect aynı türden etki bulunca bOverride true ise onu değiştirir, false ise yanına yenisini ekler. Eklemeden önce FindAffect(tür, puan) ile denetle.
3. Puanı doğrula. bApplyOn bir POINT'tir; PointChange'te dalı yoksa syserr'e unknown point change type düşer. Yalnız işaret olarak kullanılacak etkilerde POINT_NONE verilir; beceri kitabı beklemesiz etkisi (513) böyle çalışır ve kod yalnız FindAffect ile varlığına bakar.
4. Silinme listelerini güncelle. Büyü Çözme'nin silmesi isteniyorsa RemoveGoodAffect'e, kötü etkiyse RemoveBadAffect'e ekle. IsGoodAffect parametresini bir bayt olarak aldığı için 255'ten büyük türler bu listeye yazılamaz.
5. İstemciyi unutma. uiaffectshower.py 500'den küçük türleri yok sayar; 500 ve üstü için AFFECT_DATA_DICT'e tür numarasıyla, 510 türü için 1000 + puan anahtarıyla bir satır (açıklama ve simge yolu) gerekir. İstemcideki NEW_AFFECT_* sabitleri InstanceBase.h'de durur. Varsayılan sözlükte 510 türünden yalnız on bir puanın simgesi var; örneğin saldırı hızı veren nesne marketi iksirinin simgesi yoktur.
6. GM komutlarıyla dene. /affect_remove <karakter> hedefin etki listesini tür, puan, değer, süre ve bayrak sütunlarıyla yazar; /do_clear_affect GM'in kendi etkilerini ölümdeki gibi temizler. Komutların geri kalanı GM komutları rehberinde.