4 charm vs double bluff corner cases (#1159)

Discussed in https://discord.com/channels/140016142600241152/1189236997953433630

docs/extras/charms.mdx

@@ -4,6 +4,8 @@ title: Charms
 ---
 
 import FourCharm from "@site/image-generator/yml/extras/charms/four-charm.yml";
+import FourCharmVsDoubleBluff from "@site/image-generator/yml/extras/charms/four-charm-vs-double-bluff.yml";
+import HardDoubleBluffVsFourCharm from "@site/image-generator/yml/extras/charms/hard-double-bluff-vs-four-charm.yml";
 import UnknownTrashCharm from "@site/image-generator/yml/extras/charms/unknown-trash-charm.yml";
 
 - A *Charm* refers to a blind-play in which someone plays an unrelated card from their *Fourth Finesse Position*. For example, if a player's hand is completely unclued, their *Fourth Finesse Position* is slot 4.
@@ -19,14 +21,31 @@ import UnknownTrashCharm from "@site/image-generator/yml/extras/charms/unknown-t
 #### Interaction with Double Bluffs Where Cathy Has a One-Away-From-Playable Card
 
 - As stated in the level 24 section, _Double Bluffs_ have precedence over _4 Charms_. However, there is one small exception.
-- _Double Bluffs_ do not have precedence in the situation where Bob sees that Cathy has a _one-away-from-playable_ card on her _Finesse Position_. Here, it is technically possible that Bob will blind-play the exact card that makes Cathy's _Finesse Position_ playable. But since this is so unlikely, we agree that players in this situation should revert to a _4 Charm_ interpretation.
+- _Double Bluffs_ do not have precedence in the situation where Bob sees that Cathy has a _one-away-from-playable_ card on her _Finesse Position_.
+- Here, it is technically possible that Bob will blind-play the exact card that makes Cathy's _Finesse Position_ playable. But since this is so unlikely, we agree that players in this situation should revert to a _4 Charm_ interpretation if Bob has a _Fourth Finesse Position_ and the requirements for a _4 Charm_ are met.
 - For example, in a 4-player game:
   - Red 1 is played on the stacks.
   - Alice clues blue to Donald, touching a blue 4 as a _Play Clue_. (Blue 4 is currently three-away-from-playable.)
   - Bob sees that Cathy has a red 3 on her _Finesse Position_.
   - If Bob has exactly a red 2 on his _Finesse Position_, then he knows that Alice's clue would work as a _4's Double Bluff_.
   - However, since the red 3 on Cathy's _Finesse Position_ is _one-away-from-playable_, Bob knows that _4 Charms_ should take precedence.
-  - Bob blind-plays his _Fourth Finesse Finesse_ card. It is a red 2 and successfully plays on the stacks.
+  - Bob blind-plays his _Fourth Finesse Position_ card.
+
+<FourCharmVsDoubleBluff />
+
+- Even when Cathy's card is one-away-from-playable, there are still some situations in which a _4 Charm_ is invalid, and therefore a _Double Bluff_ can still be executed. Two such situations are described below.
+  - In the case where Bob does not have a _Fourth Finesse Position_, then a _4 Charm_ does not make sense. Hence, a _Double Bluff_ can still be triggered in this case.
+  - A _[Hard Double Bluff](../level-15.mdx#the-hard-double-bluff)_ will also take precedence over a _4 Charm_, because of _Bob's Truth Principle_.
+  - For example, in a four-player game:
+    - It is the first turn and nothing is played on the stacks.
+    - Bob and Cathy have a red 1 and red 2 on their _Finesse Position_, respectively.
+    - Alice clues 4 to Donald, focusing a green 4.
+    - Bob sees Donald has a green 2 on _Finesse Position_. Thus, the green 4 is only two away and a _4 Charm_ is not legal.
+    - Bob therefore blind-plays his _Finesse Position_.
+    - Cathy sees that the green 4 was more than one-away-from-playable, and hence was not a valid _Bluff Target_ for a single _Bluff_. So, Cathy also blind-plays her _Finesse Position_.
+    - The _Hard Double Bluff_ is thus completed. Donald marks his 4 as any 4.
+
+<HardDoubleBluffVsFourCharm />
 
 #### Interaction with the Out-of-Order Finesse
 

docs/level-15.mdx

@@ -47,7 +47,7 @@ import RainbowDoubleBluff from "@site/image-generator/yml/level-15/rainbow-doubl
 
 ### The Hard Double Bluff
 
-- Similar to a _Hard 3 Bluff_, it is also possible to perform a _Hard Double Bluff_.
+- Similar to a _[Hard 3 Bluff](level-13.mdx#the-hard-3-bluff)_, it is also possible to perform a _Hard Double Bluff_.
 - For example, in a 4-player game:
   - No cards are played on the stacks.
   - Alice clues number 4 to Donald, touching a red 4 as a _Play Clue_.

docs/level-24.mdx

@@ -47,6 +47,7 @@ import HesitationBlindPlay from "@site/image-generator/yml/level-24/hesitation-b
 
 - _4 Charms_ can be given with either a color clue or a number clue.
 - Similar to a _5 Color Ejection_, _Prompts_ don't factor into the "three or more blind-plays" rule. Players only count the number of blind-plays.
+- Some corner cases about the interaction between _Double Bluffs_ and _Charms_ when Cathy holds a one-away-from-playable card are spelled out in the [extras section](extras/charms.mdx#interaction-with-double-bluffs-where-cathy-has-a-one-away-from-playable-card).
 
 <br />
 

image-generator/yml/extras/charms/four-charm-vs-double-bluff.yml

@@ -0,0 +1,31 @@
+stacks:
+  - r: 1
+  - y: 0
+  - g: 0
+  - b: 0
+  - p: 0
+players:
+  - clue_giver: true
+    cards:
+      - type: x
+      - type: x
+      - type: x
+      - type: x
+  - cards:
+      - type: x
+      - type: x
+      - type: x
+      - type: x
+        above: plays
+  - cards:
+      - type: r3
+        border: false
+      - type: x
+      - type: x
+      - type: x
+  - cards:
+      - type: x
+      - type: x
+      - type: x
+      - type: b4
+        clue: b

image-generator/yml/extras/charms/hard-double-bluff-vs-four-charm.yml

@@ -0,0 +1,41 @@
+stacks:
+  - r: 0
+  - y: 0
+  - g: 0
+  - b: 0
+  - p: 0
+players:
+  - clue_giver: true
+    cards:
+      - type: x
+      - type: x
+      - type: x
+      - type: x
+  - cards:
+      - type: x
+        above: Red 1
+      - type: x
+      - type: x
+      - type: x
+  - cards:
+      - type: x
+        above: Red 2
+      - type: x
+      - type: x
+      - type: x
+  - cards:
+      - type: g2
+        border: false
+      - type: 4
+        clue: 4
+        middle_note: (G)
+      - type: x
+      - type: x
+  - text: After both red 1 and red 2 blind-play...
+  - name: Donald
+    cards:
+      - type: x
+      - type: 4
+        below: any 4
+      - type: x
+      - type: x