Skip to main content

Game Metadata

The character and stage data used across parry.gg comes from a public, community-sourced repository: parry-gg/game-metadata. Anyone can contribute by opening a pull request.

What's in the repo​

Structured JSON files describing characters and stages for each supported game, organized by game slug:

games/
└── [game-slug]/
    ├── characters/
    │   └── [character-slug].json
    └── stages/
        └── [stage-slug].json

Images are not committed to the repo — they're uploaded to the parry.gg CDN via a script in the repo, and the JSON files reference the resulting CDN URLs.

Finding the game slug​

We use the same game slugs as IGDB. The slug is the last segment of an IGDB game URL.

For example, Super Smash Bros. Melee lives at https://www.igdb.com/games/super-smash-bros-melee, so the slug is super-smash-bros-melee.

Contributing​

To add or update a character or stage:

  1. Fork parry-gg/game-metadata.
  2. Add a JSON file under games/[game-slug]/characters/ or games/[game-slug]/stages/ following the schema in the repo's README.
  3. Open a pull request.

All folder and file names use kebab-case (e.g. super-smash-bros-ultimate/, king-k-rool.json).

See the repo README for the full schema, naming conventions, image upload workflow, and contribution checklist.