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

Cum dai recompense direct în inventar, în siguranță, dintr-un quest Metin2

2 noiembrie 2026 7 min de citit

Aproape fiecare quest se termină cu o recompensă. Și aproape fiecare server nou are, în primele săptămâni, una din două probleme: jucători care își pierd recompensa pentru că aveau inventarul plin, sau jucători care iau aceeași recompensă de mai multe ori. Ambele se pot evita cu câteva reguli simple. În lecția asta vedem ce se întâmplă de fapt în spatele funcției `pc.give_item2` și cum o folosești corect.

Pe scurt: verifici locul cu pc.enough_inventory, marchezi recompensa ca „luată” (flag sau etapă) și dai itemul, toate în același bloc, fără select() sau wait() între ele. Dai o singură stivă de cel mult 200 de bucăți, iar pentru pachete mari de premii folosești un cufăr.

Cuvinte pe care le vei întâlni

CuvântCe înseamnă
StivăMai multe bucăți din același item, puse într-un singur loc din inventar (de exemplu 200 de poțiuni).
Mărimea itemuluiCâte căsuțe ocupă pe verticală: o poțiune ocupă 1, o armă poate ocupa 2 sau 3.
Ownership„Proprietarul” unui item căzut pe jos: un timp, doar el îl poate ridica.
Dublare (dupe)Când un jucător obține de două ori ceva ce trebuia să primească o dată.

Ce face pc.give_item2 când inventarul e plin

Am verificat în sursa pachetului de referință. pc.give_item2(vnum, câte) încearcă, pe rând:

  1. Dacă itemul se poate stivui, îl adaugă la o stivă existentă din inventar.
  2. Dacă nu, îl pune într-un loc liber.
  3. Dacă nu mai e loc, itemul cade pe jos, lângă jucător. Doar el îl poate ridica, pentru aproximativ 60 de secunde (sau mai mult la itemele care nu se pot arunca), iar apoi itemul poate dispărea.

Cu alte cuvinte, funcția nu refuză și nu te avertizează. Dacă jucătorul nu observă itemul de pe jos, îl pierde. Asta ajunge la tine ca tichet de suport: „N-am primit recompensa!”.

Ce verifică, de fapt, pc.enough_inventory

Tot din sursa pachetului verificat: pc.enough_inventory(vnum) răspunde „da” dacă există un loc liber suficient de mare pentru o bucată din acel item. Atât.

Ce verificăCe NU verifică
Un loc liber pentru mărimea itemuluiDacă ai loc pentru mai multe iteme diferite
Că VNUM-ul existăCă itemul s-ar putea stivui peste unul existent
—Inventarele speciale adăugate în sursă de unele pachete

Pe înțeles: dacă dai un singur fel de item, verificarea e suficientă. Dacă dai trei feluri diferite, o verificare pentru primul nu garantează loc și pentru celelalte două.

Unele pachete modificate au funcții mai bune (de exemplu o funcție care simulează exact unde ar intra toate itemele). În pachetul de referință nu există. Caută în quest_functions din pachetul tău înainte să presupui ceva.

Codul: un cadou de nivel, dat o singură dată

lua
quest cadou_nivel20 begin
    state start begin
        when 20011.chat."Cadou de nivel 20" with pc.get_level() >= 20 and pc.getqf("primit") == 0 begin
            say_title("Cadou de nivel 20")
            say("Ai ajuns la nivelul 20. Felicitari!")
            say("Primesti 50 de Potiuni Rosii (M) si 10.000 yang.")
            local alegere = select("Primesc", "Mai tarziu")
            if alegere ~= 1 then
                return
            end
            if pc.getqf("primit") == 1 then
                say("Ai primit deja cadoul.")
                return
            end
            if not pc.enough_inventory(27002) then
                say("Nu ai loc in inventar. Fa loc si revino.")
                return
            end
            pc.setqf("primit", 1)
            pc.give_item2(27002, 50)
            pc.change_money(10000)
            say("Gata! Spor la joc.")
        end
    end
end

Explicat rând cu rând

RândCe înseamnă
with pc.get_level() >= 20 and pc.getqf("primit") == 0Opțiunea apare doar la nivel 20+ și doar dacă flag-ul primit e încă 0. După primire, opțiunea dispare.
local alegere = select(...)Confirmare. Aici questul așteaptă jucătorul.
if pc.getqf("primit") == 1 thenVerificăm din nou după confirmare. Condiția din with a fost adevărată când s-a deschis dialogul, dar asta a fost înainte de așteptare.
if not pc.enough_inventory(27002) thenAre loc pentru poțiuni? Dacă nu, oprim totul. Flag-ul rămâne 0, deci jucătorul poate reveni.
pc.setqf("primit", 1)Marcăm cadoul ca luat, înainte de a-l da.
pc.give_item2(27002, 50)Dăm 50 de poțiuni.
pc.change_money(10000)Dăm yang. Yang-ul nu ocupă loc în inventar.

