engine/tests/logic/GAME_RULES_VERIFICATION.md

Love Live! OCG: Rule Verification

This is my understanding of the game logic, derived from reading game_state.py and card.py.

1. Win Condition

• Primary Goal: Be the first player to successfully perform 3 Lives.
• Tie-Breaker: If both players reach 3 Lives in the same turn, the player with the higher Total Score (Sum of difficulty/score of completed Lives) wins? (Need to verify if score tie-breaker exists or if it's "Active Player Wins").

2. Core Stats (The Numbers)

• Hearts: The "color" resource. A card might have [2 Pink, 1 Blue].
• Blade Power (BP): The "attack" stat. Used for:
  • Meeting "Total BP" requirements for some Lives?
  • Triggering abilities (e.g., "If you have a member with 400+ BP").
  • Comparing against opponents (e.g., "Retire opponent's member with BP < 300").
• Cost: Energy required to play a Member.

3. The Turn Structure

1. Draw Phase: Draw 1 card.
2. Energy Phase: Gain 2 Energy (or more based on turn count?).
3. Main Phase:
   • Play Members to Stage (Max 3 slots).
   • Play "Live" cards (The goal).
   • Activate "Main" abilities.
4. Live Phase:
   • Select a Live card.
   • Check: Do my Stage Members have enough Hearts (Color & Count) to meet the Live's requirement?
   • Bonus (Cheer): Flip top card of deck. Add its "Blade Icons" to the check.
   • Success: If (Member Hearts + Cheer Icons) >= Requirement -> Live Success! (Score +1).

4. Observations on AI Logic

• Reward Signal Correctness: My reward function gives +1.0 for winning. It also gives +0.1 per point of Score Difference. This encourages the AI to pick "High Score" Lives, not just the easiest ones, which is good for tie-breaking.
• Critical Blind Spot: "Effect Precedence." If a card says "You win instantly if you have 5 Honoka cards," my current engine might miss that if the check_win_condition function doesn't explicitly look for that specific flag.

Is this accurate to your physical game? Specifically, does the "Cheer/Blade Icon" mechanic add to Hearts or BP for the Live check?