Licori, pergamente de experiență, cufere, bilete de eveniment: toate sunt **consumabile**, iteme care dispar când le folosești și îți dau ceva în schimb. Regula de aur e simplă: **o bucată consumată = un efect**. Dacă itemul dispare fără efect, jucătorul pierde. Dacă efectul vine de două ori sau itemul nu dispare, ai o cale de abuz. În lecția asta vezi cum funcționează două tipuri de consumabile și cum le testezi metodic.
item_proto. Consumabilele „de quest” sunt tratate de un script when VNUM.use. În ambele cazuri testezi folosirea normală, dublu-click-ul rapid, inventarul plin și relogarea, numărând bucățile înainte și după.Cuvinte pe care le vei întâlni
| Cuvânt | Ce înseamnă |
|---|---|
| Consumabil | Item care dispare (total sau o bucată din teanc) când îl folosești. |
| Efect | Ce primești: HP, EXP, un buff, alte iteme. |
| when VNUM.use | Evenimentul de quest declanșat când jucătorul folosește itemul cu acel VNUM. |
| Atomic | „Totul sau nimic”: ori se consumă și primești efectul, ori nu se întâmplă nimic. |
Tipul 1: licorile, tratate direct de server
Am citit în sursa verificată ce se întâmplă când folosești o licoare (USE_POTION, în game/src/char_item.cpp):
- dacă VALUE1 nu e 0, reface MP; dacă VALUE0 nu e 0, reface HP;
- dacă HP-ul (sau MP-ul) e deja plin, licoarea nu se consumă și nu se întâmplă nimic;
- bonusul „efect licoare” poate mări efectul, cel mult de două ori;
- teancul scade cu exact 1.
Asta înseamnă că testul „la HP plin” e important: comportamentul corect e ca bucata să rămână în inventar.
Exemplu verificat: Licoarea roșie (S), VNUM 27001, are VALUE0 = 300, deci reface 300 HP.
Tipul 2: iteme folosite printr-un quest
Pentru efecte speciale (EXP, cufere cu logică proprie, teleportări), itemul e de tip ITEM_QUEST, iar efectul e scris într-un quest. În pachetul verificat, exemplul real e Tinctura numelui (VNUM 71055), folosită la schimbarea numelui: tip ITEM_QUEST, cu un quest when 71055.use.
Exemplul nostru: un „Pergament de EXP” de test, VNUM 95001. Rândul din item_proto.txt copiază un item de quest existent (tip ITEM_QUEST, subtip 0, ITEM_STACKABLE în FLAG). Cum creezi itemul și partea de client ai văzut în lecția Item nou, server + client. Questul:
quest pergament_exp begin
state start begin
when 95001.use begin
if pc.count_item(95001) < 1 then
return
end
pc.remove_item(95001, 1)
pc.give_exp2(5000)
syschat("Ai primit 5000 EXP.")
end
end
endBucată cu bucată:
when 95001.usepornește când jucătorul folosește itemul 95001;pc.count_item(95001) < 1: dacă, între timp, nu mai are itemul, ne oprim;pc.remove_item(95001, 1)scoate o bucată, înainte de a da efectul;pc.give_exp2(5000)dă 5000 EXP;syschat(...)afișează un mesaj în chat.
Ordinea contează: întâi consumi, apoi dai. Dacă ai da întâi efectul și ceva ar întrerupe scriptul înainte de consumare, jucătorul ar primi efectul și ar păstra itemul. Toate funcțiile de mai sus există în quest_functions din pachetul verificat. Cum compilezi și încarci questul ai văzut în Primul quest Lua.
Dacă efectul e un item (de exemplu un cufăr care dă alt item), verifică întâi locul liber în inventar, cu pc.enough_inventory(vnum), și abia apoi consumi și dai. Altfel recompensa poate cădea pe jos sau se poate pierde.
Pasul 1: pregătește testul
- serverul de test pornit, fără erori noi în
syserr; - un personaj de test și GM-ul care creează itemele:
/item 95001 10; - o foaie cu: bucăți înainte, EXP/HP înainte, acțiune, bucăți după, EXP/HP după.
Pasul 2: rulează scenariile
| Scenariu | Ce ar trebui să vezi |
|---|---|
| Folosești o bucată | Teancul scade cu 1, EXP crește cu 5000, un singur mesaj |
| Dublu-click foarte rapid, de 5 ori | Exact 5 bucăți consumate, exact 5 × 5000 EXP |
| Folosești ultima bucată | Itemul dispare complet, efectul vine o dată |
| Licoare la HP plin | Licoarea nu se consumă |
| Inventar plin (dacă efectul e un item) | Mesaj de eliberare loc, nimic consumat |
| Folosești, apoi relog imediat | După relog, bucățile și EXP-ul se potrivesc cu foaia |
| Schimbi canalul și folosești din nou | Același comportament ca pe primul canal |
Dacă un rând nu se potrivește, oprește-te. Nu trece la alt test până nu înțelegi de ce.
Pasul 3: verifică după relog, nu doar în chat
Mesajul „Ai primit 5000 EXP” arată doar că scriptul a ajuns la acea linie. Nu dovedește că datele s-au salvat. Ieși complet din joc, intră din nou și verifică numărul de bucăți și EXP-ul.
Pe baza de date de test poți număra bucățile rămase:
SELECT owner_id, window, pos, count FROM item WHERE vnum = 95001;Comparația „înainte / după” trebuie să dea exact numărul de folosiri.
Pasul 4: caută urmele în loguri
În sursa verificată, pc.give_exp2 scrie o linie în logul serverului (QUEST [REWARD] … give exp2 …), iar pc.remove_item(vnum, 1) scrie o linie QUEST remove items(vnum …) count …. Numărul de linii de fiecare fel ar trebui să fie egal cu numărul de folosiri. Dacă vezi mai multe recompense decât consumări, ai găsit o problemă.
| Ce vezi | Ce înseamnă | Ce faci |
|---|---|---|
| Itemul dispare, efectul nu vine | Eroare în quest după consumare | Caută în syserr, corectează questul |
| Efectul vine, itemul nu dispare | Ordine greșită sau lipsește remove_item | Mută consumarea înaintea efectului |
| Nu se întâmplă nimic la folosire | Questul nu e încărcat sau tipul itemului e greșit | Verifică lista de questuri și tipul ITEM_QUEST |
| Merge pe un canal, pe altul nu | Questul nu e încărcat peste tot | Repornește toate canalele de test |
Greșeli des întâlnite
- Dai efectul înainte să consumi itemul. Calea clasică spre abuz.
- Testezi doar o folosire, încet. Problemele apar la dublu-click, lag și relog.
- Nu verifici inventarul înainte de a da iteme. Recompensa se pierde sau cade pe jos.
- Te bazezi pe mesajul din chat ca dovadă de salvare. Verifică după relog.
- Scrii quest flag-uri în
when loginca să „resetezi” ceva legat de consumabil. Evită: e un tipar cunoscut pentru date corupte. Scrie flag-uri doar din acțiuni ale jucătorului, ca aici.
Întrebări frecvente
De ce licoarea nu se consumă când am HP plin?
E comportamentul din sursa verificată: dacă HP-ul e deja la maximum, folosirea e refuzată, ca să nu pierzi licoarea degeaba.
Pot face un consumabil cu timp de așteptare între folosiri?
Da, în quest: salvezi momentul folosirii cu pc.setqf și get_time(), și refuzi folosirea până trece timpul. Testează și cooldown-ul după relog.
Trebuie să fie stivuibil?
Nu e obligatoriu, dar e comod. Dacă îl faci stivuibil, citește întâi Stivuirea și limitele unui item.
Ce urmează
Ai terminat capitolul Iteme: valori, bonusuri și upgrade! Următorul capitol începe cu Cum gândești gameplay-ul unui server. Toate lecțiile sunt în lista tutorialelor Metin2.
Server Metin2 gata de joc
Găzduire Metin2 în România, cu instalare de serverfiles, bază de date MySQL și protecție Anti-DDoS inclusă.