De ce marcăm înainte, nu după? Dacă ceva neprevăzut întrerupe codul între cele două rânduri, e mai bine ca jucătorul să rămână fără o recompensă (îi poți da manual, după ce verifici logurile) decât să rămână cu posibilitatea de a o lua încă o dată. O recompensă lipsă se repară ușor. O dublare exploatată de zeci de jucători, nu.

Șase reguli pentru recompense

  1. Verifici locul înainte să iei ceva de la jucător sau să-i dai ceva.
  2. Marchezi recompensa ca luată în același bloc în care o dai: flag (pc.setqf) sau etapă (set_state).
  3. Nimic care așteaptă între verificare și dare. Fără select(), wait() sau input() între ultima verificare și pc.give_item2. Dacă ai nevoie de confirmare, o ceri înainte de verificări.
  4. Cel mult 200 de bucăți într-un apel. În pachetul de referință o stivă are maximum 200, iar numărul de bucăți e transmis intern ca o valoare de la 0 la 255. Dacă scrii 300, ajung 44 (300 minus 256). Nu e o glumă: verifică mereu cantitatea primită.
  5. Pentru mai multe premii, dai un cufăr. În loc de cinci iteme diferite, dai un singur item-cufăr, iar jucătorul îl deschide când are loc. Vezi cum creezi un cufăr nou.
  6. Nu scrii flag-uri în when login. Un cadou „la logare” pare comod, dar scrierea de flag-uri la intrarea în joc poate strica datele questurilor (o problemă cunoscută a motorului). Pune cadoul la un NPC, ca mai sus.

Cum verifici în loguri

În pachetul verificat, fiecare pc.give_item2 scrie în syslog un rând de forma QUEST [REWARD] item ... to NumePersonaj și înregistrează recompensa și în baza de loguri. Când un jucător spune că n-a primit nimic sau suspectezi o dublare, caută acolo numele personajului. Vezi cum lucrezi cu logurile în lecția despre serverul care nu pornește.

Testează pe serverul de test

  1. Inventar gol: primești 50 de poțiuni și 10.000 yang.
  2. Inventar complet plin: primești mesajul „Nu ai loc”, nu primești nimic, iar opțiunea rămâne la NPC.
  3. Inventar plin, dar cu o stivă de 10 poțiuni (27002): vezi ce se întâmplă. pc.enough_inventory spune „nu” chiar dacă poțiunile s-ar fi putut stivui. E prudent, nu greșit.
  4. După primire: opțiunea dispare. Ieși din joc, revino: tot nu apare.

Ce ar trebui să vezi: recompensa o dată, niciodată de două ori, niciodată pe jos.

Greșeli des întâlnite

GreșealăCe se întâmplă
pc.give_item2 fără verificare de locItemul cade pe jos și se poate pierde
Flag-ul se setează după un select() aflat după give_item2Jucătorul închide fereastra și ia recompensa din nou
pc.give_item2(vnum, 500)Ajunge alt număr de bucăți decât ai scris
Cinci iteme diferite cu o singură verificareUnele cad pe jos
Cadou în when login cu pc.setqfRisc de date de quest stricate

Întrebări frecvente

Pot da un item care nu se stivuiește, de exemplu o armă?

Da: pc.give_item2(vnum) fără număr dă o bucată. Verifică locul cu pc.enough_inventory(vnum), care ține cont de mărimea armei.

Ce diferență e între pc.give_item și pc.give_item2?

În pachetul de referință, questurile folosesc aproape peste tot pc.give_item2, care dă direct în inventar (sau pe jos, dacă e plin). pc.give_item are alt mod de lucru și alte argumente. Rămâi la pc.give_item2, ca în exemplele din pachet.

Cum testez „dublarea” fără să știu cum se face?

Încearcă tot ce ar încerca un jucător: apasă de mai multe ori, închide fereastra cu Esc, ieși din joc în mijlocul dialogului, schimbă canalul, revino. Mai multe teste găsești în testarea NPC-urilor împotriva dublării.

Ce urmează

Am folosit flag-ul primit ca să ținem minte o recompensă. În lecția următoare vedem flag-urile pe larg, plus condițiile de nivel și misiunile zilnice: quest flag-uri și condiții de nivel.

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