RePoE

Repository of Path of Exile resources for tool developers.

Contains data about stats, mods, base items, gems and more. See the data
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:
  • Note: until PyPoE is updated again, RePoE only works with my fork of PyPoE (https://github.com/brather1ng/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
  • install: pip install -e .
  • install pre-commit: pre-commit install

You can now access the data using from RePoE import mods, characters which returns the current
dicts found in the files mods.json, characters.json

To update the data, in the RePoE/RePoE directory use python run_parser.py all.

Files

The RePoE/data folder contains the generated data in Json format. Each file has a
formatted and a compact version. The formatted versions complement their descriptions
in the RePoE/docs folder.

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 base_items.json and
  mods.json.
• 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.
• cost_types.json: Defines the resource cost types used in gems.json.
• active_skill_types.json List the active skill types used in gems.json.

Credits

• Grinding Gear Games for
  Path of Exile. The contents of all data files
  obviously belong to them.
• OmegaK2 for PyPoE.