If you run a Metin2 private server, knowing how to edit item_proto is one of the most useful skills you can learn. This single file controls every weapon, piece of armor, and usable item that exists in your game world. Change it wrong and players see broken items, corrupted names, or even a crashed client. Get it right and you can add custom gear, rebalance stats, and build the exact experience you want.
Our team has worked with Metin2 serverfiles for years, and the item_proto question comes up on every forum we follow. Most existing guides cover one narrow problem, like fixing Chinese characters, but never the full workflow. This guide fixes that gap.
I will walk you through the entire process from opening the file to verifying your changes in-game. Whether you want to know how to edit item_proto for the first time or you need to troubleshoot encoding errors, you will find the answers here.
Table of Contents
What Is the item_proto File?
item_proto is a Metin2 game server configuration file that defines all items in the game. Every sword, shield, helmet, accessory, and consumable traces back to an entry in this file. It tells the server the item’s virtual number (vnum), display name, type, stats, attribute slots, and equipment flags.
Private server administrators edit item_proto to customize the item database. You can add new weapons, change damage values, modify armor defenses, or create entirely original items. Without editing this file, your server runs whatever defaults shipped with the serverfiles.
On most modern serverfiles you will find two related files: item_proto.txt (the readable version) and a compiled binary version packed inside the client. This guide focuses on the .txt version because that is what you actually edit before repacking.
Key Columns and What They Mean
Each line in item_proto represents one item, and the columns define its properties. Understanding these columns is the difference between confident editing and blind guesswork.
vnum is the unique ID number for the item. The client uses this to match the entry to a 3D model and icon.
itemname is the in-game display name. On Korean-origin serverfiles this often contains Chinese characters, which is where encoding problems begin.
type and subtype define the item category. Type tells the engine whether the item is a weapon, armor, or consumable. Subtype narrows it down further, like sword versus bow.
attrtype and attrvalue control bonus attribute slots. These are the stones and bonuses players see when they inspect gear.
wearflag determines where the item equips. A value of 1 might mean body armor, while a different value maps to helmet or boots.
immuneflag sets whether the item can be dropped, traded, or sold. Getting this wrong can accidentally let players delete untradeable quest items.
Required Tools and Software
You have three main options for editing item_proto, and each has trade-offs. Picking the right one depends on how comfortable you are with raw data.
Notepad++ is the most popular choice for experienced developers. It opens large files quickly, supports tab-separated values out of the box, and lets you search and replace across thousands of lines. The downside is that you see raw column data with no formatting, which makes spotting errors harder.
Excel (or LibreOffice Calc) is better for beginners because it lays out columns visually. You can sort, filter, and edit thousands of items at a glance. The catch is that Excel aggressively reformats numbers, turning values like 12-05 into dates. I cover the fix for this below.
Web-based Proto Editors like the Metin2 Tools proto editor are the newest option. They handle encoding for you, validate column counts, and export clean files. They are ideal if you are new, but you need a stable internet connection and trust in a third-party tool.
For most server admins I recommend keeping both Notepad++ and Excel available. Use Excel for bulk edits and Notepad++ for targeted fixes.
Always Back Up item_proto Before Editing
Before you change a single value, make a backup copy of your item_proto.txt file. I keep two backups: one in the same folder with a date suffix and one on a separate drive. If an edit corrupts the file, you can restore in seconds instead of rebuilding 40,000 lines by hand.
This step sounds obvious, but it is the single most skipped practice in the Metin2 community. Every forum thread about broken servers traces back to someone who edited without a backup.
How to Edit item_proto Step by Step
Here is the complete workflow I use every time I need to edit item_proto for a Metin2 server. Follow these steps in order to avoid the most common mistakes.
Step 1: Locate your item_proto.txt file inside your serverfiles directory. Copy it to a safe backup location before doing anything else.
Step 2: Open the file in Notepad++ first. Take a moment to confirm the encoding by checking the bottom-right corner of the editor. You should see either ANSI or UTF-8. Note which one it is.
Step 3: If you plan to use Excel, open a blank spreadsheet first. Select all cells with CTRL+A, right-click, choose Format Cells, and set every cell to Text. This prevents Excel from converting vnum values into dates.
Step 4: Import the item_proto.txt file into Excel using the Text Import Wizard. Choose Tab as the delimiter so each column lands in its own cell. Verify that the vnum column shows full numbers, not scientific notation.
Step 5: Make your edits. To add a new item, copy an existing line with the same type (weapon, armor, accessory) and change the vnum, name, and stats to your new values. Keep the column structure identical to the original line.
Step 6: Export back to a tab-separated text file. In Excel, use Save As and select Text (Tab delimited). Open the saved file in Notepad++ to confirm the formatting survived the round trip.
Step 7: Replace the original item_proto.txt on your server with your edited version. Restart the game server and the client to load the new data.
Step 8: Log in and test. Spawn the item with a GM command, check that the name displays correctly, equip it to verify wearflags, and confirm the stats match what you entered.
Common Problems and Solutions
Most item_proto editing issues fall into a handful of categories. Here are the ones I see over and over in forum threads.
Excel converts numbers to dates: This happens when vnum or attribute values look like dates. The fix is to format all cells as Text before importing, as described in Step 3 above. If you already imported and saw the conversion, start over with a fresh backup.
Chinese characters display as gibberish: This is an encoding mismatch. Metin2 serverfiles often use EUC-KR or ANSI encoding for Korean and Chinese text. When you save the file as UTF-8, the character bytes shift and names corrupt. Open the backup in Notepad++, check the original encoding, and save your edited version with the same encoding selected.
Items show as question marks in-game: Usually means the client’s item names file does not match your server item_proto. Both sides need updating when you rename an item.
Client crashes on login: Almost always a column count mismatch. Each line in item_proto must have the exact same number of tab-separated fields. Open the file in Notepad++, use CTRL+F to find lines that look shorter or longer, and fix the missing or extra tabs.
Large file size limits: Some item_proto files contain over 40,000 entries. Excel handles this fine, but Notepad can choke. Stick with Notepad++ or Excel for files this size.
Advanced Tips for item_proto Editing
Once you are comfortable with the basics, a few advanced techniques speed up your workflow and reduce errors.
Use Excel filters to work on one item type at a time. Filtering by the type column lets you edit all weapons separately from all armor, which keeps large-scale changes organized.
Always verify attribute slots (attrtype and attrvalue) in pairs. Each attrtype must have a matching attrvalue, or the item behaves unpredictably when players add bonus stones.
Test new items on a local server before pushing them to your live environment. I run a private test instance where I can spawn items freely without affecting real players.
Frequently Asked Questions
How to edit item_proto in Metin2?
To edit item_proto in Metin2, back up the file first, open it in Notepad++ or Excel, make changes to item attributes like vnum, name, and stats, save with the correct encoding, then restart the server and client to apply the changes.
What software should I use to edit item_proto?
Notepad++ is best for targeted edits, Excel is best for bulk changes with text cell formatting enabled, and web-based Proto Editors are best for beginners who want validation built in.
How do I avoid Chinese character errors when editing item_proto?
Check the original file encoding in Notepad++ before editing. Metin2 serverfiles typically use EUC-KR or ANSI encoding. Save your edited file with the same encoding to prevent character corruption.
Why does Excel convert item_proto numbers to dates?
Excel auto-formats values that look like dates. Fix this by selecting all cells before importing, right-clicking, choosing Format Cells, and setting them to Text. This preserves the raw vnum values.
How do I add a new item to item_proto?
Copy an existing line that has the same item type you want, then change the vnum to a unique number, update the itemname, and adjust the stats. Keep the number of columns identical to avoid crashes.
Conclusion
Learning how to edit item_proto gives you full control over your Metin2 private server’s item system. The file is intimidating at first glance with its dense columns and thousands of lines, but the workflow comes down to a few repeatable steps: back up, open with the right tool, format cells correctly, edit carefully, save with proper encoding, and test in-game.
The most important habit I can pass along is to always work from a backup. Every horror story in the community starts with an unbacked-up edit. The second habit is to match encoding exactly, because Chinese character corruption is the single most reported problem across forums.
If you are new to this, start small. Edit one existing item, restart your server, and confirm the change appears correctly. Once that works, try adding a new item by copying and modifying an existing line. Build confidence gradually rather than overhauling your entire database on the first attempt.
With the tools and steps in this guide, you have everything you need to customize weapons, armor, and accessories for your players. Take it one edit at a time, verify each change, and your server’s item system will be exactly what you envision.