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

Cum creezi un item nou în Metin2: server, client, nume și iconiță

2 noiembrie 2026 6 min de citit

Ai o idee: o licoare specială pentru un eveniment, un material nou pentru upgrade, un cufăr cu recompense. Ca să existe în joc, itemul trebuie creat în **două locuri**. Serverul trebuie să știe ce face, iar clientul (jocul de pe calculatorul jucătorului) trebuie să știe cum arată și cum se numește. Dacă uiți una din părți, itemul apare invizibil, fără nume sau nu apare deloc.

Pe scurt: alegi un VNUM liber, adaugi rândul în item_proto.txt și numele în item_names.txt pe server, apoi în client adaugi rândul în item_list.txt, descrierea în itemdesc.txt, iconița și refaci item_proto-ul clientului. Testezi întâi pe serverul de test.

Cuvinte pe care le vei întâlni

CuvântCe înseamnă
item_list.txtLista din client care leagă VNUM-ul de iconiță și de modelul 3D.
itemdesc.txtDescrierile itemelor din client (textul din tooltip).
IconițăImaginea mică din inventar, de obicei un fișier .tga.
dump_protoUnealtă care transformă item_proto.txt în fișierul item_proto citit de client.
PackArhivele clientului în care stau fișierele (în pachetul verificat: .eix + .epk).

Cele două lumi ale unui item

Gândește-te la un produs nou într-un magazin. Depozitul (serverul) trebuie să-l aibă în evidență: preț, cantitate, reguli. Raftul (clientul) trebuie să aibă eticheta și poza. Fără evidență, produsul nu se poate vinde. Fără etichetă, clientul nu știe ce cumpără.

ParteCe fișiereCe decide
Serveritem_proto.txt, item_names.txtCe face itemul: tip, valori, interdicții, preț
Clientitem_list.txt, itemdesc.txt, iconiță, item_protoCum arată: nume, iconiță, model, tooltip

Exemplul nostru: o licoare de test, „Licoare de test”, care reface 500 HP.

Pasul 1: alege un VNUM liber

Alege un număr care nu există nici pe server, nici în client. În pachetul verificat, 95000 e liber. Verifici pe server:

sh
grep -P "^95000\t" /cale/share/conf/item_proto.txt

Dacă nu apare nimic, numărul e liber pe server. Caută-l și în item_list.txt din client (Ctrl+F în Notepad++). Notează-l într-un fișier de evidență (changelog), cum am arătat în lecția Modificări sigure.

Sfat: păstrează-ți itemele proprii într-un interval al tău (de exemplu 95000–95999). Așa le găsești ușor și nu te ciocnești cu itemele pachetului.

Pasul 2: rândul în item_proto.txt (server)

Nu scrie rândul de la zero. Copiază un item asemănător care merge și schimbă doar ce trebuie. Pentru o licoare, modelul e Licoarea roșie (S), VNUM 27001. Rândul nou, cu TAB-uri între coloane:

text
95000	Licoare de test	ITEM_USE	USE_POTION	1	NONE	ITEM_STACKABLE | ITEM_SLOW_QUERY	NONE	NONE	32	30	0	0	0	LIMIT_NONE	0	LIMIT_NONE	0	APPLY_NONE	0	APPLY_NONE	0	APPLY_NONE	0	500	0	0	0	0	0	0	0	0

Ce am schimbat față de 27001:

  • prima coloană: 95000 (VNUM-ul nou);
  • a doua coloană: un nume intern simplu, fără diacritice și fără ghilimele;
  • VALUE0: 500 (HP-ul refăcut).

Restul e identic. Semnificația fiecărei coloane e în lecția Valorile din item_proto. Pune rândul la finalul fișierului sau lângă iteme asemănătoare.

Pasul 3: numele în item_names.txt (server)

Formatul e simplu: VNUM, TAB, nume.

text
95000	Licoare de test

Atenție la limbă: în pachetul verificat există item_names.txt (engleză) și variante ca item_names_ro.txt, dar procesul db citește doar item_names.txt. Dacă vrei numele în română pe server, ele trebuie să ajungă în fișierul citit efectiv. La tine poate fi altfel: verifică ce fișier e folosit.

Pasul 4: repornește și testează pe server

Repornește serverul de test și uită-te în syserr (lecția Server nu pornește). Apoi, cu personajul GM:

text
/item 95000 10

