Games
=====

Playable browser games and interactive simulations.

Windows Card Game
-----------------

A browser-based implementation of **Windows** (also known as Cabo, Golf, or Cactus) - a drinking card game for 3-8 players.

**Play now:** `Windows Card Game <./games/windows-card-game.html>`_

Game Overview
~~~~~~~~~~~~~

Windows is a memory card game played with a standard 52-card deck plus two jokers. 
The goal is to have the lowest score by the end of the game.

Features
~~~~~~~~

- **Single Player vs 3 Bots**: Play against AI opponents with different risk models
- **Special Cards**: Cards 6-12 have special abilities (peek, swap, reveal)
- **Throwing Mechanic**: Match discarded cards to throw your cards away
- **Sound Effects**: Web Audio API sound effects for game actions
- **Game Statistics**: Track your wins, losses, and performance over time
- **Responsive Design**: Playable on desktop and mobile devices

How to Play
~~~~~~~~~~~

1. Each player receives 4 cards (2 visible, 2 hidden)
2. On your turn, draw from the deck or discard pile
3. Replace one of your cards or discard directly
4. Use special cards (6-12) for strategic advantages
5. Match discarded cards to throw your visible cards
6. Knock when you think you have the lowest score
7. Lowest total wins!

Rules Summary
~~~~~~~~~~~~~

- **Card Values**: Joker (0), Ace (1), 2-10 (face value), Jack (11), Queen (12), Red King (-1), Black King (13)
- **Special Cards** (6-12): Only work when played directly from deck to discard
- **Throwing**: Match the discarded card number with your visible cards
- **Knocking**: Ends the game after one more round (can't knock on first round)

Technical Details
~~~~~~~~~~~~~~~~~

- Pure HTML5/CSS3/JavaScript (no frameworks)
- Vanilla JS game engine with AI opponents
- localStorage for game history persistence
- Responsive design with CSS Grid and Flexbox
- Web Audio API for sound effects

.. raw:: html

   <div style="margin: 20px 0; text-align: center;">
     <a href="./games/windows-card-game.html" 
        style="display: inline-block; padding: 15px 30px; background: linear-gradient(180deg, #3d9cff, #2563eb); color: white; text-decoration: none; border-radius: 12px; font-weight: bold; box-shadow: 0 8px 20px rgba(37,99,235,.25);">
       🎮 Play Windows Card Game
     </a>
   </div>

.. toctree::
   :hidden:

   games/windows-card-game.html