Skip to content

Latest commit

 

History

History
72 lines (58 loc) · 5.69 KB

README.md

File metadata and controls

72 lines (58 loc) · 5.69 KB
Raw

Welcome to 6nimmts! 🍻

This project is a digital version of the card game 6 nimmt! (also known as Take 6), designed by Wolfgang Kramer in 1994.

If you didn't know about the game

The game starts with a deck of 104 cards numbered 1-104, each bearing 1, 2, 3, 5, or 7 cattle heads that represent penalty points. Players aim to collect the fewest cattle heads by strategically placing cards on four rows according to simple rules. When a player places the sixth card in a row, they must take that entire row, scoring all the penalty points on those cards.

The game ends when a player reaches 66 penalty points, and the player with the lowest total score wins. This fast-paced game combines strategic thinking with elements of luck, making it engaging for players of all ages.

Game Setup

  • Cards: There are 105 cards, each with a unique number and a certain number of cattle heads (which are penalty points you want to avoid).
    • Cards that can be divided by 5 have 2 cattle heads, but if they can also be divided by 10, they have 3 cattle heads.
    • Cards that can be divided by 11 have either 5 or 7 cattle heads, making them more risky.
  • Decks: 4 rows (decks) each capable of holding up to 5 cards.
  • Players: 2-10 players. The goal is to avoid collecting penalty points.

Gameplay

  1. Distribute Cards: Each player is given 10 cards at the start.
  2. Setup Decks: Initialize the 4 rows with a card.
  3. Player Turns:
    • Each player selects a card to place on the table.
    • The cards are then placed in rows according to their value.
    • If a player's card is smaller than any card in a row, they must take all cards in that row and place their card in a new row.
    • If a row is full, the player who places the next card takes the row.
  4. Determine Winner: The game ends after 10 turns. The player with the fewest penalty points (cattle heads) wins.

(Mini) Developer's Guide

Project Structure

  • Main Python Script is located at main.py
    • Implements the core game mechanics.
    • Contains the setup, distribution, gameplay, and winner determination logic.

Table of Functions

Function Input(s) Description
print_deck() deck Prints the current deck situation.
print_players() players Prints the cards held by each player.
set_up_cards() cards Creates a list of 105 cards with varying cattle heads as penalty points.
distribute_cards() num_of_players, cards Distributes 10 cards to each player.
find_largest_cards_in_row() row Finds the largest card in a row, helping to determine placement.
set_up_decks() cards, deck Initializes the 4 rows of decks with cards.
place_card() players, player, card, deck Places a player's card into a row, handling cases like row overflow or invalid placement.
make_new_row() first_card Creates a new row starting with a specific card.
place_single_card() row, card Places a single card into a specific row.
is_row_full() row Checks if a row is full.
is_larger_card() curr_card, compared_card Compares two cards to determine which is larger.
determine_winners() players Calculates and announces the winner based on penalty points.
parse_card() card Parses a card input by the player.
check_card_in_hand() card, current_deck Verifies that a card is in the player's hand.
play_game() - Main function to start and manage the game.
simulate_debug() - Runs a debug simulation of the game.
simulate() difficulty Runs the game with a specific difficulty level.
ask_play_again() - Prompts the player to play again.

How to Play

  1. Clone the repository.
git clone https://github.com/maryjess/6nimmts.git
  1. Run the main.py file.
  2. Follow the on-screen instructions to play the game.