Morg11 / aoc-mgz-db

Store and query recorded game metadata.

Age of Empires II Recorded Game Database

Store and query recorded game metadata.

Features

• Add by file, match, series, or bulk
• Supplement with platform player data
• Detect duplicates
• Detect player perspectives of the same match
• Detect incomplete matches
• CLI and API
• Compresses stored files (~5% of original size)
• Support for Voobly, Voobly China, and QQ AoC

Setup

• Install and configure a relational database supported by SQLAlchemy
• Determine database connection url

Environmental Variables

Avoid passing credentials and connection information while using the CLI by setting the following environmental variables:

• MGZ_DB: database connection url
• MGZ_STORE_PATH: file system path for storage

Optional:

• VOOBLY_KEY: voobly api key
• VOOBLY_USERNAME: voobly username
• VOOBLY_PASSWORD: voobly password

Relationship Diagram

Examples

Initialize

mgzdb reset

Adding

mgzdb add file rec.20181026-164339.mgz
mgzdb add match voobly 18916420
mgzdb add match qq 47851
mgzdb add series "135406198-NAC2Q1 GrandFinal F1Re vs BacT.zip"

When adding a series, the filename is used as the series name. Optionally prepend the name with a Challonge match ID.

Removing

mgzdb remove --file 1
mgzdb remove --match 1
mgzdb remove --series 1