Repository of Path of Exile resources for tool developers.
Contains data about stats, mods, base items, gems and more. See the
folder for those files and the
docs folder for their documentation.
For the actual GGPK parsing, PyPoE is used. The code here just converts PyPoE's Python objects to JSON.
Developed to supply PoESkillTree with the game data information it requires. If you need other files converted, feel free to open an Issue or Pull Request for that.
Use as a Package
- Install Python 3.7 or later (PyPoE recommends Python 3.7) and Git
- Install PyPoE:
- Clone PyPoE and go into its folder
- Minimal install:
pip install -e .
- Full install:
pip install -e .[full](not required for RePoE)
- To be able to decompress GGG's bundle files, PyPoE expects an ooz.exe or libooz.dll in its path.
- Install RePoE
- Clone RePoE and go into its folder
pip install -e .
- install pre-commit:
You can now access the data using
from RePoE import mods, characters which returns the current
dicts found in the files
To update the data, in the
RePoE/RePoE directory use
python run_parser.py all.
Note that the file formats are not final, they may change at any time, e.g. when the format of files in the GGPK changes.
The following data is currently available:
stat_translations.json: Maps stat ids together with their values to human-readable text. This is the text that appears on items in-game.
stats.json: Describes stat ids. Defines whether they are local and whether they are aliased depending on main-hand or off-hand.
mods.json: Describes mod ids. Defines which items they can appear on and what stats with what values they have.
crafting_bench_options.json: Describes master crafting options. Defines which masters can craft them at which level on which items.
npc_master.json: Describes the master's signature mods and on which items they can appear.
gems.json: Describes skill gems and skill gem effects only provided by mods.
gem_tags.json: Simple object that contains all gem tags with their internal id as keys and their translation as value.
base_items.json: Describes base item types. Contains information applicable to all item types, e.g. inventory size, item class and tags, as well as attribute requirements and properties.
tags.json: Lists all possible item tags. These are the tags used in
item_classes.json: Defines the item class ids and the tags added to items when they are Shaper/Elder items.
essences.json: Describes essences. Defines the mods they spawn on items of the different item classes and general information like level and tier.
default_monster_stats.json: Describes the stat base values of monsters at specific levels.
characters.json: Describes the stat base values of the different player character classes.
flavour.json: Table containing the flavour text used throughout the game.
fossils.json: Describes fossils. Defines the mods they spawn, the tags they affect, and auxillary effects of the fossils.
mod_types.json: Describes the types of mods with sell price information and the tags relevant for fossil crafting.
cluster_jewels.json: Describes how cluster jewels can be generated and how they influence the passive tree.
cluster_jewel_notables.json: Lists the notable and keystone passive skills that can appear on cluster jewels.