Skip to content

Add scryfall_uuid extra-params to edition files#10938

Closed
phughk wants to merge 1 commit into
Card-Forge:masterfrom
phughk:fix-10413-edition-uuid-data
Closed

Add scryfall_uuid extra-params to edition files#10938
phughk wants to merge 1 commit into
Card-Forge:masterfrom
phughk:fix-10413-edition-uuid-data

Conversation

@phughk

@phughk phughk commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Problem

PR #10928 (the runtime CDN fetcher) needs a UUID for each card to construct non-rate-limited CDN URLs. Those UUIDs must be bundled with the game so they are available offline and without any API calls at startup.

What this PR contains

115,230 small JSON files under forge-gui/res/cdn_uuid/:

res/cdn_uuid/
├── 6ed/
│   ├── 1.json    {"de":"…","en":"…","fr":"…",…}
│   ├── 2.json
│   └── …
├── ltr/
│   └── …
└── … (1,041 sets)

Each file maps language codes to the Scryfall UUID for that printing. DFCs store [frontUuid, backUuid] when the faces differ.

How it was generated

Using the CLI tool from PR #10937 against Scryfall's default-cards bulk-data snapshot.

Size note

The files are plain JSON, typically ~100–300 bytes each. Total uncompressed ~20 MB; they compress well and are included in the existing res/ directory that ships with every Forge distribution.

Depends on

PR #10928 — the runtime code that reads these files. Without it, the files are inert.

@tehdiplomat tehdiplomat left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll have comments later, just want to make sure this doesn't get merged for now

@phughk phughk force-pushed the fix-10413-edition-uuid-data branch from 2e401af to 6eec563 Compare June 9, 2026 21:35
UUIDs stored in forge-gui/res/cdn_uuid/{scryfallCode}/{collectorNumber}.json.
Each file maps all available language codes to the CDN UUID for that print:

  {"de":"...","en":"...","es":"...","fr":"...","ja":"...","ko":"...","pt":"...","ru":"...","zhs":"...","zht":"..."}

Generated from Scryfall all_cards bulk export (all languages, all prints).
115,230 collector-number files across 1,041 sets; 62,559 with multiple
language entries.

Included with the assets zip. Optional for users — those who do not update
assets fall back to the rate-limited Scryfall API or cardforge server.
To regenerate after a Scryfall data update:

  java -jar forge-scryfall-uuid-map.jar --output-dir forge-gui/res/cdn_uuid

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@phughk phughk force-pushed the fix-10413-edition-uuid-data branch from 6eec563 to b39d24d Compare June 9, 2026 22:03
@phughk

phughk commented Jun 10, 2026

Copy link
Copy Markdown
Contributor Author

Closing and moving to forge extras

@phughk phughk closed this Jun 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants