V1 card data fields explanation
allCards.json
file and all the set files have a
cards
field, which contains a list of card objects.
- abilities
A list of all abilities on this character card. For character-type cards, abilities are generally keywords, like 'Evasive' and 'Shift', and this field includes the ability name, its value if it has one, and its reminder text. For action-type and item-type cards, this field contains what the action does. For cards without abilities, this field doesn't exist - artist
The name(s) of the artist(s) that drew the art for this card - baseName
The main name of the card. For characters and locations, this is the character or location name without the subtitle. For other card types, this is the same as the fullName
field. See also thefullName
andsubtitle
fields - clarifications
Some cards have extra clarifications for how they work or interact with other cards. This field is a list of those clarifications. For cards without clarifications, this field doesn't exist. The text can contain newline characters - code
This field is the two-character code for this card that the official app uses internally when saving a deck. It is the base-62 version of the card ID (digits higher than 9 use lowercase a-z and then uppercase A-Z). See also the id
field - color
The name of the color of the card. One of Amber, Amethyst, Emerald, Ruby, Sapphire, Stee. Cards from Quest-type sets don't have a color, so for those, this field is an empty string - cost
How much Ink this card costs to play - effects
A list of all the effects this card has. Each entry in the 'effects' list is a dictionary with two values: - name
The name of this effect. This is always fully uppercase - text
The description of what the ability actually does
For cards without effects, this field doesn't exist - name
- enchantedId
For cards that have an Enchanted version, this field contains the ID of that Enchanted card. For other cards, this field doesn't exist. See also the nonEnchantedId
field - errata
Some cards have errata, correcting mistakes on the card, and/or improving phrasing. This field is a list of those corrections. For cards without errata, this field doesn't exist. The text can contain newline characters - flavorText
The flavor text at the bottom of a card. This has no gameplay effect, but does improve the feel of the card. For cards without flavor text, this field doesn't exist. The text can contain newline characters - fullIdentifier
The full identifier as displayed on the bottom-left of each card, for instance 9/204 • EN • 3
. The formatting may be different for promo cards. See also thenumber
andsetNumber
fields - fullName
The full name of the card. For characters and locations, this is the baseName
plus thesubtitle
, separated by a dash. For other card types this is the same as thebaseName
field. See also thebaseName
andsubtitle
fields - fullText
The entire main gameplay text on the card as printed, not split up into abilities or effects. Does not include the flavor text. This field always exists, but can be an empty string on cards without text. The text can contain newline characters - id
A unique number identifying the card. For the first set, this id is identical to the number
field; for subsequent sets, the id keeps counting up (so the first card of set 2 has an id one higher than the last card of set 1). The id is identical between different language versions of the same card - images
A dictionary with several URLs of card images. These images are the same ones as used in the official Disney Lorcana app.
The fields in this dictionary are:- full
The URL of the card image at full size, usually 1468 by 2048 pixels - thumbnail
The URL of the card image at thumbnail size, usually 367 by 512 pixels - foilMask
A mask of the full card image that the official Disney Lorcana app uses to draw the foil effect, usually 1468 by 2048 pixels. Not all cards have this field
Note: If the isExternalReveal
field exists and is set totrue
, this card isn't in the official app yet, so only the 'full' image field will be set - full
- inkwell
true
if this card is allowed to be put into the inkwell as ink, so if it has the extra decoration around the cost in the top left of the card, andfalse
otherwise - isExternalReveal
If this field exists and is true
, the data from this card didn't come from the official app, but the card image came from another official Ravensburger source. Practically, this means that theimages
field will probably only have thefull
URL set, and it will be in another format than usual. This field doesn't exist if the data for this card came from the official app - keywordAbilities
A list of the keyword abilities of this character card, without the reminder text. For keyword abilities with a value, like Shift X
orChallenger +X
, the list entry includes that value. For cards without keyword abilities, this field doesn't exist - lore
For character cards, this is the amount of lore this character earns for a player when they quest with it. For characters that can't quest, this value is 0. For location cards, this is the amount of lore this location card earns at the start of each turn. For other card types, this field doesn't exist - moveCost
For location cards, this is the amount of ink it costs to move a character to this location. For other cards, this field doesn't exist - nonEnchantedId
For Enchanted-rarity cards, this field contains the ID of the non-Enchanted version of the same card. For non-Enchanted-rarity cards, this field doesn't exist. See also the enchantedId
field - nonPromoId
Special versions of some cards are released at events or at other occasions, as promo versions. For these cards, this field points to the ID of the non-promo version of the same card. For other cards, this field doesn't exist. See also the promoIds
field - number
The number of the card inside its set, shown as number/totalCards
in the bottom left of the card and in thefullIdentifier
field. For 'Special'-rarity cards, this number is the promo number instead, so a set might have two cards with number 1, one Special and one non-Special. This doesn't necessarily mean the cards are related, for that see thepromoIds
andnonSpecialId
fields. For a unique card identifier, see theid
field - promoIds
Special versions of some cards are released at events or at other occasions, as promo versions. For cards that have such promo versions, this field has a list of IDs of those promo versions of this non-promo card. For cards without a promo version, this field doesn't exist. See also the nonPromoId
field - rarity
The rarity of this card. One of Common, Uncommon, Rare, Super Rare, Legendary, Enchanted, or Special (the latter is used for promos or other special releases) - setCode
A string representation of the set code, which is the set number for 'normal' cards, and Q1
for Illumineer's Quest cards. This is exactly how it's printed as the last part of the identifier at the bottom-left of each card.
This set code is also a key in the "sets" dictionary inside the "allCards.json" file, linking to the set name and other set data.
This field does not exist in the set-specific data files, since it doesn't make sense there. See also thesetNumber
field - setNumber
The number of the set this card is released in. For cards from Quest sets (f.i. Illumineer's Quest: Deep Trouble), this field does not exist
This field also does not exist in the set-specific data files, since it doesn't make sense there. See also thesetCode
field - simpleName
The full name like in the fullName
field, but simplified: without the dash between base name and subtitle (for character and location cards), without special characters like '!' and '.', and entirely in lower-case. Special versions of letters are simplified too (for instance: "Te Kā - The Burning One" has the simpleName "te ka the burning one"). Quotemarks in possessives ("captain colonel's lieutenant") and dashes between words ("minnie mouse wide-eyed diver") are kept, since that's related to basic spelling. This field should make it easier to implement this data in a search engine, since most people won't use the dash or other special characters when searching for a card, so you can match their query against this field. See also thefullName
field - story
The name of the story (movie, show, etc.) that the card is from or that it references - strength
The strength of a character card, so how much damage it does to another character during a challenge. For card types other than characters, this field doesn't exist - subtitle
The subtitle of a character or location card, which is a suffix to the baseName. For other card types, this field doesn't exist. See also the fullName
field - subtypes
A list of the subtypes of this card. For characters, this can have entries like Dreamborn
andPrincess
. For song actions, this contains 'Song'. The order of the list is the same as on the card. For cards without subtypes, this field doesn't exist - type
What kind of card this is. One of Action, Character, Item, Location - variant
Some cards have multiple variants that only have different art (for instance Dalmatian Puppy
has ID 436 to 440). These are differentiated by a letter after the card number (forDalmatian Puppy
, letters 'a' to 'e'). This field contains that letter. For cards without variants, this field doesn't exist. See also thevariantIds
field - variantIds
Some cards have multiple variants that only have different art (for instance Dalmatian Puppy
has ID 436 to 440). This field contains a list of the IDs of the other cards belonging to this variant. For cards without variants, this field doesn't exist. See also thevariant
field - willpower
The willpower of a character or location card, so how much damage it can take before it is discarded. For other card types, this field doesn't exist
Certain text fields (abilities
, clarifications
, effects
,
errata
, fullText
) can have special Unicode characters in them that resemble the game-specific icons as closely as possible:
-
⟳
(Unicode character U+27F3): Exert -
⬡
(Unicode character U+2B21): Ink (usually in activation costs) -
◊
(Unicode character U+25CA): Lore (usually used to indicate the lore gain when questing) -
¤
(Unicode character U+00A4): Strength -
⛉
(Unicode character U+26C9): Willpower -
◉
(Unicode character U+25C9): Inkwell (the decoration around the card cost), meant to symbolise whether the card is allowed to be put into your inkwell. The character isn't too similar to the actual card symbol, but it's the closest available -
•
(Unicode character U+2022): Bullet point that separates different subtypes, and is also used in lists on cards (for instance Maui's Fish Hook
, ID 568)