PoEDB
Item
Item
Vendor Recipes
Cluster Jewel
Oil
League
Gem
Gem
Skill Gems
Support Gems
Transfigured Gems
Unusual Gems
Gem Roadmap
Modifiers
Modifiers
Crafting
Horticrafting
Metamods
Quest
Quest
Passive Mastery
Ascendancy Classes
The Lord's Labyrinth
The Pantheon
Maps
Maps
Echoes of the Atlas
Siege of the Atlas
Atlas Tree Modifiers
Wraeclast Map
Tools
Tools
Timeless Jewel
PoB Code
FlavourText
Model
Patreon
TW 正體中文
CN 简体中文
KR 한국어
US English
JP Japanese
RU Русский
PO Português
TH ภาษาไทย
FR Français
DE Deutsch
ES Spanish
# GGPK ## GGPK schema ### Record Structures ``` struct GGPK { uint32 Length; char[4] Tag; // ="GGPK" uint32 Version; GgpkEntry[2] Entries; } struct GgpkEntry { uint64 offset; } ``` ``` struct FREE { uint32 Length; char[4] Tag; // = "FREE" Byte[Length-8] Data; } ``` ``` struct PDIR { uint32 Length; char[4] Tag; // ="PDIR" uint32 NameLength; uint32 TotalEntries; byte[32] SHA256Hash; wchar_t[NameLength] Name; DirectoryEntry[TotalEntries]; } struct DirectoryEntry { int32 entryNameHash; uint64 offset; } ``` ``` struct FILE { uint32 Length; char[4] Tag; // ="FILE" uint32 NameLength; byte[32] SHA256Hash; wchar_t[NameLength] Name; byte[reminder] Data; } ``` <a href="https://i.imgur.com/VRBetTX.png" data-lightbox="panel"></a> ### Sample Tree <a href="https://i.imgur.com/EP7QRal.png" data-lightbox="panel"></a> ### Reference Site | Description - | - [Path of Go](https://github.com/oriath-net/pogo) | Golang tools for reading PoE data files [LibGGPK3](https://github.com/aianlinb/LibGGPK3) | Windows GUI tool to view Content.ggpk and export [libbun](https://github.com/zao/ooz) | Ooz shared library (libooz.dll/liblibooz.so) for Oodle decompression and Bun library/tool with a C API suitable for FFI/interop - reads and extracts bundle contents from a Steam game directory or a PC Standalone GGPK. Tested on x64 Windows and Debian. <br>Original Ooz code by powzix/rarten, adapted into a library. ## Bundle schema [Bundle schema](Bundle_schema) ## Dat schema ``` struct DAT { uint32 rowCounts; Data[rowCounts] rows; REFERENCE refer; } struct Data { blob row; } struct REFERENCE { char[8]; // 0xBB * 8 blob reference; } ``` ### Data Export The game data does not have any official API, and only possible data can be analyzed from the game files. Almost all data is stored in .dat64 files within Content.ggpk. But they only have data, no headers. You can start with the .dat64 format, the [PoE dat schema](https://github.com/poe-tool-dev/dat-schema) project is the latest format. Or try to parse the .dat format from [PoE Dat Viewer](https://snosme.github.io/poe-dat-viewer/) yourself. [RePoE](https://github.com/lvlvllvlvllvlvl/RePoE) collects many common and processed .dat files and exports them to .json format. ### Reference Site | Description - | - [PyPoE](https://github.com/Project-Path-of-Exile-Wiki/PyPoE) | Collection of Python Tools for Path of Exile, mostly used by wiki [RePoE](https://github.com/lvlvllvlvllvlvl/RePoE) | Repository of Path of Exile resources for tool developers. [Poe Dat Viewer](https://snosme.github.io/poe-dat-viewer/) | Web-base Poe Dat Viewer [PoE dat schema](https://github.com/poe-tool-dev/dat-schema) | Source of truth schema for dat files. [Path Of Building Fork schema](https://github.com/PathOfBuildingCommunity/PathOfBuilding/blob/dev/src/Export/spec.lua) | Source of Path Of Building Fork schema ### PyPoe stable.py to spec.json ``` from PyPoE.poe.file.specification.data import stable from json import dump with open('D:/spec.json', 'w') as f: dump(stable.specification.as_dict(), f) ```