ItemType.dat

This file is loaded when the client starts. It defines every item in the game such as equipment, weapons, consumables, mounts, soul/purification, garments, crafting materials, and more.

Records in itemtype.dat are the default values for the item, MsgItemInfo can be used to supply some of the dynamic values (such as the socketed gems, expiration time, durability and more)

See Item ID for the full breakdown of how Item IDs encodes information such category, weapon type, item level & quality for equipment.

Table of Contents

• Patch 5517

Patch 5517

In Patch 5517, this file is encrypted with TQ File Cipher with seed: 9527 (0x2537).

File Format

After decryption, the file is plain-text with an item record-per-line. Each field is separated by @@ and ends with a trailing @@\r\n.

~ is used as space characters and backticks (`) used as apostrophe in fields such as item name and description.

Record Structure

Parsing Script (To CSV)

You must first decrypt itemtype.dat using TQ File Cipher with seed: 9527 (0x2537). Then you can use this python script to parse the file and output it as a CSV file.

Pass the decrypted itemtype.dat path as the first arg & it will output a csv called itemtype.csv. This script has no error handling, checks or dependencies as it is intentionally kept minimal for readability.

Example: python3 itemtype_decode.py itemtype_decrypted.dat

import csv, sys

# NOTE: This script has only been tested on client 5517 itemtype.dat. Other patches may have a different amount of fields so this script will not work
FIELDS_PATCH_5517 = [
    "id", "name", "req_profession", "req_weaponskill", "req_level", "req_sex",
    "req_force", "req_speed", "req_health", "req_soul", "monopoly", "weight",
    "price", "id_action", "attack_max", "attack_min", "defense", "agility",
    "dodge", "life", "mana", "durability", "durability_limit", "identified",
    "gem1", "gem2", "magic1", "magic2", "n_amount", "data", "magic_atk",
    "magic_def", "atk_range", "atk_speed", "fray_mode", "repair_mode", "type_mask",
    "emoney_price", "emoney_bound_price", "expiry_time", "soul_atk_1", "soul_atk_2",
    "soul_def_1", "soul_atk_3", "soul_def_2", "soul_atk_4", "soul_def_3",
    "max_stack_size", "elem_res_metal", "elem_res_wood", "elem_res_water",
    "elem_res_fire", "elem_res_earth", "item_type", "description",
    "quality_color", "dragonsoul_phase", "dragonsoul_req", "crop_quality",
]

input_path  = sys.argv[1]
output_path = sys.argv[2] if len(sys.argv) > 2 else "itemtype.csv"

# Some items have chinese characters (gbk encoding) & mark unknown characters with '?'
with open(input_path, "r", encoding="gbk", errors="replace") as f_in, \
     open(output_path, "w", newline="", encoding="utf-8") as f_out:

    writer = csv.writer(f_out)
    writer.writerow(FIELDS_PATCH_5517)
    skipped = 0
    rows_extracted = 0

    for line in f_in:
        line = line.strip()
        if not line:
            continue
        parts = line.split("@@")
        if parts[-1] == "":
            parts = parts[:-1]
        if len(parts) != len(FIELDS_PATCH_5517):
            skipped += 1
            continue
        writer.writerow(parts)
        rows_extracted += 1

    if skipped > 0:
        print(f"Warning: {skipped} rows were skipped as they had an incorrect amount of fields.")

print(f"Completed {rows_extracted} extracted from {input_path} to {output_path}")