LoL Meta Classes

This repository tracks LoL meta class information across versions.

Layout

• dumps/: meta dumps per version (e.g. 15.19.7151836.json).
• scripts/: helper scripts for reading/printing/importing meta.
• db/database.py: generated, diff-friendly representation of the merged schema.
• hashes/: name mappings for types and fields (used during generation).
• docs/: documentation, including detailed database format notes.

Database file

• The generated database is in db/database.py.
• It’s deterministic and optimized for Git diffs.
• See full documentation: docs/database.md

Regenerate database locally

python3 scripts/db_import.py db/database.py dumps/<version>.json
git diff -- db/database.py | cat

CI automation

• The "Sync LoL Meta Classes" workflow updates dumps/ when new data is available.
• After updating dumps, it regenerates db/database.py and commits any changes.
• Powered by the meta-sync tool (see crates/meta-sync/)

Inspect as C++-like structs

python3 scripts/dump_meta.py dumps/<version>.json > /tmp/meta.hpp

Tools

• meta-sync: Automated version discovery and metaclass extraction (crates/meta-sync/)
• dumper: Binary analysis tool for extracting metaclasses (crates/dumper/)
• db_import.py: Merges dumps into the database
• dump_meta.py: Converts dumps to C++-like format

Notes

• Unknown hashes remain as 0x... in outputs until mappings exist.