release Guide To Implementing Weapons, Armor, Costumes & Items

[Queen]

Hello everyone!

Welcome to this detailed guide on how to successfully integrate new weapons, armor, costumes, and other items into your Metin2 server.

Requirements

• A Metin2 server with established access via WinSCP.
• A tool for unpacking your client files, such as EterManager, Eternexus, or EterPack Archiver.
• A TGA file for your item icon; feel free to use an existing one if needed.
• If adding an item with a 3D model (like weapons, armor, or costumes), make sure to have:
  • A .gr2 file corresponding to the 3D model of your item and the Granny Viewer tool to view this type of model.
  • One or more .dds or .tga files for the item's textures.

---

I. Client-Side Setup

1. Unpack Necessary Files:
   Start by utilizing your unpacker to extract the following files based on what you wish to implement:

   • locale_xx (where xx is your country code)
   • icon
   • item (for weapons and hairstyles)
   • root (for armor and hairstyles)
   • pc, pc2, and pc3 (for various armors; pc3 is for Lycan)

2. Add Your Icon:
   Within the unpacked icon directory, insert your TGA file for the item icon into icon/item.

   Note: If you do not have a .gr2 file (for a simpler item), you can skip directly to step 6.

3. Place Your .gr2 Files:
   Depending on the type of item you’re implementing, place your .gr2 files in the appropriate folders:

   • Weapons: item/weapon

   • Armors:

     • Male Warrior: ymir work/pc/warrior/
     • Female Warrior: ymir work/pc2/warrior/
     • Male Ninja: ymir work/pc2/assassin/
     • Female Ninja: ymir work/pc/assassin/
     • Male Sura: ymir work/pc/sura/
     • Female Sura: ymir work/pc2/sura/
     • Male Shaman: ymir work/pc2/shaman/
     • Female Shaman: ymir work/pc/shaman/
     • Wolfman: ymir work/pc3/

   • Hairstyles:

     • Male Warrior: ymir work/pc/warrior/hair/
     • Female Warrior: ymir work/pc2/warrior/hair/
     • Male Ninja: ymir work/pc2/assassin/hair/
     • Female Ninja: ymir work/pc/assassin/hair/
     • Male Sura: ymir work/pc/sura/hair/
     • Female Sura: ymir work/pc2/sura/hair/
     • Male Shaman: ymir work/pc2/shaman/hair/
     • Female Shaman: ymir work/pc/shaman/hair/
     • Wolfman: ymir work/pc3/hair/

   • Other Items: You can place these in any folder, but it's generally recommended to use item/etc/.

4. View Your .gr2 File:
   Open your .gr2 file using Granny Viewer. In the TextureList tab, you will find the path to your item's texture.

   

   Make sure to place your texture file exactly at the specified location, using the same name. For instance, in the provided screenshot, the texture should go into the weapon folder.

   Note: Step 5 is only necessary for armor, costumes, or hairstyles. If you are not implementing these, proceed directly to step 6.

5. Display Armor, Hairstyles, or Costumes:
   To do this, you will need to modify the .msm files located in the root pack. The specific file depends on the player’s class and gender:

   • Male Warrior: warrior_m.msm
   • Female Warrior: warrior_w.msm
   • Male Ninja: assassin_m.msm
   • Female Ninja: assassin_w.msm
   • Male Sura: sura_m.msm
   • Female Sura: sura_w.msm
   • Male Shaman: shaman_m.msm
   • Female Shaman: shaman_w.msm
   • Wolfman: wolf_m.msm

6. Generate the item_proto File:
   Now, generate the item_proto client file found in the locale_xx pack. The Dump Proto tool will allow you to create the proto client item from item_names.txt and item_proto.txt (from the server).

   Generate and replace the existing file in your client. Note: Complete the server-side setup (Part II) before proceeding with this step.

7. Link Vnum with Your Model and Icon:
   Within the item_list.txt in the locale_xx pack, add a new line formatted as follows:

7. WEAPON[TAB]icon/item/00010.tga[TAB]d:/ymir work/item/weapon/00010.gr2
       

   Breakdown of the line:

   • WEAPON: This can be changed as needed, serving as a reference for what your item is.
   • [TAB]: Use the tab key to separate the fields.
   • icon/item/00010.tga: Path to your TGA file (should that file not exist, a default icon will be used).
   • d:/ymir work/item/weapon/00010.gr2: Path to your .gr2 file. If left empty, the default item will be used. This is crucial for special weapons and items, but for armors, costumes, or hairstyles, leave this section out.

8. Repack Your Files:
   Finally, repack all your files, and your client-side setup should be complete.

---

II. Server-Side Setup

1. Access Your Server:
   Use WinSCP to connect to your server and navigate to the folder /usr/metin2/db (or your designated database folder). Here, you will find the item_names.txt and item_proto.txt files.

2. Edit item_names.txt:
   Add a new line with the Vnum for your item, followed by its display name. Format it like this:

2. Vnum[TAB]Item name
       

   Warning! Ensure that there is a tabulation between the Vnum and the item name. Remember, each Vnum must be unique.

   Note: The item_names.txt file lists all item names associated with their respective Vnums. Use it as a helpful resource.

3. Modify item_proto.txt:
   This file contains all information about your item (excluding the name). If the relevant line for your item is missing, create it based on existing lines.

   Warning! Pay special attention to key parameters, particularly the first (the Vnum, matching what's in item_names.txt), the third (the type), and the fourth (the subtype). For armors, costumes, and hairstyles, don't forget to specify the corresponding ShapeIndex value from the client side.

Congratulations! Your item is now fully integrated into your server!