Înapoi la blogToate tutorialele Metin2
Tutoriale Metin2 · Lecția 39 din 99

Cum testezi un consumabil în Metin2 fără să pierzi iteme sau să dublezi efecte

2 noiembrie 2026 6 min de citit

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.

Pe scurt: consumabilele „clasice” (licorile) sunt tratate direct de server, după valorile din 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ântCe înseamnă
ConsumabilItem care dispare (total sau o bucată din teanc) când îl folosești.
EfectCe primești: HP, EXP, un buff, alte iteme.
when VNUM.useEvenimentul 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):

  1. dacă VALUE1 nu e 0, reface MP; dacă VALUE0 nu e 0, reface HP;
  2. dacă HP-ul (sau MP-ul) e deja plin, licoarea nu se consumă și nu se întâmplă nimic;
  3. bonusul „efect licoare” poate mări efectul, cel mult de două ori;
  4. 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:

lua
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
end

Bucată cu bucată:

  • when 95001.use porneș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

ScenariuCe 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 oriExact 5 bucăți consumate, exact 5 × 5000 EXP
Folosești ultima bucatăItemul dispare complet, efectul vine o dată
Licoare la HP plinLicoarea nu se consumă
Inventar plin (dacă efectul e un item)Mesaj de eliberare loc, nimic consumat
Folosești, apoi relog imediatDupă relog, bucățile și EXP-ul se potrivesc cu foaia
Schimbi canalul și folosești din nouAcelaș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:

sql
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 veziCe înseamnăCe faci
Itemul dispare, efectul nu vineEroare în quest după consumareCaută în syserr, corectează questul
Efectul vine, itemul nu dispareOrdine greșită sau lipsește remove_itemMută consumarea înaintea efectului
Nu se întâmplă nimic la folosireQuestul nu e încărcat sau tipul itemului e greșitVerifică lista de questuri și tipul ITEM_QUEST
Merge pe un canal, pe altul nuQuestul nu e încărcat peste totReporneș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 login ca 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ă.

DiscordWhatsApp