Skip to content

Latest commit

 

History

History
96 lines (67 loc) · 3.12 KB

README.md

File metadata and controls

96 lines (67 loc) · 3.12 KB

Prisoner's Dilemma Game

Overview

The Prisoner's Dilemma Game is a strategic game built with Go, allowing players to explore the classic game theory problem. Players can compete against each other either locally or over a network, choosing between cooperation or defection in each round. The outcome of each decision impacts their "prison time," with the goal of minimizing their own time.

Features

  • Local and Network Play: Choose to play against another player on the same machine or over the network.
  • Multiple Rounds: Customize the number of rounds and view summaries after the game.
  • AI Opponent: Play against different AI strategies like Tit-for-Tat or Random (future release).
  • Futuristic UI: Experience a sleek, animated interface with cool ASCII art and a modern design (future release).

Getting Started

Prerequisites

  • Go 1.20 or higher
  • A terminal or command line interface

Installation

  1. Clone the repository: 
    git clone https://github.com/kh3rld/prisoners-dilemma.git
  2. Navigate to the project directory: 
    cd prisoners-dilemma
  3. Initialize the Go module: 
    go mod init github.com/kh3rld/prisoners-dilemma
  4. Tidy up the dependencies: 
    go mod tidy
  5. Build the project: 
    cd ./cmd && go build .
  6. Run the game: 
    ./cmd

Usage

When you start the game, you'll be presented with a menu:

  • 1. Play Locally: Start a local game between two players on the same machine.
  • 2. Play Over Network: Host or join a game over the network.
  • 3. View Instructions: Learn how to play the game.
  • 4. Quit: Exit the game.

Follow the prompts to enter your choices and enjoy the game!

Playing Over Network

To play over the network:

  1. Host a Game: Select "Host a Game" on one machine and wait for the other player to join.
  2. Join a Game: Select "Join a Game" on the second machine and enter the host’s IP address.

Game Rules

  1. Each player can choose to cooperate or defect.
  2. If both players cooperate, they each get 1 year in prison.
  3. If one defects while the other cooperates, the defector goes free and the cooperator gets 3 years in prison.
  4. If both defect, they each get 2 years in prison.
  5. The goal is to minimize your prison time over multiple rounds.

Contributing

We welcome contributions! Please fork the repository and submit a pull request with your improvements.

Future Enhancements

  • Add AI opponents with different strategies.
  • Implement a leaderboard for networked games.
  • Enhance the user interface with more animations and effects.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Special thanks to the Go community and open-source contributors.
  • Inspired by the classic game theory problem, the Prisoner's Dilemma.

Contact

Feel free to reach out via X or GitHub for any questions or feedback.