Comanda creează 10 bucăți (în multe pachete merge și prescurtarea /i). Dacă serverul acceptă itemul, dar clientul încă nu-l cunoaște, vei vedea un slot gol, fără iconiță sau nume. E normal în acest moment: clientul urmează.

Pasul 5: client, item_list.txt și itemdesc.txt

În clientul verificat, fișierele stau în pack-ul de limbă (de exemplu locale_ro), în folderul locale/ro/. Pentru a le edita, pack-ul trebuie despachetat cu unealta clientului tău (clientul verificat vine cu EterNexus).

Rândul din item_list.txt (VNUM, tip pentru client, iconiță, model 3D opțional):

text
95000	ETC	icon/item/27001.tga

Tipul pentru client e WEAPON, ARMOR sau ETC. Am folosit iconița licorii roșii, ca să nu avem nevoie de o imagine nouă la primul test. Armele au și a patra coloană, calea modelului .gr2.

Rândul din itemdesc.txt (VNUM, nume, descriere), opțional:

text
95000	Licoare de test	Reface 500 HP. Folosită doar pentru teste.

Pasul 6: iconița proprie (opțional)

Când vrei imagine proprie, creezi un .tga de aceeași mărime ca iconița unui item asemănător (de obicei 32×32 pixeli pentru o căsuță; deschide o iconiță existentă și verifică), îl pui în pack-ul de iconițe la icon/item/95000.tga și schimbi calea în item_list.txt. Folosește doar imagini pe care ai dreptul să le folosești.

Pasul 7: item_proto pentru client

Clientul are propriul item_proto, un fișier compilat (nu text). În clientul verificat, lângă EterNexus există folderul --dump_proto-- cu dump_proto.exe, item_proto.txt și item_names.txt, în același format ca pe server.

  1. Copiază acolo item_proto.txt și item_names.txt actuale de pe server.
  2. Rulează dump_proto.exe. Rezultatul e fișierul item_proto (fără extensie).
  3. Fă backup la item_proto din locale/ro/, apoi pune-l pe cel nou în locul lui.
  4. Împachetează la loc pack-ul de limbă (și pe cel de iconițe, dacă ai adăugat imagine).

Bine de știut: dump_proto compilează tot fișierul, deci clientul primește toate modificările de pe server, nu doar itemul nou. De aceea e bine să ai o singură „sursă” a item_proto, din care copiezi în ambele părți.

Uneltele și formatele diferă mult între clienți (alte arhive, alte nume de unelte). Dacă clientul tău e altfel, caută echivalentul pașilor de mai sus.

Pasul 8: verifică totul împreună

Pornește clientul actualizat (lecția Conectare client) și creează din nou itemul.

Ce ar trebui să vezi: iconița licorii, numele „Licoare de test”, descrierea în tooltip. Folosită pe un personaj rănit, reface HP.

Ce veziCe înseamnăCe faci
Slot gol, fără iconițăClientul nu are itemul în item_listVerifică rândul și repack-ul
Iconiță corectă, nume greșitClientul are item_proto vechiRefă cu dump_proto
„Item not exist” la /itemServerul nu are itemulVerifică item_proto.txt și repornește
Clientul se închideFișier de client stricatPune backupul înapoi, compară

Greșeli des întâlnite

  • Uiți clientul. Itemul există pe server, dar jucătorii văd un slot gol.
  • VNUM deja folosit în client. Iconița și numele sunt ale altui item.
  • Diacritice în coloana de nume din item_proto. Pune-le doar în item_names și itemdesc.
  • Trimiți jucătorilor clientul nou înaintea serverului sau invers. Pregătește ambele și publică-le împreună (vezi ce este un autopatcher).
  • Folosești resurse luate de pe alte servere fără drept. Poate aduce probleme legale.

Întrebări frecvente

Trebuie neapărat iconiță nouă?

Nu. Poți refolosi iconița unui item existent. E chiar recomandat la primul test.

Pot crea itemul doar pe server, pentru un quest?

Serverul îl va folosi, dar jucătorul nu-l va vedea corect. Pentru orice item care ajunge în inventar, actualizează și clientul.

De ce item_proto din client nu e text?

Așa a fost construit jocul: clientul citește o variantă compilată. Sursa ei e tot item_proto.txt, transformat cu dump_proto.

Ce urmează

Lecția următoare: Cum funcționează bonusurile pe echipament. Mai multe despre diferențele client–server în Diferențe client–server la iteme noi. 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