Py4GW_Reforged

KO | EN

gitlite — search

#web #automation #sql #database #containers #pdf #framework #llm #bash #machine-learning

(★ 10)

No description available.

File Explorer

ZIP Download

Showing a partial file list — download the zip above to see everything.

- FUNDING.yml
- gMod LICENSE.txt
- gMod.dll
- - crossed swords.png
  - python_icon.ico
  - python_icon.jpg
  - python_icon_round.png
  - python_icon_round_20px.png
- - Font Awesome 6 Brands-Regular-400.otf
  - Font Awesome 6 Free-Regular-400.otf
  - Font Awesome 6 Free-Solid-900.otf
  - friz-quadrata-std-bold-587034a220f9f.otf
  - friz-quadrata-std-bold_italic-587033d6d4298.otf
  - friz-quadrata-std-italic-587033b2c95df.otf
  - friz-quadrata-std-medium-5870338ec7ef8.otf
- - Contrast.default.json
  - Guild_Wars.default.json
  - Minimalus.default.json
  - Negative.default.json
  - Smoke.default.json
- - missing_texture.png
  - travel_cursor.png
  - ui_button.png
  - ui_window_frame_atlas_no_titlebar.png
- README.md
- - bds_settings.ini
  - bds_stats.ini
- - Dajkah Inlet.py
  - The Shadow Nexus.py
- - .widget
  - elite_tome_farmer.py
  - tome_targets.py
- - Factions - We no Su.py
  - Yohlon Haven Sunspear Title Farm.py
- - Boreal_Sequential.py
  - Boreal_yield.py
  - BorealBot_Async_example.py
  - runbot (Sequential).py
  - Vaettir Async v2.4.py
  - VaettirBot (Sequential).py
  - VaettirBot (yield).py
  - YAVB 1.0 by Apo (Vaettir bot).py
- - Collect Mobstoppers.py
  - Every bit Helps.py
  - Turn In Rewards.py
- - AlcoholProc.py
  - AsuraLeveler.py
  - ConsPrinter.py
  - DeldrimorLeveler.py
  - DervCOFFarm.py
  - DervDustFarm.py
  - DervFeatherFarm.py
  - SimpleEnemyModelIdRecorder.py
  - SimpleLocationRecorder.py
  - VaettirMarksMods.py
  - VoltaicSpearTeamFarm.py
- - BASIC_TEST.py
  - ChatCommandBroadcast.py
  - Disable Camera Smoothing.py
  - Drop Unyielding Aura.py
  - Enter character on load.py
  - Inventory Plus rework.py
- Accept Material Salvaging.py
- Auto Combat example.py
- Boreal_bot_tutorial.py
- Chat Spam.py
- Coord_Logger.py
- Dynamical Dialog Tester3.py
- Get Bounty.py
- Global_Cache_tester.py
- Import_External_Libraries.py
- ItemCompare.py
.gitattributes
.gitignore
AGENTS.md
Barebones_Example_module.py
CLAUDE.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Showing a partial file list.

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

❤️ Support Py4GW

Hi everyone,

I'm Apo, the creator and lead developer of Py4GW.

Since 2024, Py4GW has grown from a small idea into an actively evolving open-source ecosystem. What started as a collection of tools has become a growing platform that includes Py4GW_Reforged, Py4GW_Reforged_Native, shared libraries, developer APIs, scripts, documentation, and everything needed to build on top of it.

This project is always moving forward.

Every week brings new ideas, new systems, API improvements, architectural changes, performance optimizations, reverse engineering work, compatibility updates, bug fixes, quality-of-life improvements, and new tools for developers and users alike. I'm always looking for ways to make the framework more capable, easier to use, and more enjoyable to build with.

While I'm the person leading the project and making the long-term technical decisions, Py4GW has become much more than just my work. It's a community of developers, creators, testers, contributors, and players who continue to push the project forward with ideas, feedback, code, documentation, and countless discussions.

My goal is to build the best open-source Guild Wars development framework I can, and to keep pushing it further with every release.

Everything is open source, and it always will be.

If Py4GW has helped you learn, build something you're proud of, saved you development time, or simply made Guild Wars more enjoyable, and you'd like to help support its continued evolution, you can do so through Ko-fi:

☕ https://ko-fi.com/apoguita

Please only donate if it's comfortably within your means. There is never any expectation or obligation to do so.

