Engin622/Metin2-Pack-Agent-Skills

# ⚔️ Metin2 Client Documentation Framework (Skills Library) Welcome to the most comprehensive technical documentation library for the Metin2 client. This repository contains a granular mapping of the game's internal file structures, interface logic, and asset hiyerarşisi. ## 🚀 Project Overview This project serves as a foundational reference for developers interested in: - **Client Modding:** Understanding how to modify `.py` scripts and `.epk/eix` packs. - **UI/UX Design:** Mapping the coordinate systems and element hiyerarşisi of the Metin2 interface. - **Automation:** Identifying memory structures and packet flows for stable tool development. - **Web Porting:** Bridging legacy binary assets with modern web environments (Three.js/Vite). ## 📂 Repository Structure The documentation is categorized into three main layers: ### 1. 🖥️ UIScript Layer (`/uiscript`) Detailed documentation for every interface window in the game: - **Inventory & Equipment:** Slot indices, grid structures, and costume systems. - **Communication:** Messenger, whisper, and guild interfaces. - **HUD & Radar:** Taskbar gauges, minimap logic, and floating notification buttons. - **Systems:** Trading, private shop building, refining (blacksmith), and fishing. ### 2. 🧠 Root & Logic Layer (`/root`) Mapping of the core Python engine: - **Client Boot:** How the `Index` file works and the entry points (`system.py`, `prototype.py`). - **Configuration:** MSM files (character settings), `colorinfo.py`, and `atlasinfo.txt`. - **Game Phases:** Intro (Login/Select/Empire) and Game loop architectures. ### 3. 📦 Asset & Pack Layer (`/assets`) Documentation for the binary pack files: - **Indoor/Outdoor:** Dungeon and map structures. - **NPC/Monster/PC:** 3D model hiyerarşisi and animation mapping. - **Effect & Sound:** Visual effect triggers and background music (BGM) structures. ## 🛠️ Usage for Developers Each directory contains a `skills.md` file that explains: - **Functionality:** What the component manages in-game. - **Hierarchy:** A Mermaid diagram showing the parent-child relationship of UI elements. - **Modification Tips:** Guidelines for safely editing coordinates or adding new features. - **Data Flow:** How data travels between the server and the client interface. ## 📜 Legal Disclaimer & License - **Ownership:** All original Metin2 game assets, binaries, and intellectual property belong to **Gameforge 4D GmbH** and **Ymir Entertainment Co., Ltd.** - **Documentation:** The technical analysis, mapping, and documentation provided in this repository are created by **Engin622**. - **License:** This documentation framework is provided under the **MIT License**. You are free to use, modify, and distribute the *documentation* itself, provided that you respect the intellectual property of the original game owners.