Flesh and Blood cards

• Overview & installation
• Card interfaces
• Enums
• Working with this project

5.0 breaking changes

• card.class has been deprecated in favor of card.classes in order to support multi-class cards (such as Emperor, Dracai of Aesir)
• Images now reference file names instead of complete URLs. This significantly reduces the bundle size of the library and adds flexibility for projects to use their own image hosting. See fabrary/images for an example of how to generate webp files of all cards.
  • card.defaultImageUrl is deprecated in favor of card.defaultImageName and card.specialImageName
  • card.images.url is deprecated in favor of card.images.name

Overview and installation

A library of all Flesh and Blood cards, available as a bundled TypeScript file with matching interfaces. Source data comes from the amazing the-fab-cube/flesh-and-blood-cards repository maintained by Tyler Luce - all credit goes to him, and all errors are probably added by me in this project 😅.

To install run npm i --save fab-cards.

Access the card data in your project:

import { cards } from "fab-cards";

cards.forEach((card) => {
  // do stuff with the card data
});

Card interfaces

Card contains all of the fields that are common across all card types - every card object will have data for these fields.

ActionCard extends Card and contains additional properties - although not every action card will have values for all fields

EquipmentCard extends Card and contains additional properties - although not every equipment card will have values for all fields

HeroCard extends Card and contains additional properties - although not every hero card will have values for all fields

MentorCard extends Card and contains additional properties - although not every mentor card will have values for all fields

ResourceCard extends Card and contains additional properties - although not every resource card will have values for all fields

TokenCard extends Card and contains additional properties - although not every token card will have values for all fields

WeaponCard extends Card and contains additional properties - although not every weapon card will have values for all fields

Image contains information needed to correctly display card images

Enums

Class

"NotClassed", "Generic", "Bard", "Brute", "Guardian", "Illusionist", "Mechanologist", "Merchant", "Ninja", "Ranger", "Runeblade", "Shapeshifter", "Warrior", "Wizard",

Format

"Blitz", "Clash", "Classic Constructed", "Commoner",

Fusion

"Earth", "Ice", "Lightning",

Rarity

"Token", "Common", "Rare", "Super Rare", "Majestic", "Legendary", "Fabled", "Promo",

Release

// Full sets
"Arcane Rising", "Crucible of War", "Dynasty", "Everfest", "History Pack 1", "Monarch", "Tales of Aria", "Uprising", "Welcome to Rathe",

// Hero/blitz decks
"Boltyn Blitz Deck", "Briar Blitz Deck", "Bravo Blitz Deck", "Chane Blitz Deck", "Classic Battles: Rhinar vs Dorinthea", "Dorinthea Hero Deck", "Ira Welcome Deck", "Katsu Hero Deck", "LeviaBlitzDeck", "Lexi Blitz Deck", "Oldhim Blitz Deck", "Prism Blitz Deck", "Rhinar Hero Deck",

// One-offs
"Promos",

Talent

"Not talented", "Draconic", "Earth", "Elemental", "Ice", "Light", "Lightning", "Royal", "Shadow",

Type

"Action", "Attack Action", "Attack Reaction", "Defense Reaction", "Equipment", "Hero", "Instant", "Mentor", "Resource", "Token", "Weapon",

ActionSubType, EquipmentSubType, ResourceSubType, TokenSubType, WeaponSubType

// ActionSubType
"Ally", "Attack", "Arrow", "Aura", "Item", "Landmark", "Non-Attack", "Trap",

//  EquipmentSubType
"Arms", "Chest", "Head", "Legs", "Off-Hand",

// ResourceSubType
"Gem",

// TokenSubType
"Ally", "Aura", "Item",

// WeaponSubType
"Axe", "Bow", "Claw", "Club", "Dagger", "Flail", "Gun", "Hammer", "Orb", "Pistol", "Scepter", "Scythe", "Staff", "Sword",

HandsRequired

"1H", "2H",

Hero

"Azalea", "Benji", "Boltyn", "Bravo", "Briar", "Chane", "Dash", "Data Doll", "Dorinthea", "Emperor", "Genis Wotchuneed", "Ira", "Iyslander", "Kano", "Kassai", "Katsu", "Kavdaen", "Kayo", "Levia", "Lexi", "Oldhim", "Prism", "Rhinar", "Ruu’di", "Shiyana", "Taylor", "Valda", "Viserai", "Yorick",

Keyword

"Arcane Barrier", "Battleworn", "Blade Break", "Blood Debt", "Boost", "Channel", "Charge", "Combo", "Crush", "Dominate", "Essence", "Freeze", "Fusion", "Go Again", "Heave", "Intimidate", "Legendary", "Mentor", "Negate", "Opt", "Phantasm", "Reload", "Reprise", "Specialization", "Spectra", "Spellvoid", "Temper", "Thaw", "Unfreeze",

Working with this project

Card data

• src/cards.tsv is the source of truth for all generated data. The data is managed in Google Sheets and sourced from the-fab-cube/flesh-and-blood-cards.

Data transformations

There are three steps involved in transforming the .tsv source data into typed .ts code - executed via npm run transform.

1. src/parser.ts reads from the .tsv file and converts the data into JavaScript objects (performing basic steps like converting comma-delimited lists into arrays)
2. src/mapper.ts takes the parsed card data and transforms it to match the interfaces in src/interfaces.ts
3. src/writer.ts creates .ts files containing the card information and all types

Bundling the library

To generate the distributed package code run npm run build after transforming the data.