Gundam Card Game Importer Technical Overview
The Gundam importer fetches card data from TCGCSV (category 86) and produces cards + printings with TCGplayer product IDs attached. It extends BaseImporter and reads its catalogue through TcgCsvService, mirroring the Dragon Ball Super: Fusion World importer.
Data Sources
| Source | Role | Data Provided |
|---|---|---|
| TCGCSV | Primary | Groups (sets), products, attributes, images, TCGplayer product IDs, and pricing (category 86) |
TCGCSV category 86 is a clean Gundam-only catalogue — every group belongs to Gundam, so the importer needs no group filtering. Card and pricing data are both read from the ProductsAndPrices.csv export for the category.
Expansion = Group Mapping
Each TCGCSV group maps directly to a CardNexus expansion. The expansion releaseDate comes from group.publishedOn, and the set code is derived (and de-duplicated) from the group.
Product Model
Card-level attributes parsed from the TCGCSV product extended data:
| Attribute | Notes |
|---|---|
color | Card color |
type | Card type (unit, pilot, command, base, resource, etc.) |
level | Deployment level |
cost | Resource cost |
attackPoints | AP |
hitPoints | HP |
traits | Trait list |
linkCondition | Pilot/unit link condition |
Printing-level attributes:
| Attribute | Notes |
|---|---|
rarity | Includes the + / ++ parallel rarities |
finishes | Standard, Holofoil (GundamFinish) |
rulesText | Printed rules text |
Finishes
Gundam has a simple two-finish model, derived from the TCGCSV price subTypeName:
Finish (GundamFinish) | Source (price subTypeName) | Global CardFinish |
|---|---|---|
| Standard | Normal | STANDARD |
| Holofoil | Holofoil | HOLOFOIL |
The game→global mapping is by exact string identity.
Import Flow
Pricing
TCGplayer category 86 is wired in tcg-csv.service.ts and tcgplayer-importer.ts, and getGameFinishValues maps Gundam to its Standard/Holofoil finishes.
TCGplayer only — Cardmarket is not wired for Gundam, and there is no Cardmarket marketplace for the game. There is no cardMarketPriceImporter entry, no Cardmarket idGame, and no entry in the Cardmarket-only mappings (e.g. game-code-mapping.ts, cardmarket-image.ts). Pricing flows exclusively from the TCGplayer importer.
Code Locations
| Component | Location |
|---|---|
| Importer | packages/games/game-importer/src/gundam-importer.ts |
| Importer internals | packages/games/game-importer/src/gundam/ |
| Game config | packages/games/game-configuration/src/lib/games/gundam/gundam.game.ts |
| Types | packages/games/game-configuration/src/lib/games/gundam/gundam.types.ts |
| TCGCSV category config | packages/games/game-importer/src/lib/tcg-csv/tcg-csv.service.ts — category 86 |
| Price importer config | packages/games/price-importer/src/tcgplayer-importer.ts — category 86 |