Overview

Most commands work with resources such as expansions and cards. Each resource is represented by a separate JSON file with a unique file suffix per resource type.

Resource type	File suffix	File example
Expansion	expansion	international/base-set.expansion.json
Card	card	international/base-set/001.1-102.card.json
Card mapping	card-mapping	japan/star-birth/001.001-100.card-mapping.json
Image	image	international/base-set/001.1-102.image.json
TCG price	tcg-price	tcgplayer/international/base-set/001.1-102/standard-set-foil.en.mint.usd.tcg-price.json

All resources follow the TCG Collector card database conventions. These conventions are needed in order to understand how to create or edit resources.

A lot of commands require other resource files as an argument. As an alternative to creating your own resource files, the cms export command can be used to export various resources from TCG Collector if you have the proper access rights.

If you decide to manually create or edit resource files, it's recommended to run the appropriate analyze command in order to detect potential errors, e.g., analyze cards.