Merge branch 'master' into multithreading

Author: Pim Bax

META-INF/MANIFEST.MF

@@ -0,0 +1,3 @@
+Manifest-Version: 1.0
+Main-Class: core.LLMTest
+

data/cantstop/ruleSummary.txt

@@ -0,0 +1,31 @@
+**Game Implementation Summary**
+
+**Game Rules:**
+
+1. **Dice Rolling:** Players roll four dice, split into two pairs to determine column movements.
+2. **Column Movement:** Each pair dictates movement in one column.
+3. **Turn End:** Players can stop rolling and end their turn at any time to secure progress.
+4. **Winning Columns:** Players win a column by reaching the top with a marker.
+5. **Loss Condition:** Rolling higher numbers after winning a column can cause loss of all placed markers.
+6. **Marker Placement:** Markers cannot be placed in already won columns.
+7. **Game Win:** The first player to claim any three columns wins.
+
+**Strategy:**
+
+1. **Focus Columns:** Prioritize columns with numbers 6, 7, or 8 due to higher probability.
+2. **Avoid Short Columns:** Columns with fewer steps are less advantageous.
+3. **Risk Management:** Stop rolling to secure progress and avoid losing all markers in a column.
+4. **Marker Interaction:** If a player's marker lands on another's, they must roll again until moving or losing their turn (blowing it).
+
+**Game Variant:**
+
+- **Four Players:** Encourages more risk-taking due to increased competition.
+
+**Developer Notes:**
+
+- Implement dice rolling mechanics with split pair results.
+- Include rules for column movement and marker placement.
+- Create logic for winning and losing conditions.
+- Add a focus on strategy with column prioritization.
+- Integrate the interaction rule for markers on the same space.
+- Consider enhancing the game with a four-player mode for increased challenge.

data/cantstop/rulebook.pdf

@@ -0,0 +1,23 @@
+**"Connect Four" Game Rules and Strategy Summary:**
+
+- **Objective:** Align four checkers of your color vertically, horizontally, or diagonally on a 7x6 grid.
+- **Players:** Two players, taking turns.
+- **Gameplay:**
+  - Players take turns dropping checkers into the top of the grid.
+  - Checkers fall to the lowest available row.
+  - The game ends when a player achieves a winning combination or the grid is full.
+- **Winning Condition:** First player to align four checkers in a row (vertical, horizontal, or diagonal) wins.
+- **Post-Game:** Winning player slides a lever to clear the grid, preparing for the next game.
+
+**Strategy:**
+- **Center Control:** Aim to control the center columns (3 and 4) to have the most line options.
+- **Block Opponent:** Prevent the opponent from getting three in a row, especially in the center.
+- **Forks:** Create opportunities where you can win in multiple lines in your next turn.
+- **Force Opponent:** Force the opponent into positions where they must block you, limiting their own opportunities.
+- **Corner Play:** Use corners strategically, especially for diagonals.
+
+**Development Notes:**
+- Implement a 7x6 grid.
+- Check for winning combinations after each turn.
+- Handle full grid (no more moves) scenario.
+- Include lever mechanism to clear the grid after a win.

data/coltexpress/rulebook.pdf

