Metin2 item Tablosu: window, pos, socket ve attr Sütunları

player.item tablosu sunucudaki her eşyanın satırıdır: kime ait olduğu (owner_id), hangi pencerede ve kaçıncı kutuda durduğu (window, pos), adedi (count), ne olduğu (vnum), takılı taşlar ya da süre gibi ek değerleri (socket0-socket2) ve efsunları (attrtype, attrvalue çiftleri). db çekirdeği karakterin envanter, ekipman, simya ve kemer eşyalarını girişte bir kez okuyup önbellekte tutar; depo ve Nesne Marketi Deposu eşyaları ise depo açıldığında hesap numarasıyla okunur.

Pencere ve yuva numaraları derlemeye bağlıdır. Aşağıda orijinal yapının değerleriyle birlikte envanteri dört sayfaya çıkaran, kostüm ve kuşak yuvaları eklenmiş yaygın topluluk derlemesinin değerleri verildi; kendi derlemen için common/length.h dosyasına bakmak gerekir. Tablonun yeri ve diğer tablolar Metin2 veritabanları yazısında.

item tablosunun sütunları

window: eşya hangi pencerede?

db window sütununu okurken ve yazarken ENUM'un sıra numarasını kullanır; bu numara oyunun kendi pencere numaralarıyla birebir aynıdır. ENUM'a yeni bir pencere eklenecekse sona eklenmeli, araya değer sokulmamalıdır; yoksa bütün eşyalar başka bir pencereye kayar. GROUND sonradan bir güncellemeyle eklenir: yere atılan eşyanın satırı kayıtta silinir, biri eşyayı alınca aynı kimlikle yeni sahibinin adına yeniden yazılır.

pos: envanter kutuları nasıl numaralanır?

Bir envanter sayfası 5 sütun ve 9 satır, yani 45 kutudur. Kutular soldan sağa, yukarıdan aşağı numaralanır.

Orijinal yapıda envanter 2 sayfadır, pos 0-89 arasıdır. Envanteri 4 sayfaya çıkaran derlemelerde (ENABLE_EXTEND_INVEN_SYSTEM) pos 0-179 arasıdır; istemcinin de 4 sayfayı desteklemesi gerekir.

Büyük eşyalar alt alta birden çok kutu kaplar. item_proto'daki boyutu 2 olan bir Kılıç pos ve pos + 5 kutularını, boyutu 3 olan bir eşya ayrıca pos + 10'u kullanır. SQL ile satır eklerken bu kutuların boş olması ve eşyanın sayfanın altından taşmaması gerekir; oyun yüklerken yalnız başlangıç kutusunun dolu olup olmadığına bakar. Boyutun ve diğer eşya alanlarının anlamı item_proto yazısında.

EQUIPMENT: ekipman yuvaları

Giyilen eşyalarda pos yuva numarasıdır. Oyun içinde bu yuvalar envanterin son kutusundan sonra gelir, ama db'ye yuva numarası olarak yazılır:

21, 22 ve 24 numaralı yuvalar ilgili özellik kapalıysa yoktur ve sonraki numaralar kayar; bu yüzden numarayı kendi derlemendeki EWearPositions sırasından doğrula. Takılı simya taşları da ekipman penceresinde, son yuvadan sonraki numaralarda durur.

Ekipmandaki eşya girişte karaktere giydirilir. Karakterin seviyesi eşyanın şartını tutmuyorsa ya da yuva doluysa eşya envanterin ilk boş kutusuna konur. Envanter de doluysa karakterin yanına yere düşer: 3 dakika yalnız o karakter alabilir, 5 dakika sonra yok olur.

Kemer, simya, depo ve Nesne Marketi Deposu

• BELT_INVENTORY: kemer envanteri 4 × 4 = 16 kutudur, pos 0-15; kaç kutunun açık olduğunu kemerin seviyesi belirler (kemer ve envanter). Eski kurulumlarda bu eşyalar envanter penceresinde, ekipman yuvalarından sonraki numaralarda tutulur; yaygın paketlerin sql/updates/post klasöründeki dosyalar onları kemer penceresine taşır.
• DRAGON_SOUL_INVENTORY: simya taşlarının envanteri.
• SAFEBOX: owner_id hesap numarasıdır; aynı hesabın bütün karakterleri aynı depoyu görür. Depo sayfası da 5 × 9 = 45 kutudur, sayfa sayısını safebox.size belirler. Hesabın safebox_expire süresi devam ediyorsa ya da karakter büyük depo eşyasını takıyorsa depo 3 sayfa açılır. Geçersiz konumdaki ya da başka eşyayla çakışan depo eşyası gösterilmez ama satırı silinmez. Oyuncu tarafı depo yazısında.
• MALL: Nesne Marketi Deposu. owner_id hesap numarasıdır; oyunda 3 sayfa (135 kutu) açılır, ama db item_award eşyalarını yalnız ilk sayfanın 45 kutusuna yerleştirir.

