Update numerical value schema to support ? and *

Author: fspoettel

README.md

@@ -74,6 +74,15 @@ The available tags are:
 These tags have been used in the past but are unused right now:
 - `st` => _Spell trait_, used to mark whether a card had bonded spells for Marie Lambeau, which is no longer relevant, but still part of the deckbuilding rules.
 
+## Numerical values
+
+Numerical values in the game can sometimes contain symbols such as `-` or `X`. Historically, consumers of this data expect these values to be `number | null`, so we have to use an enumeration to represent special characters. The following mappings are defined:
+- `0` and higher: literal integers.
+- `null`: `-`
+- `X`: `-2`
+- `*`: `-3`
+- `?`: `-4`
+
 #### Translations
 
 To merge new changes in default language in all locales, run the CoffeeScript script `update_locales`.

pack/side/blob_encounter.json

@@ -75,7 +75,7 @@
     {
         "back_name": "It Is Exposed!",
         "back_text": "<b>If this is the first time this act has advanced, read the following:</b>\n<blockquote><i>You've seen the anomaly's true heart. It lies beneath the surface of the ooze, pulsing with unseen power and guiding its myriad forms with alien hunger. You suspect this organ, whatever it may be, holds the secret to destroying the anomaly once and for all.</i></blockquote><hr><b>Regardless of how many times this act has advanced, read the following:</b>\n<blockquote><i>After hours of investigation, you believe that you have pinpointed the creature's heart. Due to the way it shifts throughout the surface of its all-encompassing body, you know it won't stay at its current location for very long. Then you'll have to track it down again...</i></blockquote>\nChoose any [[Oozified]] location. Spawn the set-aside Vulnerable Heart enemy at the chosen location.",
-        "clues": -2,
+        "clues": -3,
         "code": "85005",
         "double_sided": true,
         "encounter_code": "blob_epic_multiplayer",
@@ -680,7 +680,7 @@
         "enemy_evade": null,
         "enemy_fight": null,
         "faction_code": "mythos",
-        "health": -2,
+        "health": -3,
         "illustrator": "Guillaume Ducos",
         "is_unique": true,
         "name": "Subject 8L-08",

pack/side/coh_encounter.json

@@ -409,8 +409,8 @@
     "code": "82019",
     "encounter_code": "venice",
     "encounter_position": 19,
-    "enemy_evade": -2,
-    "enemy_fight": -2,
+    "enemy_evade": -4,
+    "enemy_fight": -4,
     "enemy_horror": 2,
     "faction_code": "mythos",
     "health": 3,

pack/side/mtt_encounter.json

@@ -673,7 +673,7 @@
         "victory": 1
     },
     {
-        "back_link": "87034b", 
+        "back_link": "87034b",
         "code": "87034",
         "encounter_code": "machinations_through_time",
         "encounter_position": 33,
@@ -702,7 +702,7 @@
         "victory": 1
     },
     {
-        "back_link": "87035b", 
+        "back_link": "87035b",
         "code": "87035",
         "encounter_code": "machinations_through_time",
         "encounter_position": 34,
@@ -845,7 +845,7 @@
         "victory": 1
     },
     {
-        "back_link": "87039b", 
+        "back_link": "87039b",
         "code": "87039",
         "encounter_code": "machinations_through_time",
         "encounter_position": 36,
@@ -915,7 +915,7 @@
         "victory": 0
     },
     {
-        "back_link": "87042b", 
+        "back_link": "87042b",
         "code": "87042",
         "encounter_code": "machinations_through_time",
         "encounter_position": 41,
@@ -953,7 +953,7 @@
         "enemy_fight": 3,
         "enemy_horror": 2,
         "faction_code": "mythos",
-        "health": -2,
+        "health": -3,
         "illustrator": "Helge C Balzer",
         "is_unique": true,
         "name": "Tyr'thrha",

pack/side/wog_encounter.json

@@ -18,7 +18,7 @@
         "back_name": "Reinforcements",
         "back_text": "If you are playing in Standalone Mode, add 1 [tablet] token to the chaos bag.\nShuffle the 2 set-aside Ethereal Entity enemies, the 3 Inevitable End treacheries, and the encounter discard pile into the encounter deck.\nIf this is the first agenda to advance to 1b, spawn the set-aside Hune-Stitched Herald enemy at the Athenaeum of the Empty Sky.",
         "code": "86002",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 2,
@@ -38,7 +38,7 @@
         "back_name": "Summoning of the Servitor",
         "back_text": "If you are playing in Standalone Mode, add 1 [tablet] token to the chaos bag.\nIf the Hune-Stitched Herald enemy is set-aside, shuffle it into the encounter deck.\nIf this is the first agenda to advance to 2b, spawn the set-aside The Inescapable Maw enemy at the Athenaeum of the Empty Sky.",
         "code": "86003",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 3,
@@ -58,7 +58,7 @@
         "back_name": "War is Over",
         "back_text": "If you are playing in Standalone Mode, add 1 [tablet] token to the chaos bag.\nFlip Hub Dimension to its <i>(Gateway to Destruction)</i> side. If Hub Dimension is not in play, put it into play, <i>(Gateway to Destruction)</i> side faceup.\nSpawn the set-aside Silenus enemy at Hub Dimension.\nSearch the encounter deck, encounter discard pile, and each play area for all green and red encounter cards and remove them from the game. Shuffle the encounter deck. Remove each agenda and act from the game and put the set-aside Silenus Descends agenda into play.",
         "code": "86004",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 4,
@@ -78,7 +78,7 @@
         "back_name": "Reinforcements",
         "back_text": "If you are playing in Standalone Mode, add 1 [cultist] token to the chaos bag.\nShuffle the 2 set-aside Bringer of Paradise enemies, the 3 Hunt Down treacheries, and the encounter discard pile into the encounter deck.\nIf this is the first agenda to advance to 1b, spawn the set-aside Horrific Shoggoth enemy at the Shrine of Magh'an Ark'at.",
         "code": "86005",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 5,
@@ -98,7 +98,7 @@
         "back_name": "Summoning of the Servitor",
         "back_text": "If you are playing in Standalone Mode, add 1 [cultist] token to the chaos bag.\nIf the Horrific Shoggoth enemy is set-aside, shuffle it into the encounter deck.\nIf this is the first agenda to advance to 2b, spawn the set-aside Vile Broodmaster enemy at the Shrine of Magh'an Ark'at.",
         "code": "86006",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 6,
@@ -118,7 +118,7 @@
         "back_name": "War is Over",
         "back_text": "If you are playing in Standalone Mode, add 1 [cultist] token to the chaos bag.\nFlip Hub Dimension to its <i>(Gateway to Destruction)</i> side. If Hub Dimension is not in play, put it into play, <i>(Gateway to Destruction)</i> side faceup.\nSpawn the set-aside Magh'an Ark'at enemy at Hub Dimension.\nSearch the encounter deck, encounter discard pile, and each play area for all blue and red encounter cards and remove them from the game. Shuffle the encounter deck. Remove each agenda and act from the game and put the set-aside The Egg Hatches agenda into play.",
         "code": "86007",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 7,
@@ -138,7 +138,7 @@
         "back_name": "Reinforcements",
         "back_text": "If you are playing in Standalone Mode, add 1 [elder_thing] token to the chaos bag.\nShuffle 3 of the 4 set-aside Trylogog enemies, the 2 Transmogrify treacheries, and the encounter discard pile into the encounter deck.\nIf this is the first agenda to advance to 1b, spawn the remaining set-aside Trylogog enemy. That enemy gains an additional swarming 2.",
         "code": "86008",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 8,
@@ -158,7 +158,7 @@
         "back_name": "The Swarm Spreads",
         "back_text": "If you are playing in Standalone Mode, add 1 [elder_thing] token to the chaos bag.\nIf a copy of Trylogog is set-aside, shuffle it into the encounter deck.\nIf this is the first agenda to advance to 2b, spawn the set-aside Droning Horde enemy at the Burning Pit.",
         "code": "86009",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 9,
@@ -178,7 +178,7 @@
         "back_name": "War is Over",
         "back_text": "If you are playing in Standalone Mode, add 1 [elder_thing] token to the chaos bag.\nFlip Hub Dimension to its <i>(Gateway to Destruction)</i> side. If Hub Dimension is not in play, put it into play, <i>(Gateway to Destruction)</i> side faceup.\nSpawn the set-aside Ezel-zen-rezl enemy at Hub Dimension.\nSearch the encounter deck, encounter discard pile, and each play area for all blue and green encounter cards and remove them from the game. Shuffle the encounter deck. Remove each agenda and act from the game and put the set-aside Ezel-zen-rezl Emerges agenda into play.",
         "code": "86010",
-        "doom": -2,
+        "doom": -3,
         "double_sided": true,
         "encounter_code": "war_of_the_outer_gods",
         "encounter_position": 10,
@@ -626,7 +626,7 @@
         "enemy_fight": 4,
         "enemy_horror": 3,
         "faction_code": "mythos",
-        "health": -2,
+        "health": -3,
         "illustrator": "Joshua Cairos",
         "is_unique": true,
         "name": "Silenus",
@@ -759,7 +759,7 @@
         "enemy_fight": 3,
         "enemy_horror": 1,
         "faction_code": "mythos",
-        "health": -2,
+        "health": -3,
         "illustrator": "Helge C Balzer",
         "is_unique": true,
         "name": "Magh'an Ark'at",
@@ -890,7 +890,7 @@
         "enemy_fight": 5,
         "enemy_horror": 2,
         "faction_code": "mythos",
-        "health": -2,
+        "health": -3,
         "illustrator": "Joshua Cairos",
         "is_unique": true,
         "name": "Ezel-zen-rezl",

pack/tdc/tdcc.json

@@ -4133,10 +4133,10 @@
         "code": "11701",
         "encounter_code": "the_doom_of_arkham_part_2",
         "encounter_position": 15,
-        "enemy_evade": null,
-        "enemy_fight": null,
+        "enemy_evade": -3,
+        "enemy_fight": -3,
         "faction_code": "mythos",
-        "health": null,
+        "health": -3,
         "illustrator": "JB Casacop",
         "is_unique": true,
         "name": "Cthulhu",

pack/tic/hhg.json

@@ -4,13 +4,13 @@
         "cost": 1,
         "deck_limit": 2,
         "faction_code": "guardian",
-        "health": -2,
+        "health": -3,
         "illustrator": "Imad Awan",
         "name": "Enchanted Armor",
         "pack_code": "hhg",
         "position": 189,
         "quantity": 2,
-        "sanity": -2,
+        "sanity": -3,
         "skill_agility": 1,
         "skill_willpower": 1,
         "slot": "Body. Arcane",