Whether you contribute financially, write code, report bugs, test new features, improve documentation, answer questions in Discord, or simply build awesome things with Py4GW, you're helping shape what this project becomes.

Thank you for being part of the journey.

Let's keep building.

Py4GW Reforged is a Python automation and scripting library for the Guild Wars
client. It gives you tools for automation, scripting, and in-game interactions,
from single-character helpers to full multi-account bots.

This is the current, actively developed version of Py4GW. It replaces the
original project at https://github.com/apoguita/Py4GW, which is now retired.

## How it works

Python does not run standalone here. It runs embedded inside the Guild Wars
process through `Py4GW.dll`, which is injected into the game by the launcher.
Most of this library is meant to execute in-client against a live game, not from
a plain interpreter.

The library reaches the game through two parallel paths:

- Bindings - `Py*` modules (`PyAgent`, `PyPlayer`, `PyImGui`, `PySystem`, and
  more) provided by the DLL. The `stubs/` folder holds the type stubs for them,
  and the wrapper classes in `Py4GWCoreLib/` build on top.
- Shared memory - live game state (agent positions, health, map and world
  context, and so on) read directly from the game process.

`Py4GW.dll` itself is built by the companion C++ project:
https://github.com/apoguita/Py4GW_Reforged_Native

## Features

- Agent handling - manage NPCs, enemies, and allies.
- Inventory management - automate item handling and categorization.
- Pathfinding and navigation - built-in movement tools.
- Widgets - extensible in-game UI for travel, titles, and more.
- Event hooks - react to game events with your own logic.
- Hero AI and combat automation - rule-driven combat and party control.
- Multi-account support - run and coordinate multiple accounts at once, with a
  shared-memory layer for cross-account coordination.
- Lightweight and modular - fast, modular, and easy to extend.

## Requirements

- Python 3.13.0 32-bit (other versions can crash the Guild Wars client):
  https://www.python.org/downloads/release/python-3130/
- A Guild Wars client.

## Getting started

1. Clone this repository:

git clone https://github.com/apoguita/Py4GW_Reforged.git

2. Enter the project directory:

cd Py4GW_Reforged

3. Get the injected DLL and launcher from the Releases page, and follow the
   setup instructions there:
   https://github.com/apoguita/Py4GW_Reforged/releases

## Project layout

Py4GW_Reforged/
    |-- Py4GWCoreLib/        Core library: the single source-of-truth layer
    |                        (Agent, Player, Map, Inventory, Skill, Party, ImGui,
    |                        Pathing, GlobalCache, shared memory, and more)
    |-- Py4GWCoreLib/HeroAI/ Hero AI automation and combat logic
    |-- Widgets/             In-game widgets (folder-based discovery)
    |-- Sources/             Larger script projects (ModularBot, tools, libraries)
    |-- Bots/ , bot_factory/ Bot implementations and scaffolding
    |-- py4gw_bridge/       Bridge stack for external tools and MCP integration
    |-- stubs/               Type stubs for the Py* binding modules
    |-- Assets/                       Shared runtime textures, fonts, styles, and branding
    |-- Examples/            Example scripts demonstrating library usage
    |-- docs/                Architecture notes and subsystem guides
    |-- Py4GW_Launcher.py            External launcher and injector
    |-- Py4GW_widget_manager.py      In-client widget bootstrap
    |-- py4gw_bridge/daemon.py , py4gw_bridge/cli.py , py4gw_bridge/mcp_server.py
    |                                Bridge daemon, operator CLI, and MCP adapter

## Entry points

- Py4GW_Launcher.py - the external launcher and injector UI.
- Py4GW_widget_manager.py - the in-client widget host. Widgets are discovered by
  folder: any folder under `Widgets/` containing a `.widget` marker is loaded.
- Bridge stack - lets external tools talk to injected clients: the in-client
  Bridge Client widget, the `py4gw_bridge/daemon.py` daemon, the `py4gw_bridge/cli.py`
  operator CLI, and the `py4gw_bridge/mcp_server.py` MCP adapter.

## Documentation

See the `docs/` folder for architecture notes and per-subsystem guides. `AGENTS.md`
is a good starting point for how the repository is organized.

## Contributing

Contributions are welcome:

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

------------------------------------------------------------------------------

Py4GW_Reforged

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Py4GW_Reforged

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README