Un NPC propriu dă personalitate serverului: un ghid pentru începători, un negustor de eveniment, un bătrân care împarte cadouri. Problema e că un NPC nu stă într-un singur loc. El trebuie să existe pe server, în client, pe hartă și, ca să vorbească, într-un quest. Dacă lipsește oricare dintre ele, NPC-ul fie nu apare, fie apare mut, fie apare ca un pătrat ciudat. Lecția îți arată toate cele patru piese, în ordine.
mob_proto cu un VNUM nou, îi dai nume în mob_names, îi spui clientului ce model folosește (npclist.txt + mob_proto din client), îl așezi pe hartă în npc.txt și îi scrii un quest care dă recompensa o singură dată.Cuvinte pe care le vei întâlni
| Cuvânt | Ce înseamnă |
|---|---|
| mob_proto | Lista cu toți monștrii și NPC-urile: nivel, tip, ce se întâmplă la click. |
| mob_names | Lista „număr → nume afișat”. |
| npclist.txt | Fișier din client care spune ce model 3D are fiecare NPC. |
| npc.txt | Fișierul hărții în care scrie ce NPC stă și unde. |
| Quest flag | O „bifă” salvată pe personaj, de exemplu „a primit cadoul”. |
Pasul 0: Alege un VNUM liber
Ai nevoie de un număr pe care nu-l folosește nimic. Caută-l în toate listele:
grep -P "^20500\t" /usr/home/game/share/conf/mob_proto.txt
grep -P "^20500\t" /usr/home/game/share/conf/mob_names.txt(Căile sunt exemple: găsește-le pe ale tale cu find /usr/home -name "mob_proto*".) Dacă nu apare niciun rând, numărul e liber. În pachetul verificat, 20500 era liber; la tine poate fi ocupat. Recomandare: alege un număr sub 32767, pentru că unele tabele (de exemplu shop.npc_vnum) nu primesc numere mai mari.
Pasul 1: Rândul din mob_proto (server)
Cel mai sigur e să copiezi un NPC care merge deja. Uriel (20011) e un NPC simplu, care doar vorbește. Fă backup la mob_proto.txt, deschide-l în Notepad++ și copiază rândul care începe cu 20011. Lipește-l dedesubt și schimbă doar:
- prima coloană,
VNUM: din20011în20500; - a doua coloană,
NAME: un nume intern, fără diacritice.
Restul rămâne la fel. În pachetul verificat, coloana TYPE e NPC, iar coloana ON_CLICK e 2, adică „la click, vorbește”. Valoarea 1 ar însemna „la click, deschide magazinul”. Nu schimba alte coloane la primul test.
Atenție la taburi: fiecare coloană e despărțită de un TAB, nu de spații. Dacă nu ești sigur, recitește lecția despre fișierele TXT, taburi și encoding.
În unele pachete, procesul db citește mob_proto.txt din folderul lui (db/), nu din share/conf. Uneori e un link spre același fișier, alteori e o copie separată. Verifică ce citește serverul tău și modifică fișierul corect.
Pasul 2: Numele afișat
În mob_names.txt adaugi un rând nou: numărul, un TAB, numele.
20500 Ghidul SatuluiDacă ai și variante pe limbi (de exemplu mob_names_ro.txt), adaugă rândul și acolo.
Pasul 3: Clientul
Clientul trebuie să știe două lucruri: că NPC-ul există și cum arată.
- Modelul: în
npclist.txt(în pachetul verificat, înroot), fiecare rând are VNUM-ul și folderul modelului. Uriel are rândul20011 plant_researcher. Pentru NPC-ul tău adaugi20500 plant_researcher, adică refolosești modelul lui Uriel. Model nou înseamnă muncă grafică separată. - Datele: clientul are și el un
mob_proto, de obicei împachetat în arhivalocale. Trebuie să conțină și rândul nou, altfel numele și datele NPC-ului lipsesc în client. Instrumentul cu care refaci acest fișier diferă de la pachet la pachet.
Partea de client e explicată mai pe larg la itemul nou pe server și client: logica e aceeași.
Pasul 4: Pune NPC-ul pe hartă
Fiecare hartă are un folder cu fișiere de spawn. În pachetul verificat, în npc.txt de la harta metin2_map_a1, prima linie explică coloanele:
//type cx cy sx sy z dir time percent count vnum
m 713 605 1 1 0 0 1m 100 1 20011Al doilea rând e chiar Uriel. Pe scurt: m = un singur personaj, 713 605 = locul pe hartă, 1m = timpul de reapariție, 100 = șansa, 1 = câți, 20011 = cine. Copiezi rândul, schimbi ultimul număr în 20500 și muți puțin coordonatele (de exemplu 718 605), ca să nu stea unul peste altul. Despre coloane și coordonate: lecțiile despre spawn cu regen.txt și despre coordonatele hărților.
Pasul 5: Questul cu dialog și recompensă
Acum NPC-ul trebuie să vorbească. Fișierul ghid_sat.quest:
quest ghid_sat begin
state start begin
when 20500.chat."Cadou de bun venit" begin
say_title("Ghidul Satului")
if pc.getqf("cadou_primit") == 1 then
say("Ti-am dat deja cadoul. Mult succes!")
return
end
if pc.get_level() < 10 then
say("Revino cand ajungi la nivelul 10.")
return
end
if not pc.enough_inventory(27002) then
say("Fa loc in inventar si revino.")
return
end
pc.setqf("cadou_primit", 1)
pc.give_item2(27002, 20)
say("Poftim 20 de potiuni. Spor la vanatoare!")
end
end
endBucată cu bucată:
| Rând | Ce face |
|---|---|
pc.getqf("cadou_primit") == 1 | Verifică bifa: a primit deja cadoul? Dacă da, return oprește questul aici. |
pc.get_level() < 10 | Condiție de nivel. |
pc.enough_inventory(27002) | Verifică dacă are loc în inventar pentru itemul 27002. |
pc.setqf("cadou_primit", 1) | Pune bifa înainte de a da itemul. |
pc.give_item2(27002, 20) | Dă 20 de Red Potion(M). |
De ce bifa înainte? Dacă ar fi după, orice problemă apărută între cele două rânduri ar lăsa jucătorul cu itemul și fără bifă, deci ar putea lua din nou. Între aceste rânduri nu există nicio pauză (niciun select sau wait), așa că serverul le execută una după alta, fără ca jucătorul să poată interveni.
De ce verificăm inventarul? În sursa verificată, dacă inventarul e plin, pc.give_item2 aruncă itemul pe jos lângă jucător. Dacă jucătorul nu-l vede, îl pierde. Mai sigur e să-l rogi să facă loc.
O regulă importantă: nu pune bife (pc.setqf) într-un bloc when login. În multe pachete asta poate strica datele personajului. Pune-le doar în acțiuni făcute de jucător, ca aici.
Pui questul în folderul de questuri, îl adaugi în listă (quest_list sau locale_list), îl compilezi și dai /reload q, exact ca în primul tău quest Lua.
Pasul 6: Testează
Pentru proto și hartă ai nevoie de restart complet al serverului de test. Apoi:
- NPC-ul apare la coordonatele alese, cu modelul și numele corect.
- Cu un personaj sub nivelul 10 primești mesajul de nivel.
- Cu inventarul plin primești mesajul de inventar și nu pierzi nimic.
- Prima dată primești cele 20 de poțiuni.
- A doua oară primești „Ti-am dat deja cadoul”.
Ce ar trebui să vezi: recompensa o singură dată pe personaj, chiar dacă dai click de mai multe ori.
Greșeli des întâlnite
| Ce vezi | Ce înseamnă | Ce faci |
|---|---|---|
| NPC-ul nu apare deloc | Lipsește din mob_proto (server) sau din npc.txt. | Verifică ambele și syserr. |
| Apare fără model sau invizibil | Lipsește din npclist.txt sau din mob_proto-ul clientului. | Adaugă rândurile în client. |
| Apare, dar nu are nicio opțiune | Questul nu e compilat sau VNUM-ul din quest e greșit. | Compilează, verifică 20500. |
| Recompensa se poate lua de mai multe ori | Bifa lipsește sau e pusă după give_item2. | Bifa înainte, ca în exemplu. |
Întrebări frecvente
Pot face un NPC fără să modific clientul?
Doar dacă refolosești un VNUM pe care clientul îl cunoaște deja. Pentru un VNUM nou, clientul trebuie actualizat.
Recompensa e pe personaj sau pe cont?
Pe personaj: pc.setqf salvează bifa pe personaj. Un jucător cu trei personaje primește de trei ori. Ține cont de asta când alegi recompensa.
Pot pune NPC-ul pe mai multe hărți?
Da, adaugi câte un rând în npc.txt-ul fiecărei hărți. Questul merge oriunde, pentru că e legat de VNUM, nu de hartă.
Ce urmează
Acum că ai NPC-uri și magazine, învață cum stabilești prețurile și restricțiile la magazine. 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ă.