release Configuring Items, Weapons & Armor In Your Server

[Queen]

Hello everyone!

In this guide, we will provide detailed instructions on how to set up an item on your server.

Key Configurations:

Below is a list of configurations available for your items:

• This is the hidden content, please

  • Sign In
  • or
  • Sign Up

Requirements:

To proceed, you will need:

• An item already installed on the server that you wish to configure. This guide also covers how to install new items on your server (including weapons, armor, hairstyles, sashes, etc.).
• Access to the item_proto.txt file located in your server directory (using WinSCP). This file contains the configuration details for all the items in the game.

---

I. What is item_proto.txt?

The item_proto.txt file found in your server's directory at metin2/db/item_proto.txt holds the configuration data for every item.

In the first row, you will find the names of each column (such as ITEM, ITEM_NAME (KR), ITEM_TYPE, etc.), followed by a list of items and their respective configurations.

Info: Each column relates to a specific parameter, and each parameter is tab-separated.

Tip: For better readability, consider transferring the contents of your item_proto.txt into an Excel spreadsheet for ease of editing and fewer mistakes.

Upon server startup, the contents of this .txt file will be formatted into a database. In your database (via Navicat), navigate to the "item_proto" table to view all your items with their configurations.

Warning: Avoid making direct edits in the database; such actions are unnecessary and only complicate the process of item configuration.

It's important to note that your client should also have an item_proto file in the locale_xx pack (where xx represents your specific country code). This can be generated using the Dump Proto tool.

---

II. Parameter Breakdown

At the conclusion of this guide, we'll cover each parameter present in this file. Each parameter will be presented as follows:

Local Name (TXT Column Name / Database Column Name)

1. Vnum (ITEM / Vnum)

   This is the unique identification number (or ID) for your item, used with the GM /i command. Certain items are controlled by the server through their vnum; changing the vnum may introduce bugs, particularly for hardcoded items. The vnum for weapons and armor must be limited to below 65536.

   Warning: Ensure that the VNUM matches what is recorded in item_names.txt and the implementation of client-side items.

2. (ITEM_NAME(KR) / name)

   This name is required by various server files (notably for drop configurations) and can be chosen at your discretion.

3. (ITEM_TYPE / type) and (SUB_TYPE / subtype)

   These attributes are critical, so verify that they are configured correctly!

   Type and Subtype should be structured as follows:

   • TYPE: Name of the Type
     • SUB_TYPE: Name of the SubType

   In the ITEM_TYPE column, insert the TYPE, and in the SUB_TYPE column, specify the relevant SUB_TYPE.

   For example, to add daggers, you would select ITEM_TYPE as ITEM_WEAPON and SUB_TYPE as WEAPON_DAGGER:

   This is the hidden content, please Sign In or Sign Up

4. (SIZE / size)

   This indicates the number of squares occupied by your item. For instance, daggers use 1 square, bows use 2 squares, while two-handed swords occupy 3 squares.

5. (ANTI_FLAG / antiflag)

   Antiflags restrict the use of items.

   Here’s a list of antiflags:

   • This is the hidden content, please

     • Sign In
     • or
     • Sign Up

   Tip: You can combine several antiflags by separating them with |.

6. (FLAG / flag)

   Flags expand the functionality of your items.

   Examples of flags include:

   • This is the hidden content, please

     • Sign In
     • or
     • Sign Up

7. (ITEM_WEAR / wearflag)

   The wearflag specifies where the item can be equipped.

   Below is the list:

   • This is the hidden content, please

     • Sign In
     • or
     • Sign Up

8. (IMMUNE / immune)

   This identifies any special effects that your item can resist:

   • This is the hidden content, please

     • Sign In
     • or
     • Sign Up

9. (GOLD / gold)

   Represents the price the merchant charges players.

   Note that prices are tripled for players from a different empire than the merchant.

10. (SHOP_BUY_PRICE / buy_price)

This represents the price players will get when selling to merchants. The selling price is automatically divided by 3 and is subject to a 3% tax, resulting in a final sale price of approximately 32.333%.

11. Vnum post-refinement (REFINE / refine_vnum)

    This is the Vnum for the item after refinement by a blacksmith. Input 0 if you don’t intend to upgrade the item.

12. (REFINESET / refine_set)

    Specifies the material required to refine an item. This value must correspond to an entry in your refine_proto table within your database.

13. (MAGIC_PCT / magic_pct)

    Indicates the percentage chance of receiving a bonus or more when creating an item.

14. (LIMIT_TYPE0, LIMIT_TYPE1 / limittype0, limittype1)

    These parameters specify the requirements needed to utilize the item, such as:

• LIMIT_NONE: No restrictions
• LEVEL: Minimum level required

15. Values of limitations (LIMIT_VALUE0 et LIMIT_VALUE1 / limitvalue0 et limitvalue1)

    For each limitation listed in the previous column, you must specify a corresponding value.

16. Item bonus (ADDON_TYPE0 à ADDON_TYPE2 / applytype0 à applytype2)

    These columns represent potential bonuses for your item, applicable to equipment, stones, hairstyles, and other items.

17. Power of bonus (ADDON_VALUE0 à ADDON_VALUE2 / applyvalue0 à applyvalue2)

    Assign a value to each bonus indicated in the previous column.

18. Values (value0 à value5 / value0 à value5)

    These depend on the type of your items.

For Weapons:

• Value1: Minimum magic attack
• Value2: Maximum magic attack

For Armors/Helmets/Shields/Boots:

• Value1: Defense
• Value3: ShapeIndex (specific to armor)

19. Number of free spaces (SOCKET / socket_pct)

    This allows you to define how many stones can be set within your item (maximum of 3).

20. Item with Average/Skill bonuses (ATTU_ADDON / addon_type)

    Place any value greater than 0 to trigger Average and Skill damage bonuses on your item.

21. Specular (SPECULAR / specular)

    Controls the brightness of your item; higher specular values lead to increased brightness (avoid going above 100).

22. Categories/Subcategories

    Not specified. It’s advisable to set this to 0.

---

By following this structured guide, you should now have a solid understanding of how to configure various items, weapons, and armor for your Metin2 server. Enjoy enhancing your game!