# Py4GW

**Py4GW** is a Python library designed to enhance the Guild Wars experience by providing tools for automation, scripting, and in-game interactions.
---

## Features

- **Agent Handling**: Manage agents (NPCs, enemies, allies) with ease.
- **Inventory Management**: Automate inventory-related tasks such as item handling and categorization.
- **Pathfinding and Navigation**: Built-in tools for pathfinding and movement.
- **Widgets**: Extensible widgets for customizing user experiences, including travel, titles, and more.
- **Event Hooks**: Hook into game events and create your own custom logic.
- **Multi-Account Support**: Efficiently manage multiple accounts simultaneously.
- **Lightweight and Modular**: Designed to be fast, modular, and easy to extend.

---

## 🚀 Getting Started

### **Prerequisites**
- Python 3.12 32Bits
- Guild Wars client

### **Installation**
1. Clone the repository:
   ```bash
   git clone https://github.com/apoguita/Py4GW.git
   ```
2. Navigate to the project directory:
   ```bash
   cd Py4GW
   ```
3. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

---

## 📂 Directory Structure
Py4GW/
├── Py4GW_python_files/            # Main directory containing all project files
│   ├── Addons/                    # Add-on extensions (e.g., GWBlackBOX.dll)
│   ├── DEMO/                      # Example scripts demonstrating library usage
│   ├── HeroAI/                    # Hero AI automation and logic
│   ├── Py4GWCoreLib/              # Core library for Guild Wars automation
│   ├── Widgets/                   # Widgets for in-game interactions
│   ├── resources/                 # Fonts, configs, and other resources
│   ├── stubs/                     # Type hint files for Python development
│   ├── build/, dist/              # Build and distribution directories
│   ├── Legacy code and tests/     # Archived code and test scripts
│   ├── Working Miscelaneous code/ # Experimental or temporary scripts
│   ├── Py4GW.dll                  # Main DLL for the project
│   ├── Py4GW.ini                  # Configuration file
│   ├── Py4GW_Launcher.py          # Launcher script
│   ├── Barebones_Example_module.py # Minimal example script
│   └── requirements.txt           # Dependency file


---

## 📥 How to Download

1. Go to the [Releases Page](https://github.com/apoguita/Py4GW/releases/tag/Official).
2. Download the files under "Assets."
3. Extract them to your preferred directory.

---

## 🤝 Contributing
We welcome contributions from the community! Here’s how you can get involved:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Commit your changes and push the branch.
4. Submit a pull request for review.