Taş yuvaları: socket0, socket1, socket2

Silah ve zırhta üç soket taş yuvasıdır:

Yeni yaratılan bir eşyanın kaç açık yuvayla geleceğini item_proto belirler, ama SQL ile yazılan yuva sayısını oyun yüklerken denetlemez. Taş takmanın kuralları taş takma yazısında.

Bazı eşyalarda aynı sütunlar taş yerine başka bir değer tutar:

socket3, socket4 ve socket5 şemada bulunur ama db onları ne okur ne yazar. Eşyayı her kaydedişte satırı REPLACE ile baştan yazdığı için bu sütunlara elle konan değer ilk kayıtta sıfırlanır.

Efsunlar: attrtype ve attrvalue

Yedi efsun çifti vardır. İlk beşi (attrtype0-attrtype4) normal efsunlar, son ikisi (attrtype5, attrtype6) 6. ve 7. efsun yuvalarıdır. attrtype efsunun türünü APPLY numarasıyla, attrvalue değerini tutar; boş bir çift 0, 0'dır.

Bütün numaralar efsun listesi sayfasında. Değerler oyunun efsun tablosundaki beş seviyeden gelir; varsayılan tabloda silahtaki yarı insan efsunu en çok %10'dur. Oyun yüklerken değeri denetlemez, bu yüzden tablonun dışında bir değer yazmak mümkündür ama ekonominin dengesini bozar. attrtype işaretli tinyint olduğundan en büyük efsun numarası 127'dir.

Örnek satır

Envanterin ilk kutusunda, bir açık gümüş yuvalı ve iki efsunlu bir Kılıç+9:

Kılıç'ın boyutu 2 olduğu için 0 ve 5 numaralı kutular boş olmalıdır. Bu satırı ekleyen sorgu ve öncesinde yapılacaklar MySQL ile sık yapılan işlemler yazısında.

Eşya verirken sık yapılan hatalar

1. Sunucu açıkken item tablosuna satır eklemek. Oyundaki karakter yeni satırı görmez; eşya ancak karakter çıkıp önbellek boşaldıktan sonraki girişte gelir ve kutu o arada dolmuşsa başka yere taşınır. Daha sinsi sorun kimliktir. Her oyun çekirdeği açılışta db'den 10 milyonluk bir kimlik bloğu alır ve yeni eşyalara oradan sırayla numara verir; db bu blokları açılışta tablodaki en büyük kimliğe bakarak kurar. Sunucu açıkken otomatik numarayla eklenen satır, bir çekirdeğin birazdan kendi eşyasına vereceği kimliği alabilir; o eşya kaydedildiğinde REPLACE senin satırını ezer. Sunucu açıkken eşya item_award ile, doğrudan item tablosuna ise sunucu kapalıyken verilir.
2. Depo eşyasına karakter numarası yazmak. SAFEBOX ve MALL'da owner_id hesap numarasıdır.
3. Dolu kutuya eşya koymak. Başlangıç kutusu doluysa oyun eşyayı ilk boş kutuya taşır, envanter doluysa yere atar. Büyük eşyanın alt kutuları denetlenmediği için üst üste binen eşyalar envanteri bozar.
4. Süreli eşyada socket0'ı boş bırakmak. Gerçek zamanlı süreli bir eşyanın socket0'ı 0 ya da geçmiş bir zamansa eşya, oyuncu girer girmez REAL_TIME_EXPIRE kaydıyla silinir. socket0'a UNIX_TIMESTAMP() + süre yazılır; item_award bu alanı kendisi doldurur (süreli eşyalar).
5. Adet sınırını aşmak. Yığılmayan bir eşyada count her zaman 1 sayılır, yığılan eşyada en çok CONFIG'deki ITEM_COUNT_LIMIT kadardır (varsayılan 200).
6. Olmayan bir vnum yazmak. item_proto'da bulunmayan bir eşya oluşturulamaz; satır tabloda kalır ama oyunda görünmez, syserr'e "cannot create item by vnum" yazılır.
7. socket3-5'e değer yazmak. Kullanılmaz, ilk kayıtta sıfırlanır.
8. item_award'dan efsunlu eşya beklemek. item_award yalnız socket0-socket2 taşır; efsunlu eşya sunucu kapalıyken doğrudan item tablosuna eklenir.

İlgili kod yerleri

• db'nin okuması ve sütun sırası: db/src/ClientManagerPlayer.cpp, CreateItemTableFromRes ve karakter yükleme sorgusu.
• db'nin yazması: db/src/Cache.cpp, CItemCache::OnFlush (REPLACE ve socket0-socket2).
• Oyunun kaydettiği konum: game/src/item_manager.cpp, SaveSingleItem (ekipmanda yuva numarası, kemerde 0-15, depoda hesap numarası).
• Girişte yerleştirme: game/src/input_db.cpp, CInputDB::ItemLoad.
• Kimlik blokları: db/src/ItemIDRangeManager.cpp.