@@ -0,0 +1,32 @@
+**Game Summary for Implementation**
+
+**Game Overview:**
+- 3-8 players, aged 8+
+- 30-minute playtime
+- Players explore a cave, collect diamonds and rubies, avoid traps
+- Goal: gather the most diamonds by the end of the game
+
+**Game Components:**
+- Board: 5 paths connecting camp to the cave
+- Cards: Decision, Treasure, Trap
+- Barricade tiles: track progress
+- Chests: store rubies and diamonds
+
+**Game Rules:**
+1. **Treasure Collection:** Players gather rubies from Treasure cards, sharing equally and keeping extras.
+2. **Traps:** Two Trap cards end the expedition.
+3. **Movement:** Players simultaneously reveal cards, gather treasure, and decide to continue or exit.
+4. **Exiting:** Exiting players share rubies, and the first to leave takes Relics for Diamonds.
+5. **Game End:** When all players return to camp or two Traps appear.
+6. **Rounds:** After each round, place a Barricade tile, reallocate Rubies and Relics, reshuffle the Expedition deck.
+
+**Strategy:**
+1. **Treasure Collection:** Continue the expedition to gather more treasure but be cautious of Trap cards.
+2. **Timing Exits:** Decide to exit when you have enough rubies to secure your score.
+3. **Leveraging Diamonds:** Maximize treasure collection and use diamonds for victory points.
+
+**Key Mechanics:**
+- Simultaneous card revelation
+- Resource sharing and management
+- Risk-reward decision-making
+- Progress tracking with Barricade tiles

data/connect4/ruleSummary.txt

@@ -0,0 +1,44 @@
+**Game Summary for Implementation**
+
+**Game Rules:**
+- Players build a deck (Dominion) using Treasure, Action, and Victory cards to gain victory points.
+- Players start with 7 Copper and 3 Estate cards.
+- Game ends when 3 supply piles or the Province pile is empty. Player with most victory points wins (fewest turns in case of a tie).
+- Turn structure: Draw 5 cards → Action phase (play Action cards) → Buy phase (acquire new cards) → Clean-up phase (discard down to 7 cards).
+- Players have 1 Action and 1 Buy per turn, but Action cards can modify these values.
+- Deck is shuffled when empty.
+
+**Card Types:**
+- Treasure: Copper, Silver, Gold
+- Victory: Estate, Duchy, Province
+- Curse
+- Kingdom: Action, Action-Attack, Action-Reaction, Victory
+
+**Strategy:**
+- Focus on acquiring powerful Action and Victory point cards.
+- Manage Treasure effectively to outpace opponents.
+- Efficiently use Action cards to draw more cards and perform additional actions.
+- Plan ahead for Action card restrictions (e.g., cannot play Action cards for first two turns).
+- Combine Treasure cards and Action-provided coins to buy multiple cards.
+- Use Action cards to alter game rules (e.g., drawing more cards, playing more Action cards, buying additional cards).
+- Understand specific card effects and timing (e.g., Throne Room, Village, Witch, Thief).
+- Manage hand size and card discarding/trashing strategically.
+- Recognize various strategic setups (e.g., "Big Money" with Market and Mine).
+
+**Notable Cards & Effects:**
+- Throne Room: Play an Action card twice without using extra Actions.
+- Village: Requires careful tracking of remaining Actions.
+- Witch: Discards cards, manage hand size carefully.
+- Thief: Reveal last card, discard one Treasure chosen by the attacker.
+- Moat: Protects against Attack cards.
+- Market, Laboratory: Allow additional card draws and plays.
+- Mine: Enables Treasure upgrades.
+- Gardens: Victory card with end-game scoring.
+- Militia: Forces players to discard down to three cards.
+
+**Special Actions & Rules:**
+- Trash Treasures to gain other Treasures or cheaper ones.
+- Use Moat to avoid Attack effects.
+- Specific conditions for Moneylender, Remodel, Smithy, Spy, and Thief.
+- Resolve 'Chancellor' before other turn actions.
+- Place gained cards directly into the Discard pile.

data/connect4/rulebook.pdf

