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

Cum testezi NPC-urile Metin2 ca să nu dubleze recompense: plan de test pas cu pas

2 noiembrie 2026 7 min de citit

Ai scris un NPC care dă un cadou, un schimb de materiale sau un serviciu plătit. În testul tău merge perfect. Apoi, în prima seară după lansare, cineva descoperă că, dacă apasă de două ori repede sau iese din joc la momentul potrivit, primește recompensa de două ori. Până dimineață, itemul e peste tot și nu mai valorează nimic. Lecția îți dă un plan de test pe care îl treci înainte de a publica orice NPC cu recompense.

Pe scurt: testezi ca un jucător care vrea să păcălească sistemul: click-uri repetate, iteme mutate în timpul dialogului, inventar plin, relogare la mijloc, restart. Pentru fiecare test notezi inventarul și yang-ul înainte și după și verifici în loguri că a avut loc exact o tranzacție.

Cuvinte pe care le vei întâlni

CuvântCe înseamnă
Dublare (dupe)Un item sau o recompensă obținută de două ori, fără să fie plătită de două ori.
TranzacțieUn schimb complet: jucătorul plătește și primește o singură dată.
syslog / syserrJurnalele text ale serverului: tot ce se întâmplă / doar erorile.
quest_reward_logTabel din baza de loguri în care, în multe pachete, apare fiecare recompensă dată printr-un quest.
Fișă de testUn tabel simplu în care notezi ce ai făcut și ce ai observat.

De unde vin dublările

Aproape toate dublările la NPC vin din trei greșeli de ordine, explicate în lecțiile anterioare:

  1. Verificarea e făcută înainte de o pauză. Questul verifică itemele, apoi arată butoane (select) sau „Următorul” (wait). În pauză, jucătorul mută itemele. Vezi schimbul de iteme la NPC.
  2. Recompensa e dată înainte de plată sau înainte de bifă. Dacă ceva se întrerupe între ele, jucătorul rămâne și cu plata, și cu recompensa. Vezi NPC-ul nou cu recompensă.
  3. Plata nu e verificată. De exemplu, în sursa verificată, o plată de yang mai mare decât are jucătorul nu ia nimic, iar questul merge mai departe. Vezi consumatorul de yang.

Testele de mai jos sunt făcute ca să prindă exact aceste greșeli.

Pasul 1: Pregătește terenul

Lucrezi doar pe serverul de test, niciodată pe cel cu jucători. Ai nevoie de:

  • un cont de GM, ca să creezi iteme și yang de test;
  • un cont normal, cu un personaj de test (GM-ii pot avea alte reguli);
  • un al doilea personaj normal, pentru testele cu negoț;
  • acces la jurnalele canalului (syslog, syserr) și, dacă există, la baza de loguri;
  • o fișă de test, de exemplu în Excel sau pe hârtie.

Pentru fiecare test notezi în fișă: ce ai făcut, inventarul și yang-ul înainte, inventarul și yang-ul după, ce ai așteptat și ce s-a întâmplat.

Pasul 2: Planul de test

Treci fiecare rând. Coloana a treia e rezultatul corect: orice altceva înseamnă o problemă.

TestCum îl faciRezultat corect
Cazul normalAi exact ce se cere, faci schimbul.O plată, o recompensă.
Lipsește puținAi cu o bucată sau cu un yang mai puțin.Mesaj clar; nu pierzi nimic.
Ai mult mai multAi de 3 ori cantitatea cerută.Se ia doar cât trebuie.
Inventar plinUmpli inventarul, apoi faci schimbul.Mesaj „Fă loc”; nu pierzi nimic.
Click-uri repetateApeși rapid de mai multe ori pe NPC și pe butonul de confirmare.Tot o singură tranzacție.
Iteme mutate în dialogDeschizi dialogul, arunci sau dai prin negoț itemele, apoi confirmi.Mesaj „Nu ai destule”; nicio recompensă.
Yang cheltuit în dialogLa un serviciu plătit: deschizi dialogul, cumperi ceva de la alt NPC, revii și confirmi.Mesaj „Nu ai destul yang”; nicio recompensă.
Relogare la mijlocDeschizi dialogul, ieși din joc, intri din nou și repeți.Fie o tranzacție completă, fie niciuna.
Recompensă unică, a doua oarăDupă ce ai primit-o, încerci din nou.Mesaj „Ai primit deja”.
Recompensă unică după restartPrimești recompensa, repornești serverul de test, încerci din nou.Tot „Ai primit deja”.
Alt canalPrimești recompensa pe canalul 1, treci pe canalul 2, încerci din nou.Tot „Ai primit deja”.

