# Find a specific item sword = item_proto.get(10) if sword: print(f"Item 10: name=sword.get('name'), price=sword.get('price')")
def add(self, entry: ProtoEntry) -> None: """Add or replace an entry.""" self.entries[entry.vnum] = entry
def list_items_by_type(self, item_type: str) -> List[int]: """List all vnums with a given type.""" result = [] for vnum, entry in self.proto.entries.items(): if entry.get("type") == item_type: result.append(vnum) return result Example usage if name == " main ": # Load item proto item_proto = ProtoFile("item_proto.txt")
def get_item_name(self, vnum: int) -> Optional[str]: """Get localized name from item proto (assumes 'name' field).""" entry = self.proto.get(vnum) return entry.get("name") if entry else None
# Modify an item if sword: sword.set("price", "5000") sword.set("add_speed", "10") item_proto.save("item_proto_modified.txt")
def save(self, path: Optional[Union[str, Path]] = None) -> None: """Save quest script.""" out_path = path or self.path out_path.write_text(self.content, encoding='utf-8') class ItemManager: """High-level item management using ProtoFile.""" def (self, proto_path: Union[str, Path]): self.proto = ProtoFile(proto_path)
def _rebuild_content(self): """Rebuild full script content from blocks.""" self.content = "\n\n".join([f"name\ncontent" for name, content in self.blocks.items()])
def save(self, path: Optional[Union[str, Path]] = None) -> None: """Save proto file back to disk.""" out_path = path or self.path with open(out_path, 'w', encoding='utf-8') as f: for entry in self.entries.values(): f.write(entry.to_line() + "\n") class QuestScript: """Simple representation of a Metin 2 quest script.""" def (self, path: Union[str, Path]): self.path = Path(path) self.content = self.path.read_text(encoding='utf-8', errors='ignore') self.blocks = self._extract_blocks()
def remove(self, vnum: int) -> None: """Remove entry by vnum.""" self.entries.pop(vnum, None)
def get(self, name: str) -> Optional[str]: """Get field value by name.""" for f in self.fields: if f.name == name: return f.value return None
def __repr__(self): return f"ProtoField(self.name=self.value)" class ProtoEntry: """Represents one entry (one line) in a proto file.""" def (self, vnum: int, fields: List[ProtoField]): self.vnum = vnum # Unique ID self.fields = fields # List of ProtoField objects
It focuses on , modularity , and extensibility , allowing you to work with game data in Python objects instead of raw text files. 📦 metin2lib – Python Library for Metin 2 """ metin2lib - A Python library for working with Metin 2 game data files. Supports proto files (item, mob, skill, etc.), quest scripts, and more. """ import re from pathlib import Path from typing import List, Dict, Any, Optional, Union
def __repr__(self): return f"ProtoEntry(vnum=self.vnum, fields=len(self.fields))" class ProtoFile: """Represents a .txt proto file (item_proto, mob_proto, etc.).""" def (self, path: Union[str, Path]): self.path = Path(path) self.entries: Dict[int, ProtoEntry] = {} self._parse()
def replace_block(self, state: str, new_content: str) -> None: """Replace a state block.""" old_block = f"state state" if old_block in self.blocks: self.blocks[old_block] = new_content self._rebuild_content()
# Use high-level manager manager = ItemManager("item_proto.txt") usable_items = manager.list_items_by_type("USE") print(f"Usable items: usable_items[:5]...")
# Find a specific item sword = item_proto.get(10) if sword: print(f"Item 10: name=sword.get('name'), price=sword.get('price')")
def add(self, entry: ProtoEntry) -> None: """Add or replace an entry.""" self.entries[entry.vnum] = entry
def list_items_by_type(self, item_type: str) -> List[int]: """List all vnums with a given type.""" result = [] for vnum, entry in self.proto.entries.items(): if entry.get("type") == item_type: result.append(vnum) return result Example usage if name == " main ": # Load item proto item_proto = ProtoFile("item_proto.txt")
def get_item_name(self, vnum: int) -> Optional[str]: """Get localized name from item proto (assumes 'name' field).""" entry = self.proto.get(vnum) return entry.get("name") if entry else None
# Modify an item if sword: sword.set("price", "5000") sword.set("add_speed", "10") item_proto.save("item_proto_modified.txt")
def save(self, path: Optional[Union[str, Path]] = None) -> None: """Save quest script.""" out_path = path or self.path out_path.write_text(self.content, encoding='utf-8') class ItemManager: """High-level item management using ProtoFile.""" def (self, proto_path: Union[str, Path]): self.proto = ProtoFile(proto_path)
def _rebuild_content(self): """Rebuild full script content from blocks.""" self.content = "\n\n".join([f"name\ncontent" for name, content in self.blocks.items()])
def save(self, path: Optional[Union[str, Path]] = None) -> None: """Save proto file back to disk.""" out_path = path or self.path with open(out_path, 'w', encoding='utf-8') as f: for entry in self.entries.values(): f.write(entry.to_line() + "\n") class QuestScript: """Simple representation of a Metin 2 quest script.""" def (self, path: Union[str, Path]): self.path = Path(path) self.content = self.path.read_text(encoding='utf-8', errors='ignore') self.blocks = self._extract_blocks()
def remove(self, vnum: int) -> None: """Remove entry by vnum.""" self.entries.pop(vnum, None)
def get(self, name: str) -> Optional[str]: """Get field value by name.""" for f in self.fields: if f.name == name: return f.value return None
def __repr__(self): return f"ProtoField(self.name=self.value)" class ProtoEntry: """Represents one entry (one line) in a proto file.""" def (self, vnum: int, fields: List[ProtoField]): self.vnum = vnum # Unique ID self.fields = fields # List of ProtoField objects
It focuses on , modularity , and extensibility , allowing you to work with game data in Python objects instead of raw text files. 📦 metin2lib – Python Library for Metin 2 """ metin2lib - A Python library for working with Metin 2 game data files. Supports proto files (item, mob, skill, etc.), quest scripts, and more. """ import re from pathlib import Path from typing import List, Dict, Any, Optional, Union
def __repr__(self): return f"ProtoEntry(vnum=self.vnum, fields=len(self.fields))" class ProtoFile: """Represents a .txt proto file (item_proto, mob_proto, etc.).""" def (self, path: Union[str, Path]): self.path = Path(path) self.entries: Dict[int, ProtoEntry] = {} self._parse()
def replace_block(self, state: str, new_content: str) -> None: """Replace a state block.""" old_block = f"state state" if old_block in self.blocks: self.blocks[old_block] = new_content self._rebuild_content()
# Use high-level manager manager = ItemManager("item_proto.txt") usable_items = manager.list_items_by_type("USE") print(f"Usable items: usable_items[:5]...")