@@ -0,0 +1,31 @@
+**Game Rules:**
+
+1. **Objective:** Avoid taking tricks containing hearts or the queen of spades.
+2. **Deck:** Standard 52-card deck.
+3. **Players:** 4.
+4. **Scoring:**
+   - Hearts: 1 point each.
+   - Queen of Spades: 13 points.
+   - Other cards: 0 points.
+   - First player to reach 100 points loses. Lowest score wins.
+5. **Passing:**
+   - Each player passes 3 cards to another player.
+   - Passing direction rotates clockwise each round.
+
+**Strategies:**
+
+1. **Queen of Spades:**
+   - Avoid leading with the queen of spades.
+   - Pass low spades to avoid being stuck with high spades alone.
+
+2. **Hearts:**
+   - Save high hearts (especially the queen, king, and ace of hearts) for late-game use to prevent opponents from shooting the moon.
+   - Try to avoid leading with hearts early in the game.
+
+3. **Trick Avoidance:**
+   - Avoid taking tricks with hearts or the queen of spades.
+   - If you must take a trick with points, try to take it from an opponent with a higher score.
+
+4. **Shooting the Moon:**
+   - Aim to take all hearts and the queen of spades in one hand to score 0 points and pass 26 points to each opponent.
+   - Be cautious, as failing to shoot the moon results in a high score.

data/diamant/ruleSummary.txt

@@ -0,0 +1,31 @@
+**"Love Letter" Game Summary for Developer Implementation:**
+
+**Objective:**
+- Be the last player standing or have the highest-value card when the deck runs out.
+
+**Player Count:**
+- 2-6 players (Classic version: 2-4 players)
+
+**Gameplay:**
+- Players draw and play one card per turn, each with unique effects.
+- Effects can eliminate players, trade hands, peek at cards, or grant temporary immunity.
+- The round ends when the deck is empty or one player remains.
+
+**Special Cards:**
+- **Princess & Guard:** Immediately eliminate players.
+- **Handmaid:** Provides temporary immunity.
+- **Countess:** Must be played if King or Prince is in hand.
+- **Spy:** Grants a favor token at round's end if played or discarded.
+
+**Strategy:**
+- Pay attention to played/discarded cards and other players' hands.
+- Manage your hand carefully, considering forced play conditions (Countess, Princess).
+- Use cards like Chancellor to draw and optimize your hand.
+- Protect yourself with Handmaid, eliminate low-card opponents with Baron, and bluff with Spy.
+
+**Winning:**
+- Win a set number of rounds to claim victory.
+
+**Classic Version:**
+- Excludes certain cards from the setup.
+- Supports 2-4 players.

data/diamant/rulebook.pdf

@@ -0,0 +1,29 @@
+**Texas Hold'em Game Rules and Strategy Summary:**
+
+**Objective:** Form the best five-card hand using any combination of two hole cards and five community cards.
+
+**Game Flow:**
+1. **Button & Blinds:**
+   - The button (dealer) moves clockwise.
+   - Player left of the button posts the small blind; next player posts the big blind.
+
+2. **Hole Cards & Betting:**
+   - Each player receives two hole cards.
+   - Betting starts left of the big blind, with options to call, raise, or fold.
+   - Betting continues clockwise, with all remaining players matching the highest bet.
+
+3. **Community Cards & Betting Rounds:**
+   - **Flop:** Three community cards dealt, followed by a betting round.
+   - **Turn:** One more community card dealt, followed by a betting round.
+   - **River:** Final community card dealt, followed by the final betting round.
+
+4. **Hand Rankings (Best to Worst):**
+   - Royal Flush, Four of a Kind, Full House, Flush, Straight, Three of a Kind, Two Pair, Pair, High Card.
+
+**Winning the Pot:**
+- The player with the highest-ranking hand wins the pot.
+- In case of a tie, the pot is split.
+
+**Strategy:**
+- Form a pair or a high card combination with more than one suit.
+- Use any combination of hole cards and community cards to make the best five-card hand.

data/dominion/ruleSummary.txt

