Aeonfront Card Assets

Canonical character artwork for 万世战线 Aeonfront. The repository keeps lightweight WebP images and full-resolution PNG sources together on main, with a generated card-to-file index.

Branches

• main is authoritative and contains webp/, hd/, validation scripts and generated indexes.
• webp is a compatibility split for older lightweight submodule consumers.
• hd is a compatibility split for older desktop packaging consumers.

New builds must not switch Git branches at runtime or during packaging. Use the pinned main tree and scripts/prepare-assets.mjs to stage only the required format into a build directory.

Index and validation

The default index command reads generated card definitions from the sibling character repository. A different path can be supplied through AEONFRONT_CARDS.

npm run build:index
npm run validate:assets
npm test
node scripts/prepare-assets.mjs --output=../build/card-assets
node scripts/prepare-assets.mjs --hd --output=../build/card-assets-hd

generated/card-assets.json maps every cardId, character UID, name, slug and image key to WebP, thumbnail and HD paths. generated/asset-report.json records missing mappings, fallbacks, unreferenced files, unsupported formats and duplicate binary content.

Adding artwork

Add ${characterName}.webp under webp/ and ${characterName}.png under hd/, preserving the exact character name used by the data repository. Rebuild the index and run validation. A fallback is permitted only when neither source format exists; existing art must never be replaced by a fallback.