Skip to content

ZygmaCore/rock_paper_scissors

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZygmaCore Rock-Paper-Scissors

Logo

A simple Python CLI Rock-Paper-Scissors game with ASCII art and clean outcome logic.


📘 About The Project

This project is a terminal-based Rock-Paper-Scissors game built using Python.
It uses ASCII art, clean input handling, and proper game logic to determine who wins each round.

The user selects Rock, Paper, or Scissors, the computer randomly selects its choice, and the program displays the winner with visual output.

🎯 Why This Project Exists

Most beginners build simple RPS games without visuals.
This version adds:

  • ASCII art
  • cleaner logic
  • replay loop
  • variable mapping system
    so it becomes more fun and better structured for learning.

It’s perfect as a beginner-friendly Python mini project and a starter portfolio piece.


🖼 Screenshot

Screenshot


🛠 Tech Stack

Technology Usage
🐍 Python Core programming language
🎨 ASCII Art Enhanced visual gameplay
🎲 random Generates computer choice
💻 CLI / Terminal User interaction

✨ Key Features

  • ✊✋✌️ ASCII Art Style RPS
  • 🤖 Smart Computer Choice (randomized)
  • 🧠 Clean Win Logic using name mapping
  • 🔁 Replay System (play again without restarting)
  • 🚫 Input Validation
  • 🧹 Screen Clearing for clean UI (os.system("clear"))

🚀 Getting Started

✅ Prerequisites

You need:

  • Python 3.8+
  • Terminal (MacOS, Linux, Windows PowerShell/CMD)

📦 Installation

Clone repository:

git clone https://github.com/ZygmaCore/rock_paper_scissors.git
cd rock_paper_scissors

(Optional) Create virtual environment:

python -m venv .venv
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

▶️ Usage

Run the game:

python main.py

Sample gameplay:

Please Press ENTER To Play the Game!

What do you choose? Type 0 for Rock, 1 for Paper or 2 for Scissors.

PLAYER CHOSE:
[ASCII ART]

COMPUTER CHOSE:
[ASCII ART]

YOU WIN

🤝 Contributing

Contributions are always welcome!

  1. Fork the project
  2. Create a branch (git checkout -b feature-name)
  3. Commit your changes
  4. Push to your branch
  5. Open a pull request

📄 License & Contact

This project is licensed under the MIT License. See the LICENSE file for full details.

Author Contact:
🌐 https://alhikam.me 🐙 https://github.com/ZygmaCore

About

A simple Python CLI Rock-Paper-Scissors game with ASCII art and clean outcome logic.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%