@@ -0,0 +1,34 @@
+**Stratego Game Rules and Strategy Summary**
+
+**Objective:** Capture the opponent's flag or render them unable to move.
+
+**Board:** 10x10 grid.
+
+**Pieces:** Each player has 40 pieces, each with a unique rank and movement ability.
+
+**Movement:**
+- Most pieces move one space at a time.
+- The Scout can move any distance.
+
+**Attacking:**
+- Pieces reveal their rank when attacking.
+- Higher ranked piece always captures the lower, except when equal ranks attack each other (both are removed).
+- Special rules:
+  - Bomb: Captures adjacent pieces when attacked.
+  - Spy: Captures Marshal or Flag, but loses to any other piece or when attacked.
+  - Miner: Captures Bombs.
+
+**Endgame:**
+- Game ends in draw if both flags are protected and only non-Miner pieces remain.
+
+**Strategy:**
+- Concealment: Hide pieces' ranks to mislead the opponent.
+- Bluffing: Make moves to deceive the opponent about your pieces' identities.
+- Setup: Strategically place pieces at the start of the game for optimal defense and offense.
+
+**Pace:** Fast-paced, with no standard notation. Digital interfaces may record moves.
+
+**Unique Abilities:**
+- Marshal: Most powerful.
+- Spy: Weakest, but can capture Marshal or Flag.
+- Other pieces have distinct movement abilities and ranks.

data/dominion/rulebook.pdf

@@ -0,0 +1,37 @@
+**Game Summary for Developer Implementation**
+
+**Game Rules:**
+- Players draft cards simultaneously, keeping one and passing the rest to the left. This happens over three rounds.
+- Special cards include:
+  - **Wasabi**: Boosts nigiri scores.
+  - **Chopsticks**: Allows taking two sushi cards on future turns.
+- Pudding cards determine the game's end:
+  - Most pudding cards: +6 points.
+  - Least pudding cards: -6 points.
+  - Ties for least are broken by most pudding cards.
+- Scoring is based on sets of:
+  - **Tempura**: 2 cards for 5 points.
+  - **Sashimi**: 3 cards for 10 points.
+  - **Dumplings**: More is better, up to 15 points for 5+ dumplings.
+  - **Nigiri**: 1-3 points, increased by wasabi.
+  - **Maki Rolls**: 6 points.
+  - **Pudding**: +6 for most, -6 for least.
+  - **Chopsticks**: No points.
+- Two-player variant includes a third dummy player.
+
+**Strategy:**
+- Focus on collecting high-value sets:
+  - **Sashimi**: Aim for sets of 3 for 10 points.
+  - **Tempura**: Aim for sets of 2 for 5 points.
+  - **Maki Rolls**: 6 points each.
+- Use special cards strategically:
+  - **Wasabi**: Boost nigiri scores.
+  - **Chopsticks**: Maximize card collection on future turns.
+- Manage pudding cards:
+  - Avoid having the least to prevent point deduction.
+  - Aim for having the most to gain points, but not at the expense of other high-scoring sets.
+- In two-player games, consider the dummy player's impact on pudding card distribution.
+
+**End of Game:**
+- The game ends after the final card is passed.
+- The player with the highest score wins. In case of a tie, the player with the most pudding cards wins.

data/hearts/ruleSummary.txt

@@ -0,0 +1,13 @@
+##  Tic-Tac-Toe: Core Game Rules
+
+Tic-Tac-Toe is a simple yet strategic game played on a 3x3 grid.  Two players, typically designated "X" and "O," take turns placing their mark on an empty square. The goal is to be the first to achieve a line of three of your own marks – either horizontally, vertically, or diagonally.
+
+**Here's a breakdown of the core gameplay:**
+
+* **The Grid:**  The game is played on a 3x3 grid, often drawn on paper or a whiteboard.
+* **Players:**  Two players participate, one playing as "X" and the other as "O."
+* **Turns:**  Players alternate turns, placing their mark in an empty square on the grid.
+* **Winning Condition:** The first player to achieve a line of three of their own marks (horizontally, vertically, or diagonally) wins the game.
+* **Tie Game:** If all squares are filled without a player achieving three in a row, the game ends in a tie.
+
+**Simple and Engaging:**  Tic-Tac-Toe is a quick and engaging game that can be enjoyed by people of all ages. It's a great way to introduce strategic thinking and develop problem-solving skills. 

