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.
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ânt | Ce înseamnă |
|---|---|
| item_list.txt | Lista din client care leagă VNUM-ul de iconiță și de modelul 3D. |
| itemdesc.txt | Descrierile itemelor din client (textul din tooltip). |
| Iconiță | Imaginea mică din inventar, de obicei un fișier .tga. |
| dump_proto | Unealtă care transformă item_proto.txt în fișierul item_proto citit de client. |
| Pack | Arhivele 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ă.
| Parte | Ce fișiere | Ce decide |
|---|---|---|
| Server | item_proto.txt, item_names.txt | Ce face itemul: tip, valori, interdicții, preț |
| Client | item_list.txt, itemdesc.txt, iconiță, item_proto | Cum 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:
grep -P "^95000\t" /cale/share/conf/item_proto.txtDacă 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:
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 0Ce 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.
95000 Licoare de testAtenț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:
/item 95000 10Comanda 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):
95000 ETC icon/item/27001.tgaTipul 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:
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.
- Copiază acolo
item_proto.txtșiitem_names.txtactuale de pe server. - Rulează
dump_proto.exe. Rezultatul e fișierulitem_proto(fără extensie). - Fă backup la
item_protodinlocale/ro/, apoi pune-l pe cel nou în locul lui. - Î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 vezi | Ce înseamnă | Ce faci |
|---|---|---|
| Slot gol, fără iconiță | Clientul nu are itemul în item_list | Verifică rândul și repack-ul |
| Iconiță corectă, nume greșit | Clientul are item_proto vechi | Refă cu dump_proto |
„Item not exist” la /item | Serverul nu are itemul | Verifică item_proto.txt și repornește |
| Clientul se închide | Fișier de client stricat | Pune 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ă.