La click-urile repetate nu te opri la o singură încercare. Fă testul de cel puțin cinci ori: unele probleme apar doar uneori.

Pasul 3: Verifică în jurnale

Inventarul îți spune ce s-a întâmplat cu un personaj. Jurnalele îți spun ce a făcut serverul.

În syslog. În sursa verificată, fiecare scoatere de iteme dintr-un quest scrie un rând cu „QUEST remove items”, iar fiecare item dat cu pc.give_item2 un rând cu „QUEST [REWARD]”. După un test, caută-le în jurnalul canalului:

sh
grep "QUEST remove items" syslog | tail -n 5
grep "QUEST \[REWARD\]" syslog | tail -n 5

(Rulezi comenzile în folderul canalului pe care ai testat; la tine fișierul poate avea alt nume sau altă cale.) tail -n 5 arată ultimele cinci rânduri.

Ce ar trebui să vezi: pentru un schimb, exact un rând de scoatere și exact unul de recompensă, cu numele personajului tău. Două rânduri de recompensă pentru un singur schimb înseamnă o dublare.

În baza de loguri. În pachetul verificat, recompensele din questuri ajung și în tabelul quest_reward_log. Întâi afli numărul personajului, apoi îi citești recompensele:

sql
SELECT id, name FROM player.player WHERE name = 'Tester1';
SELECT * FROM log.quest_reward_log WHERE player_id = 1234 ORDER BY time DESC LIMIT 10;

Înlocuiește Tester1 cu numele personajului tău și 1234 cu numărul primit la primul SELECT. Numele bazelor (player, log) pot fi altele la tine. Rulează doar SELECT: aici doar citești.

În syserr. Caută erori apărute în timpul testelor, de exemplu de la o plată de yang refuzată. O eroare nouă după un test e un semn că ceva nu s-a întâmplat cum crezi.

Pasul 4: Când găsești o problemă

  1. Nu publica. Un NPC cu dublare e mai rău decât niciun NPC.
  2. Notează în fișă exact pașii prin care ai reprodus problema.
  3. Verifică ordinea din quest: pauze la început, verificări după ultima pauză, plată și verificarea ei, bifa, abia apoi recompensa.
  4. Corectează un singur lucru, recompilează, dă /reload q și reia tot planul, nu doar testul care a picat.

Dacă problema e deja pe serverul cu jucători: oprește rapid NPC-ul (scoate questul din listă, compilează, /reload q), apoi analizează în loguri cine a profitat. Pașii de revenire sunt în lecția despre modificări sigure și rollback, iar înainte de orice intervenție în baza de date faci backup.

Două capcane de engine

  • Nu scrie bife (pc.setqf) în when login. În multe pachete, asta poate strica datele personajului. Bifele se scriu doar din acțiuni făcute de jucător, cum ar fi dialogul cu NPC-ul.
  • Nu folosi event flag-uri ca „lacăt” pe jucător. game.set_event_flag e o valoare comună pentru tot serverul și ajunge pe canale cu întârziere. Pentru „a primit deja” folosește bifa personajului (pc.setqf), nu un event flag.

Greșeli des întâlnite

  • Testezi doar cazul normal. Cazul normal merge aproape mereu. Dublările stau în cazurile ciudate.
  • Testezi doar cu GM-ul. Contul de GM poate ocoli unele reguli. Testează cu un cont normal.
  • Nu notezi înainte și după. Fără cifre nu observi că ai primit 6 în loc de 5.
  • Repari și retestezi doar testul picat. O reparație poate strica alt caz. Reia tot planul.
  • Te bazezi pe faptul că „nimeni nu se va prinde”. Jucătorii testează mai mult decât tine.

Întrebări frecvente

Cât durează planul de test?

Pentru un NPC simplu, 20–40 de minute. E mult mai puțin decât îți ia să cureți economia după o dublare.

Ce fac dacă logurile nu se scriu?

Unele pachete au logurile oprite sau scriu doar o parte. Atunci te bazezi pe fișa de test și pe syslog. Pe termen lung, merită să ai loguri active pe serverul de test.

Trebuie să retestez după fiecare update?

Da, pentru NPC-urile cu recompense, după orice schimbare a questului sau a serverului. Păstrează fișa de test: data viitoare doar o refaci.

Ce urmează

Ai terminat capitolul NPC-uri, magazine și schimburi! Următorul capitol începe cu misiunea „omoară monștri”, cu progres salvat. 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