data/hearts/rulebook.pdf

@@ -0,0 +1,27 @@
+**"Virus" is a strategic card game for 2-6 players, aiming to collect four different colored organ cards to form a healthy body. Here are the key rules and strategies:**
+
+**Game Rules:**
+- Players draw three cards per turn.
+- To win, a player must collect four unique organ cards.
+- Card types: Healthy Organs, Viruses, Medicines, and Treatments/Actions.
+- Viruses can destroy or infect organs; Medicines protect or immunize organs.
+- Treatment/Action cards offer special effects, like Virus transfer ("Contagion") or organ swapping ("Organ Thief", "Organ Transplantation").
+- Multicolor cards can represent any color.
+- The game ends when a player has four healthy organs.
+- When the deck is empty, draw from the discard pile.
+
+**Strategy:**
+- Protect your organs with Medicine cards.
+- Use Virus cards strategically to target opponents' organs.
+- Leverage Treatment/Action cards for disruption or advantage.
+- Key strategies include:
+  - Spreading viruses to hinder opponents.
+  - Using "Medical Error" to swap bodies when an opponent is close to winning.
+  - Immunizing organs as soon as possible.
+
+**Implementation Notes:**
+- Ensure each player has three cards in their hand at the start.
+- Include virus, medicine, treatment/action, and multicolor cards in the deck.
+- Implement special effects for Treatment/Action cards.
+- Allow drawing from the discard pile when the deck is empty.
+- End the game when a player collects four unique healthy organ cards.

data/loveletter/ruleSummary.txt

@@ -0,0 +1,41 @@
+**Game Rules & Strategy Summary**
+
+**Game Rules:**
+- Players lead cities through three ages, each with 6 turns.
+- Players draft cards (structures, Wonders) and compare military strength with neighbors.
+- Victory points (VP) are awarded at the end of each age (1, 3, 5 VP respectively).
+- Cards have costs (coins, resources) and provide resources, points, coins, or military strength.
+- Players buy resources from neighbors for 2 coins each.
+- Players take turns playing cards, gaining coins, or advancing Wonders.
+- Military conflicts resolve at the end of each age.
+- Final score includes VP tokens, coins (3 coins = 1 VP), Wonder points, and structure points.
+- Scientific structures earn points for sets of symbols.
+- Two-player variant includes a shared "Free City."
+- Each Wonder has unique abilities and VP values.
+
+**Strategy:**
+- Focus on resource production, commerce, and military strength.
+- Prioritize structures that provide resources, points, and free builds.
+- Plan resource purchases and constructions carefully.
+- Use commercial structures to reduce resource costs.
+- Balance resource production, military strength, and coin management.
+- Optimize Free City resource purchases and constructions in the two-player variant.
+- Utilize each Wonder's unique abilities for resources, coins, or VP.
+- Optimize resource use, timing of Wonder stages, and Guild selection.
+- Build structures that provide market discounts or defensive bonuses.
+- Balance immediate gains with long-term VP from card colors and Guilds.
+- Build and manage your city to maximize VP and scientific symbols.
+
+**Key Points:**
+- Efficient resource production and management are crucial.
+- Balance immediate gains with long-term VP strategies.
+- Utilize each Wonder's unique abilities effectively.
+- Plan ahead for Free Constructions and coin income.
+- Optimize resource purchases and mandated constructions in the Free City (two-player variant).
+
+**Development Notes:**
+- Implement unique abilities for each Wonder.
+- Ensure each card's cost, benefits, and effects are clearly defined.
+- Incorporate military conflict resolution and VP awarding at the end of each age.
+- Implement the two-player variant with the Free City mechanics.
+- Ensure final scoring accurately reflects all VP sources (tokens, coins, Wonder points, structure points, scientific symbols).