/thronesdb-json-data

JSON-formatted data for ThronesDB deckbuilder

Primary LanguagePython

ThronesDB cards JSON data Build status

The goal of this repository is to store ThronesDB card data in a format that can be easily updated by multiple people and their changes reviewed.

Validating and formatting JSON

Using python >=2.6, type in command line:

./validate.py --verbose --fix_formatting

The above script requires python package jsonschema which can be installed using pip via pip install -U jsonschema.

You can also just try to follow the style existing files use when editing entries. They are all formatted and checked using the script above.

Description of properties in schemas

Required properties are in bold.

Cycle schema

  • code - identifier of the cycle. One single lowercase word. Examples: "core", "westeros", "war".
  • name - properly formatted name of the cycle. Examples: "Core Set", "Westeros Cycle", "War of the Five Kings Cycle".
  • position - number of the cycle, counting in chronological order. For packs released outside of normal constructed play cycles (such as draft packs), the special cycle with position 0 should be used. Examples: 1 for Core Set, 4 for War of the Five Kings Cycle.
  • size - number of packs in the cycle. Examples: 1 for big boxes, 6 for regular chapter pack cycles.

Pack schema

  • code - identifier of the pack. The acronym of the pack name, with matching case, except for Core Set. Examples: "Core" for Core Set, "TKP" for The King's Peace, "WotN" for Wolves of the North.
  • cycle_code - identifier of the cycle the pack belongs to. Must refer to one of the values from cycles' "code". Examples: "core" for Core Set, "westeros" for Westeros Cycle.
  • name - properly formatted name of the pack. Examples: "Core Set", "Wolves of the North", "The King's Peace".
  • position - number of the pack within the cycle. Examples: 1 for Core Set, 1 for Taking the Black from Westeros Cycle, 3 for For Family Honor from War of the Five Kings Cycle.
  • released - date when the pack was officially released by FFG. When in doubt, look at the date of the pack release news on FFG's news page. Format of the date is YYYY-MM-DD. May be null - this value is used when the date is unknown. Examples: "2015-10-08" for Core Set, "2015-12-09" for Taking the Black, null for unreleased previewed packs.
  • size - number of different cards in the pack. May be null - this value is used when the pack is just an organizational entity, not a physical pack. Examples: 120 for Core Set, 55 for most deluxe expansions, 20 for most chapter packs, null for assorted draft cards.

Card schema

  • claim - Plots only
  • code - 5 digit card identifier. Consists of two zero-padded numbers: first two digits are the cycle position, last three are position of the card within the cycle (printed on the card).
  • cost - Play cost of the card. Relevant for all cards except agendas and titles. May be null - this value is used when the card has a special, possibly variable, cost.
  • deck_limit
  • faction_code
  • flavor
  • illustrator
  • income - Plots only
  • initiative - Plots only
  • is_intrigue - Characters only
  • is_loyal
  • is_military - Characters only
  • is_power - Characters only
  • is_unique
  • name
  • octgn_id
  • pack_code
  • position
  • quantity
  • reserve - Plots only
  • strength - Characters only
  • text
  • traits
  • type_code - Type of the card. Possible values: "agenda", "attachment", "character", "event", "location", "plot", "title"

JSON text editing tips

Full description of (very simple) JSON format can be found here, below there are a few tips most relevant to editing this repository.

Non-ASCII symbols

When symbols outside the regular ASCII range are needed, UTF-8 symbols come in play. These need to be escaped using \u<4 letter hexcode>.

To get the 4-letter hexcode of a UTF-8 symbol (or look up what a particular hexcode represents), you can use a UTF-8 converter, such as this online tool.

Quotes and breaking text into multiple lines

To have text spanning multiple lines, use \n to separate them. To have quotes as part of the text, use \". For example, "flavor": "\"Winter is Coming.\"\n-Eddard Stark" results in following flavor text:

"Winter is coming."
-Eddard Stark

A Game of Thrones symbols

These can be used in a card's text section.

  • [baratheon]
  • [intrigue]
  • [greyjoy]
  • [lannister]
  • [martell]
  • [military]
  • [thenightswatch]
  • [power]
  • [stark]
  • [targaryen]
  • [tyrell]
  • [unique]

Translations

To merge new changes in default language in all locales, run the CoffeeScript script update_locales.

Pre-requisites:

  • node and npm installed
  • npm -g install coffee-script

Usage: coffee update_locales.coffee