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.
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ânt | Ce î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 itemului | Câ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:
- Dacă itemul se poate stivui, îl adaugă la o stivă existentă din inventar.
- Dacă nu, îl pune într-un loc liber.
- 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 itemului | Dacă 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ă
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
endExplicat rând cu rând
| Rând | Ce înseamnă |
|---|---|
with pc.get_level() >= 20 and pc.getqf("primit") == 0 | Opț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 then | Verifică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) then | Are 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
- Verifici locul înainte să iei ceva de la jucător sau să-i dai ceva.
- Marchezi recompensa ca luată în același bloc în care o dai: flag (
pc.setqf) sau etapă (set_state). - Nimic care așteaptă între verificare și dare. Fără
select(),wait()sauinput()între ultima verificare șipc.give_item2. Dacă ai nevoie de confirmare, o ceri înainte de verificări. - 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ă.
- 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.
- 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
- Inventar gol: primești 50 de poțiuni și 10.000 yang.
- Inventar complet plin: primești mesajul „Nu ai loc”, nu primești nimic, iar opțiunea rămâne la NPC.
- Inventar plin, dar cu o stivă de 10 poțiuni (27002): vezi ce se întâmplă.
pc.enough_inventoryspune „nu” chiar dacă poțiunile s-ar fi putut stivui. E prudent, nu greșit. - 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 loc | Itemul cade pe jos și se poate pierde |
Flag-ul se setează după un select() aflat după give_item2 | Jucă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ă verificare | Unele cad pe jos |
Cadou în when login cu pc.setqf | Risc 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ă.