Ce face aplicatia

RevengeArena Drop Editor este un tool pentru administrarea drop-urilor de pe servere Metin2.

Aplicatia lucreaza cu fisiere precum:

• mob_drop_item.txt
• special_item_group.txt
• item_names.txt
• item_proto.txt
• mob_names.txt
• mob_proto.txt
• item_list.txt
• map/index
• regen*.txt si boss*.txt din hartile active

Fisierele de harta sunt folosite doar pentru citire si analiza. Tool-ul nu modifica spawn-urile si nu modifica hartile.

Aplicatia este gandita ca un editor conectat direct la server. Asta inseamna ca, dupa configurare, poti lucra direct pe fisierele serverului, fara sa tot copiezi fisiere manual intre server si PC.

Servere multiple

Aplicatia poate lucra cu mai multe servere individuale.

Puteti configura servere separate, de exemplu:

• Server 1
• Server 2
• Server 3
• Server 4
• Server 5
• Server 6

Fiecare server poate avea:

• host separat;
• port separat;
• user separat;
• parola separata;
• locatii diferite pentru fisierele de drop;
• locatii diferite pentru fisierele common/proto;
• locatii diferite pentru harti.

Asta ajuta daca aveti mai multe servere, mai multe instante sau environment-uri diferite, cum ar fi test, beta, live sau servere separate pentru proiecte diferite.

De ce live server si nu local

Tool-ul este gandit pentru lucru direct pe server, pentru ca asta este cel mai util in practica.

Daca lucrezi local, tot trebuie sa:

• iei fisierele din server;
• le editezi local;
• le urci inapoi;
• te asiguri ca ai luat ultimele versiuni;
• ai grija sa nu suprascrii ceva modificat de altcineva.

Cu varianta live server, fisierele sunt citite direct de pe server si modificarile se salveaza inapoi acolo.

Asta face tool-ul mai util pentru echipe. De exemplu, poti da executabilul unei persoane care lucreaza la gameplay/drop-uri, iar acea persoana poate modifica drop-urile din aplicatie, fara sa intre manual prin fisierele serverului.

Recomandarea mea este sa nu oferiti acces root. Folositi un user separat, cu permisiuni limitate strict pe fisierele necesare.

Pagina de Drop mobi permite editarea directa a fisierului mob_drop_item.txt.

Poti sa:

• cauti mob dupa nume sau VNUM;
• vezi group-urile existente pentru fiecare mob;
• adaugi group nou;
• stergi group-uri;
• adaugi sau stergi randuri de drop;
• cauti iteme dupa nume sau VNUM;
• vezi iconita itemului direct in editor;
• modifici itemul, cantitatea si sansa;
• setezi tipul de drop, cum ar fi drop normal sau drop la kill;
• salvezi modificarile inapoi in server.

Nu mai trebuie sa cauti manual VNUM-ul itemului sau al mobului. Selectezi din lista, iar tool-ul completeaza automat informatia necesara.

Editorul afiseaza itemele cu nume si iconita, nu doar cu VNUM. Asta face lucrul cu fisierele de drop mult mai rapid si mai sigur.

Tipuri de drop

In functie de structura folosita in fisier, poti lucra cu drop-uri normale sau alte tipuri de group-uri, precum drop la kill.

Aplicatia incearca sa pastreze structura fisierului cat mai curata si sa faca modificarile fara sa fie nevoie sa scrii manual fiecare linie.

Adaugare si eliminare mobi

Poti adauga drop pentru mobi noi sau poti elimina group-uri existente.

Mobii pot fi:

• mobi normali;
• bossi;
• mini bossi;
• pietre Metin;
• alte entitati definite in mob_proto.

Pagina de Drop cufere permite editarea fisierului special_item_group.txt.

Aici poti vedea si modifica ce iteme pica din cufere.

Sistemul afiseaza cuferele cu:

• nume;
• VNUM;
• iconita;
• lista de iteme continute;
• cantitate;
• sansa;
• modificari nesalvate.

Este util pentru serverele care au multe cufere, reward box-uri, event box-uri sau sisteme speciale de drop.

Poti verifica mai usor ce cufere exista, ce contin si daca itemele sunt configurate corect.

Pagina Mob Map este gandita pentru verificarea mobilor existenti pe hartile active ale serverului.

Aplicatia citeste fisierul map/index, unde sunt listate hartile active, apoi intra in fiecare folder de harta si verifica fisierele de spawn.

Fisiere citite:

• regen.txt
• regen00.txt
• regen00_1.txt
• boss.txt
• alte fisiere de tip regen*.txt sau boss*.txt

Parserul ia automat ultima coloana din fiecare linie, care reprezinta VNUM-ul mobului.

Pentru fiecare harta, tool-ul afiseaza:

• indexul hartii;
• numele hartii;
• numarul de mobi unici;
• numarul total de spawn-uri;
• cati mobi au drop;
• cati mobi nu au drop.

