- General Overview
- Approach to Reprints/Editions
- Approach to Versioning
- Changelogs and Contribution Credit
- Contributing
- Helper Scripts
- Further Documentation
- Current Status on CSV Representation of Translated Cards
- Projects Using This Data Set
This repo is intended as a comprehensive, open-source resource for representing all cards and sets from the Flesh and Blood TCG as JSON and CSV files.
The JSON files are the easiest format for general use, while the CSVs are meant to enable faster data entry while maintaining and contributing to this data set.
Please feel free to clone or fork the repo and generally use it for whatever projects you like. I put this together so the community doesn't have to keep re-entering the same data! I would absolutely appreciate any contributions if you notice any missing data or mistakes. :)
You can view the current JSON and CSV files through the web here.
This repo treats a unique card (name + pitch value) as 1 entity. A unique card can have multiple printings, foils, editions, etc, but is considered 1 entry in the data set.
A card's text and other data will always be based off the latest erratas and printings.
Similarly, a set is unique based on a setcode + name, and can have multiple editions, but is considered to be 1 entry within the data set.
To the best of my ability, I attempt to follow Semantic Versioning when releasing versions of this data set. You can find all released versions here.
I try to increment version numbers with this general logic:
- Major - The schema for the CSV / JSON was changed, large file organizational changes were made, etc.
- Minor - New data was added, new scripts were added or updated, etc. (Scripts receiving breaking changes is not always guaranteed to warrant a major patch bump, use with caution!)
- Patch - Errors in the data or helper scripts were fixed
If you'd like a stable experience, please use the main branch and pin a specific tagged version. I try to keep the develop branch as clean as possible, but even that is broken or has big changes in-flight from time to time. For bigger changes to the data set or during spoiler seasons, I spin off feature branches to work in. You are welcome to use them while I am working on them, but please be aware things can break at any time!
Unlike code packages, I do not go back and support past major/minor releases with bugfixes, so if you want the most up-to-date data, you will always need to be on the latest version, even if that version has breaking changes. The versioning system is purely to give you a heads up so that you don't update and find your project blowing up unexpectedly!
I include text changelogs for more information on when something changed and to help me remember what changed when I release new versions and need to write-up patch notes for them. The changelog for the actual data is at the root of the repo here, and the changelogs for the various scripts can all be found at the root of each script's folder.
I do my best to include the usernames of who submitted specific data updates or bugfixes (or who even just notified me of an issue). If I missed crediting you, please let me know so I can fix it! Conversely, if I've credited you and you wish for me to remove your username or update it, please also let me know!
This repo is primarily maintained by Tyler (luceleaftea), but it's been a community effort finding bugs, suggesting and making improvements, and adding new card data! If you'd like to contribute, please take a look at these instructions.
This project contains numerous helper scripts in order to help with data entry, generating JSON and HTML files, and spinning up PostgreSQL servers from the data. You can find more info on all of them here.
You can find the more info on the following topics at these links:
If you are interested in helping transcribe the History Pack 1 Black Label cards, please comment here to register your interest and I'll get in touch with you when efforts are ready to begin!
One of my favorite parts of maintaining this data set has been seeing all the community projects that have started using it. Here are all the projects that I know are using the data set! If your project is using it and I'm missing it, please leave an issue to let me know or open a PR to add your project to the list!