ppoelzl / PyPoE

Collection of Python Tools for Path of Exile

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PyPoE

Collection of Python Tools for Path of Exile.

More detailed docs: http://omegak2.net/poe/PyPoE/

The docs are occasionally updated until I get a build bot up - however docs can also be manually built with Sphinx.

Build Status

Common Problems & Advisory

  • Install Python 3.7 for maximum compatibility:
    • UI: PySide2 currently supports versions 3.5, 3.6, 3.7 and 3.8
  • On Windows 10 machines there seems to a be bug in the Python installation that prevents arguments being passed to the command line interface; you can identify this issue if you get a "help" listing if you supplied more then 1 argument. See this on stack overflow for possible solutions

Overview

Parts:

  • Library toolkit for programmers (PyPoE/poe)
  • UI based on Qt for browsing the game files
  • CLI interface for extracting/exporting data (for the wiki, more TBD)

Resources

  • IRC Channel: freenode.net/#PyPoE
  • Discord: No official channel, but I can be contacted in #3rd-party-tool-dev in the /r/PathOfExile Discord

Important Notes

Alpha Stage:

  • Code structure and in particular the API may change at any time
  • Incomplete in many areas (check files and TODOs)
  • Tests still have to be written for a lot of things.
  • Many functions and classes are not yet fully documented

Dev branch:

  • Broken code may be committed occasionally to the dev branch

Quick Setup Guide

These instructions are for the current development version of PyPoE.

  • Install Python 3.7 & git
  • On Windows, make sure Python 3.7 and Python "Scripts" folder are in %PATH%
  • Checkout PyPoE with git
  • Go into the PyPoE folder
  • Minimum install: pip3 install -e .
  • Full install: pip3 install -e .[full]

Usage

  • UI: pypoe_ui
  • CLI: pypoe_exporter (follow the instructions)
  • API: check the individual files in PyPoE/poe/ or the docs http://omegak2.net/poe/PyPoE/

Credits - People

  • Grinding Gear Games - they created many of the file formats and Path of Exile obviously, so do not reuse their files anywhere without their permission and support them if you are able to :)
  • Chriskang and the original VisualGGPK2
  • chuanhsing (poedb) for helping with meaning of certain specification values and retrieving monster stats

Credits - Libraries

About

Collection of Python Tools for Path of Exile

License:Other


Languages

Language:Python 100.0%