Mobii sunt afisati o singura data, chiar daca acelasi mob apare de mai multe ori in aceeasi harta, pe coordonate diferite.

Mobi cu drop / fara drop

In Mob Map, fiecare mob are un status vizual:

• bulina verde = mobul are drop configurat;
• bulina rosie = mobul nu are drop configurat.

Asta ajuta foarte mult cand vrei sa verifici rapid o harta si sa vezi ce mobi au drop si ce mobi nu au drop.

Este util mai ales pentru:

• harti noi;
• dungeon-uri;
• boss maps;
• event maps;
• metine;
• zone unde vrei sa verifici rapid daca toti mobii importanti au drop.

Boss, Mini Boss, Stone si mobi normali

Aplicatia foloseste datele din mob_proto pentru a identifica mai usor tipul mobilor.

Mobii de rank 4 si 5 sunt evidentiati ca Mini Boss si Boss, pentru ca de obicei sunt cei mai importanti la configurarea drop-urilor.

Astfel poti gasi mai rapid:

• bossii dintr-o harta;
• mini bossii;
• pietrele Metin;
• mobii normali.

Adaugare drop direct din Mob Map

Daca un mob dintr-o harta nu are drop, poti adauga drop direct din pagina Mob Map.

Flow-ul este:

1. alegi serverul;
2. intri in Mob Map;
3. alegi harta;
4. vezi mobii din harta;
5. gasesti un mob fara drop;
6. apesi pe adaugare drop;
7. se deschide un popup;
8. setezi tipul de drop si itemele;
9. salvezi;
10. modificarea apare automat si in pagina Drop mobi.

Mob Map functioneaza ca o extensie peste editorul de mob drop. Nu editeaza harta, ci te ajuta sa creezi mai rapid drop pentru mobii care exista deja in harti.

Sincronizare intre pagini

Aplicatia este gandita ca un editor continuu.

Daca modifici ceva in Drop mobi, modificarile raman in aplicatie pana salvezi.

Daca modifici ceva in Drop cufere, la fel.

Daca adaugi drop din Mob Map, acel drop apare si in Drop mobi.

Scopul este sa poti lucra intre pagini fara sa pierzi modificarile nesalvate.

Verificare si curatare fisiere

Tool-ul ajuta si la curatarea fisierelor de drop.

Daca exista probleme de structura, duplicate sau linii inutile, aplicatia incearca sa pastreze fisierele cat mai curate si usor de intretinut.

Ajuta mai ales cand fisierele au fost editate manual mult timp si au ramas probleme precum:

• linii duplicate;
• grupuri greu de urmarit;
• valori neuniforme;
• spatii sau linii goale inutile;
• iteme sau mobi greu de identificat doar dupa VNUM.

Fara restart server

Initial, aplicatia avea si functie de restart server prin SSH, folosita intern pentru dezvoltare.

Aceasta functie a fost eliminata din versiunea publica.

Motivul este simplu: tool-ul trebuie sa fie sigur pentru useri si sa ramana concentrat pe editarea fisierelor de drop, nu pe controlul serverului.

In cazul meu, am implementat separat sincronizare live ingame pentru listele de drop, ca sa nu mai fie nevoie de restart atunci cand modific drop la mobi, metine sau cufere.

1. Important: aplicatia trebuie publicata, nu doar build/run

Tool-ul este configurat sa fie generat ca executabil single-file doar prin profilul de Publish.

Pentru a genera varianta finala:

1. Deschideti solutia in Visual Studio.
2. Click dreapta pe proiectul RevengeArena.DropEditor, nu doar pe solution.
3. Apasati Publish.
4. Alegeti profilul de publish existent.
5. Dupa publish, executabilul final se gaseste in folderul de publish configurat.

Daca dati doar Build sau Start/Run din Visual Studio, nu se genereaza varianta finala single-file.

Executabilul publicat poate avea aproximativ 90-130 MB, in functie de cate iconite si asset-uri sunt incluse in aplicatie.

Dimensiunea este normala, pentru ca aplicatia include WinUI / Windows App SDK self-contained si fisierele necesare pentru afisarea iconitelor itemelor.

2. Unde este fisierul de configurare

Fisierul de configurare este:
El se afla in folderul aplicatiei / folderul de publish, in subfolderul Config.

Exemplu:
In acest fisier se configureaza serverele, datele de conectare si locatiile fisierelor folosite de tool.

Daca dupa publish nu vedeti folderul Config langa executabil, copiati folderul Config din proiect langa executabil sau verificati profilul de publish sa includa Config\servers.json.

3. Descarca si porneste aplicatia

Descarci tool-ul, il pui intr-un folder separat si pornesti executabilul publicat.

Aplicatia este gandita sa fie folosita direct cu serverul, deci trebuie configurate datele de conectare si locatiile fisierelor in Config\servers.json.

4. Configureaza serverele

In Config\servers.json trebuie completate datele serverului:

