Investigator/card specific automation (Preliminary list)

[KenDdoox]

Seeing what can be done to facilitate specific investigator's abilities such as the case of card search and Mandy, I've compiled a preliminary list of automation that can be made for specific investigators below. There are also a suggestion to move around an element in the module to enable the automation to happen, which is mentioned in point 1.

These suggestions will likely need a lot of time to be done and tested to work properly, and some of them are more complicated than others, I'm only tentatively listing some of the things that can be automated here so that our devs can look into them and maybe roll them out over time. All these changes are only quality of life automation, and is definitely not needed for the game to function properly, therefore if something is too complicated or difficult or out of scope, feel free to comment and make suggestions.

Lastly, as mentioned in #238 (Housekeeping), these specific card automation should be made in a separate .py file for easier management and maintenance.

1. Move opening hand from global to player tab to facilitate automation for special opening hands

   • Sefina: Opening hand of 13
   • Studious: Increases opening hand by 1

2. Abilities on load deck

   • Mary: Add 2 bless tokens to the bag
   • Permanent cards that search deck or take out cards before opening hand i.e. Stick to the Plan, Ancestral Knowledge
   • Another Day, Another Dollar: Add 2 resources to investigator
   • Studious: Increases opening hand by 1
   • Joe: Search all Insight cards and put them into Secondary Deck (as Sideboard is reserved for Bonded cards) and let player pull out cards they don't want there to put back into deck. Should not automatically draw opening hand to remind player of this.

3. Hand size automation

   • Patrice: Reduce hand size by 3
   • Arcane Enlightenment: Increase hand size by 1
   • Laboratory Assitance, Vault of Knowledge: Increase hand size by 2
   • Drawing the Sign: Reduce hand size by 5
   • Dream-Enhancing Serum: Special case, could be complicated

4. Investigation phase automation

   • Amanda: Draws 1 additional card
   • Preston/Family Inheritance: Replenish 4 resources
   • Tri-class cards, lv4 talents: Replenish 2 resources
   • True Magick: Replenish 1 resource

5. Upkeep automation

   • Jenny: Take 1 additional resource
   • Patrice: Discard all non-weakness cards and draw until 5 cards in hand
   • Forced Learning: Draw 2 cards, discard 1

6. Mythos automation

   • Mary: Add 1 bless token (technically end of Upkeep, but weaknesses or treachery like Lost Soul can force you to take a test before the end of Upkeep, which is why adding bless at Mythos start is more correct)

7. Other specific cards:

   • Calvin: Stats in the player tab can be linked to his current health/sanity on investigator card
   • Norman: Automatically set his deck to "visible by everyone". If a weakness (except The Harbinger) is on top, automatically pull it out on the table (Hidden is fine because technically everyone can still see it on top of his deck when he reveals it anyway).
   • Norman/The Harbinger: If it's on top of his deck, his deck cannot be affected anymore i.e. no automatic draw at upkeep.
   • Akachi: Add 1 charge to cards that have "charges" when placed on the table.
   • Nkosi Mabati: Related to card search for token, but this one might be more complicated.

[Kwaice]

I've been working on those quality of life improvements for some time and i'll submit a PR soon.

[KenDdoox]

New additions with the Scarlet Keys update:

1. Vincent starts with his On the Mend skills in Sideboard
2. Darrell starts with his Kodak in play
3. New charges on cards: time, aether
4. Underworld Market automation:
   • On deckload - triggered like STTP, use Secondary deck like Joe's Hunch
   • Start of investigation phase: look at the top 2 cards of the secondary deck. Note: This window doesn't need to be closed before things can continue outside of it (unlike the upkeep discard window)
5. STTP cards now attach facedown with peek
6. Runic Axe replenish only 1 charge by default
7. Prepared for the Worst (2) opens investigator selector
8. Add search automation for:
   • Captivating Discovery: top 6 cards of your deck, cards go to hand, shuffle deck
   • Salvage: search your discard pile for Item assets -> 1 card go to table, do not shuffle discard pile
   • Copycat: select another investigator, search discard pile for skills -> 1 card go to table, do not shuffle discard pile. Note: does nothing if solo
   • A Chance Encounter: select any investigator, search discard pile for ally assets -> 1 card go to table, do not shuffle discard pile
   • Flare: select any investigator, search deck for ally assets -> 1 card go to table, shuffle deck
9. Upgrade sheets for customizable cards are added to Sideboard at deck load, similar to bonded cards. These have the same name but type = "Upgrades"
10. Word of Weal & Woe: Double click on one to discard it, then reshuffle the other into the deck if it's in the discard pile
11. Favor of the Sun & Moon: should count unsealed tokens on the table to display the blurse tokens used correctly as second/third/etc. token in the chain - currently displaying at the first spot, even if there's already a token present.
12. Add seal automation for Day of Reckoning
13. Short Supply automation

[alexshields34]

These already work with no additional changes.

3 New charges on cards: aether 7 Prepared for the Worst (2) opens investigator selector