Solitaire

Project Description: Solitaire for World of Warcraft

This project is a complete, standalone game of classic Solitaire (Klondike) designed to be played directly inside the World of Warcraft interface. It provides a familiar mini-game for players to enjoy during downtime, such as while waiting for queues or flights.

Features and User Experience

Here is a breakdown of the addon's features and how they create a seamless and enjoyable user experience:

Core Solitaire Gameplay

Feature: The addon implements a full game of classic Solitaire, including a shuffled 52-card deck, a stock pile, a waste pile, four foundation piles, and seven tableau columns.
User Experience: This provides a complete and familiar game. Users can play from start to finish, enjoying the classic game they know without having to leave WoW.

Feature: All standard game rules are enforced by the code. This includes:
- Tableau stacking: Cards can only be placed on a card of an opposite color and one rank higher (e.g., Red 9 on Black 10).
- Foundation stacking: Cards must be stacked by suit in ascending order, starting with the Ace.
- Stock/Waste Pile: Clicking the stock pile moves a card to the waste pile. When the stock is empty, clicking it recycles the entire waste pile back into the stock.
User Experience: The game functions exactly as a player would expect. This makes the game intuitive and easy to pick up, as the rules are already familiar.

Feature: A "New Game" button allows the player to instantly reset the game, which shuffles and re-deals the deck.
User Experience: Users can immediately start a fresh game at any time with a single click.

Interface and Accessibility

Feature: The game is easily accessible through multiple methods:
1. A Minimap Button.
2. A Slash Command (/solitaire).
3. LibDataBroker (LDB) support for users who use launcher addons.
User Experience: This flexibility allows users to open and close the game in whatever way best fits their personal UI setup, whether they prefer a visible icon, a chat command, or a button in their LDB display.

Feature: The main game window (SolitaireFrame) is movable and draggable.
User Experience: This is a crucial feature for an in-game addon. Users can move the Solitaire window anywhere on their screen, ensuring it doesn't cover their action bars, chat, or other critical UI elements during gameplay.

Feature: The addon uses standard Blizzard UI elements, such as the UIPanelCloseButton and UIPanelButtonTemplate.
User Experience: The addon looks and feels like a native part of the World of Warcraft interface, making it feel polished, familiar, and non-intrusive.

Visuals and Interactive Feedback

Feature: The addon uses custom graphics for card visuals, including a unique texture for the card back and distinct textures for each of the four suits (Spades, Hearts, Clubs, Diamonds).
User Experience: Instead of relying on text, the cards display clear, custom icons for their suit, making the game board easy to read at a glance.

Feature: Cards provide clear visual feedback on interaction:
- Selection Highlight: A selected card shows a visible highlight effect.
- Tooltip Information: Mousing over any face-up card displays a helpful tooltip (e.g., "Ace of Spades").
User Experience: The highlight provides unambiguous confirmation of which card is currently selected for a move. The tooltips add clarity, especially when cards are stacked and partially obscured.