• host / IP server;
• port;
• user;
• parola;
• locatia fisierelor de drop;
• locatia fisierelor common/proto;
• locatia folderului de map;
• serverele active pe care vrei sa le folosesti.

Puteti avea mai multe servere configurate individual, de exemplu 6 servere diferite, fiecare cu path-urile lui.

Exemplu de fisiere/path-uri pe care tool-ul trebuie sa le gaseasca:

• mob_drop_item.txt
• special_item_group.txt
• item_names.txt
• item_proto.txt
• mob_names.txt
• mob_proto.txt
• item_list.txt
• map/index

5. Recomandare pentru item_proto, mob_proto si item_list

Cel mai bine este sa directionati aplicatia catre fisierele reale din server.

Recomandat este sa aveti in server si:

• item_proto.txt
• mob_proto.txt
• item_names.txt
• mob_names.txt
• item_list.txt

In mod normal, item_list.txt este fisier de client si nu este mereu pus in server.

Totusi, pentru tool este mult mai bine sa il puneti si in server, langa fisierele comune, ca aplicatia sa poata citi totul din acelasi loc. Asa evitati sa faceti drag and drop constant intre client si server.

Ideea este ca toate fisierele necesare sa fie server-connected, nu impartite intre client local si server, pentru ca tool-ul este gandit pentru lucru live pe server.

6. Configurarea iconitelor

In folderul aplicatiei exista folderul de assets/icons.

Acolo trebuie puse iconitele din client, exact cu structura/path-urile originale.

Tool-ul citeste item_list.txt, iar din acel fisier afla ce iconita trebuie folosita pentru fiecare item.

De aceea este important ca iconitele sa fie puse exact cum sunt in client, ca path-urile din item_list.txt sa corespunda.

Exemplu logic:

• item_list.txt spune ce icon are itemul;
• tool-ul cauta iconita in assets/icons;
• daca path-ul exista, itemul apare cu iconita in aplicatie.

Daca iconitele nu sunt puse corect, tool-ul poate afisa itemul fara iconita.

7. Recomandare pentru echipe

Daca vreti sa dati tool-ul unei persoane care se ocupa de gameplay/drop-uri, nu este recomandat sa ii dati acces root.

Cel mai bine este sa creati un user separat pe server, cu acces doar la fisierele necesare.

Ideea tool-ului este ca cineva poate modifica drop-urile din aplicatie, fara sa intre direct prin toate fisierele serverului si fara sa aiba acces complet la datele serverului.

Asta este unul dintre motivele pentru care aplicatia este gandita ca tool live server: poti da executabilul celor care lucreaza la gameplay, iar ei pot lucra mai controlat, doar prin interfata.

8. Salvarea modificarilor

Dupa ce modificati drop-uri, cufere sau adaugati drop direct din Mob Map, trebuie sa salvati modificarile din aplicatie.

Tool-ul va scrie modificarile inapoi in fisierele serverului.

Functia de restart server nu exista in versiunea publica.

Tool-ul este util pentru cei care lucreaza cu servere Metin2 si vor sa administreze mai rapid drop-urile.

Este util daca:

• ai multe harti;
• ai multe cufere;
• ai multi mobi si bossi;
• vrei sa vezi rapid cine are drop si cine nu;
• vrei sa eviti editarea manuala in fisiere;
• vrei sa vezi itemele cu iconite si nume, nu doar VNUM-uri;
• vrei sa reduci greselile de sintaxa;
• vrei un mod mai rapid de a organiza drop-urile pe server;
• lucrezi cu o echipa si vrei sa le dai acces la un tool, nu direct la fisierele serverului.

Limitari actuale

Aplicatia a fost dezvoltata rapid, in aproximativ doua zile, deci este posibil sa existe buguri sau mici probleme de interfata.

Momentan:

• interfata este doar in romana;
• codul este in engleza;
• anumite dropdown-uri si animatii din interfata mai pot fi imbunatatite;
• unele comportamente tin de WinUI 3 si vor fi curatate/rescrise mai bine pe viitor.

Dezvoltari viitoare

Pe viitor, vreau sa adaug functii precum:

• afisarea mobilor direct pe coordonate pe harta;
• vizualizare grafica pentru spawn-uri;
• posibilitatea de a adauga sau modifica spawn locations;
• interfata mai curata;
• dropdown-uri mai stabile;
• mai multe verificari automate pentru fisiere;
• suport mai bun pentru structuri diferite de servere.

Sistemul ramane gratuit si il voi dezvolta in continuare pentru comunitate.

Daca intampinati buguri, scrieti aici. Cand fac update-uri pentru versiunea mea, voi incerca sa repar si problemele raportate de voi.

Daca aveti sugestii utile pentru workflow, verificari, interfata sau functii noi, le puteti lasa aici.

Tool-ul este facut pentru a usura munca de dezvoltare si administrare a drop-urilor pe serverele Metin2, nu pentru a inlocui complet testarea in joc.